Access to the 'DraCor' API
Overview
Provide an interface for 'Drama Corpora Project' ('DraCor') API: https://dracor.org/documentation/api.
- all functions that request 'DraCor' API now fail gracefully: if the API is
not available (no internet connection, the server is down or does not respond,
error status, data that cannot be parsed), they show an informative message
and return NULL instead of throwing an error
- added time limits for requests to 'DraCor' API: options
rdracor.connect_timeout (30 s) and rdracor.timeout (600 s), see
?dracor_api
- added
dracor_api_available()to check whether 'DraCor' API is available - fixed
dracor_api_info()failing if 'DraCor' API is not available get_dracor()requests the list of corpora once instead of twice- examples are run only if 'DraCor' API is available
- tests that need 'DraCor' API are not run on CRAN; added tests for the
Show all changes in 1.1.0Hide the rest of the changes in 1.1.0
behaviour of the functions without 'DraCor' API
- fixed
tei_to_df()andget_text_df()losing the speaker (who) of verse
lines wrapped in <lg>; lines with several speakers keep all their ids;
tei_to_df() no longer modifies the document passed to it
- fixed
plot()forcooccur_igraphandrelations_igraphobjects ignoring
igraph arguments passed by the user (e.g. vertex.color, vertex.size);
gender_colors can be given in any order; edge_size_scale = NULL works
- fixed
plot()forrelations_igraphobjects not drawing vertices: colours
were taken from the character attribute gender, which 'DraCor' API v1.1.0
renamed to sex (dracor-org/dracor-api#319)
get_play_metadata(full_metadata = TRUE)uses only the metadata columns
returned by the API and no longer returns normalizedGenre twice
set_dracor_api_url()validates its argument and removes a trailing slashdracor_sparql()uses the host of the current 'DraCor' API URL- argument validation errors (e.g. a missing play name) are no longer reported
as connection problems
- TLS certificates are verified for all requests
- fixed
citation("rdracor"): full list of authors of the 'DraCor' paper and
DOI; added a citation for the package
- fixed typos in documentation; documented the format of
gender_colors - fixed
plot()forcooccur_igraphobjects failing or warning when a metric
is 0 for every character (e.g. betweenness in a two-character play) or the play
has no co-occurrences; unknown relation types are drawn in grey
- several authors of a play are separated with "; " in the attributes of
network objects
get_dracor()downloads each corpus once even if its name is repeated and
no longer returns the duplicated column yearNormalizedMeta
- the
updatedcolumn ofget_dracor_meta()takes the UTC offset of 'DraCor'
API timestamps into account
- invalid
playorcorpusarguments give a clear error message - requests to 'DraCor' API identify the package with a User-Agent header
From NEWS.md in the release
Install
Health
- OK13 OK2026-10-02
- ERROR12 OK, 1 ERROR2026-10-01
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-07-21
Show 6 earlier changesHide 6 earlier changes
- ERROR12 OK, 1 ERROR2026-07-20
- OK13 OK2026-06-09
- NOTE12 OK, 1 NOTE2026-06-08
- OK13 OK2026-05-02
- ERROR11 OK, 1 ERROR2026-04-25
- OK14 OK2026-03-10
Documentation
- Help pages
- 20
- Examples that run
- 65%13 run in a plain check (12 of them under a condition) · 7 only when donttest examples are enabled (R CMD check --as-cran)
- Exported functions with examples
- 100%
- Documented parameters
- 94%
- Return-value docs
- 95%
- Help pages citing references
- 25% with a bibliography file
Downloads
Repository
- PRs merged (all time)
- 100%
- Median days to close, 50 most recently updated closed issues
- 23
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Forks over time
Issues over time
PRs over time
4 development-tooling and community-health practices detected across 3 families in the upstream repository
Checks run against github.com/dracor-org/rdracor on 2026-10-22.
Dependencies
Installing rdracor adds 32 packages (22 with compiled code, 33 MB of source tarballs). Heaviest: stringi 11 MB, data.table 5.7 MB, igraph 4.8 MB.
Code & Tests
People & History
Pick two releases to compare their code metrics.
- 1.1.0Latest2026-10-22 · current release · diff ↗ ··
added 1 export
dracor_api_availablelisted once in CRAN's queue
Seen in one reading of CRAN's incoming queue, at 2026-10-21 22:56 UTC, so it stayed less than the time between readings. - RR 4.6.0 released · 2026-04-24
- 1.0.62025-09-29 · diff ↗
- unarchivedReturned to CRAN2025-08-27
- 1.0.52025-08-27 · diff ↗
- archivedRemoved from CRAN2025-07-31issues were not corrected in time
- RR 4.5.0 released · 2025-04-11
- 1.0.42024-09-26 · diff ↗
- RR 4.4.0 released · 2024-04-24
- unarchivedReturned to CRAN2024-04-04
- 1.0.3
- archivedRemoved from CRAN2024-02-08repeated policy violation On Internet access
- unarchivedReturned to CRAN2023-10-22
- 0.7.6
- archivedRemoved from CRAN2023-05-14policy violation On Internet access
- RR 4.3.0 released · 2023-04-21
Show 2 earlier eventsHide 2 earlier events
- 0.7.22023-01-23
- RR 4.2.0 released · 2022-04-22
Package metadata
- First published
- 2023-01-23
- Total releases
- 7 / 3 yrs
- License
- GPL (>= 3) OSI
- Download size
- 259 KB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("rdracor")The package provides a citation file that builds its entry when R runs it. Run citation() to see it.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-23, which the citation names so these numbers can be found later. More on citing and the projects behind them.