Skip to content

rdracor

1.1.0Package record

Access to the 'DraCor' API

0packages depend
3.2Kdownloads / year
86.8%test coverage
13/13flavors OK

Overview

About

Provide an interface for 'Drama Corpora Project' ('DraCor') API: https://dracor.org/documentation/api.

Changes in 1.1.0
  • 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() and get_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() for cooccur_igraph and relations_igraph objects 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() for relations_igraph objects 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 slash
  • dracor_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() for cooccur_igraph objects 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 updated column of get_dracor_meta() takes the UTC offset of 'DraCor'

API timestamps into account

  • invalid play or corpus arguments 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

CRAN checks
13OK
Slowest check: 2.1 min · r-devel-windows-x86_64
Status changes
  • 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
Advisories

none known

Documentation

In release 1.1.0
READMEYes · 418 wordsVignettesNoNEWSYes · 100% structured · mentions 1.1.0Citation fileYes · cites a publicationWebsitenot declared in DESCRIPTION
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

3.2K
CRAN downloads in the past year
Rank #17,826 · ~9/day · ~263/mo
Daily download trend is not available in this view yet.
28030 days
72290 days
3.2K1 year
Compare downloads with other packages →
Also on77 r2u5 autocran

Repository

35Stars
2Forks
0Open issues
0Open PRs
0Releases
220Commits
4Commit identities
License file reads as GPL-3.0 · 220 commits · Last activity 2026-10-21 · +2.9% stars, 30d
Responsiveness
How these are sampled
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

2025-07-02 · 332026-07-07 · 34
PracticesBeta

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.

Docs source (1)
README.Rmd
CRAN release process (2)
cran-comments.mdCRAN-SUBMISSION
Lint, format, editor (1)
RStudio project
How this is detected·Detection ruleset v4 (2026-10-20)

Dependencies

Declared dependencies
11 external dependencies (excludes base and recommended)

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.

Depends (0)
none
LinkingTo (0)
none
Suggests (1)
Enhances (0)
none
Reverse dependencies
0direct
0indirect

Nothing depends on this yet.

People & History

People (1)
Author, Maintainer since 0.7.2 (2023)
Releases (7)

Pick two releases to compare their code metrics.

  • 1.1.0Latest
    record
    2026-10-22 · current release · diff ↗ ·
    added 1 export
    dracor_api_available
    ·
    listed 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.
  • R
    R 4.6.0 released · 2026-04-24
  • 1.0.6
    record
    2025-09-29 · diff ↗
  • unarchivedReturned to CRAN
    2025-08-27
  • 1.0.5
    record
    2025-08-27 · diff ↗
  • archivedRemoved from CRAN
    2025-07-31
    issues were not corrected in time
  • R
    R 4.5.0 released · 2025-04-11
  • 1.0.4
    record
    2024-09-26 · diff ↗
  • R
    R 4.4.0 released · 2024-04-24
  • unarchivedReturned to CRAN
    2024-04-04
  • 1.0.3
    record
    2024-04-04 · diff ↗ ·
    removed 1 export
    get_play_cast
    added 1 export
    get_play_characters
  • archivedRemoved from CRAN
    2024-02-08
    repeated policy violation On Internet access
  • unarchivedReturned to CRAN
    2023-10-22
  • 0.7.6
    record
    2023-10-22 · diff ↗ ·
    added 2 exports
    get_dracor_api_url, set_dracor_api_url
  • archivedRemoved from CRAN
    2023-05-14
    policy violation On Internet access
  • R
    R 4.3.0 released · 2023-04-21
Show 2 earlier eventsHide 2 earlier events
  • 0.7.2
    record
    2023-01-23
  • R
    R 4.2.0 released · 2022-04-22
Across CRAN, the median accepted release of the past year spent 23 hours in the queue, 90% under 11 days.How queue time is measured

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.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for rdracor version 1.1.0 [Data set]. HJJB, LLC. Data release v2026-10-23. https://doi.org/10.5281/zenodo.21843040

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.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy