R Observatory: Metrics for secfile version 0.1.1

Balamuta, James Joseph

doi:10.5281/zenodo.21843040

secfile

0.1.1

SEC 'EDGAR' APIs

0packages depend

39downloads / year

0.0%test coverage

8/8checks pass

Overview

About

Maintained by Jason FosterFirst published 2026-08-081 releasesCRAN page ↗GitHub ↗

Simple and efficient access to the SEC's 'EDGAR' APIs https://www.sec.gov/search-filings for querying and retrieving filings. The 'secfile' package abstracts the complexities of interacting with SEC EDGAR APIs, such as session management, user agent declaration, rate limiting, index parsing, pagination of filing metadata, URL construction, document caching, and inline XBRL parsing. This abstraction allows users to focus on retrieving data rather than managing API details. Use cases include retrieving filings across a range of workflows such as indexes, tenures, submissions, and facts. The package supports flexible query capabilities, including customizable form types, date ranges, and dimensions, and automatic data validation. It handles the SEC's fair access requirements automatically, such as user agent declaration and rate limiting between requests, and caches downloaded documents for efficient retrieval of large datasets. The implementation uses standard HTTP libraries to handle API interactions efficiently and is available in both R and 'Python' for accessibility to a broad audience.

Install

R (CRAN)pak (dev)Fedora (COPR)openSUSE (OBS)

install.packages("secfile", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("jasonjfoster/file")

Development version from jasonjfoster/file. Installs pak first if it is not already available.

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-secfile

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-secfile

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

8OK

Slowest check: 52 s · r-oldrel-windows-x86_64

Code health

Yes

Tests · ratio 0.27

0.0%

Coverage · measured lines

100%

Documentation · exports

3

Dependencies · direct

Check history

OK2026-08-09
6 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 371 wordsVignettesNopkgdown siteNoNEWSYes · 33% structuredCode of conductNoContributing guideNo

Examples that run: 17%
Documented parameters: 100%
Return-value docs: 100%
References docs: 0%

Downloads

39

CRAN downloads in the past year

Rank #24,870 · ~0/day · ~3/mo

secfile Releases R versions

Daily download trend is not available in this view yet.

3930 days

3990 days

391 year

Compare downloads with other packages →

Repository

GitHub ↗ jasonjfoster/file

1Stars

0Forks

0Open issues

0Open PRs

0Releases

datapythonr

Last activity 2026-08-08

Repository practices

Upstream repositoryBeta

Repository github.com/jasonjfoster/file is linked, but repository-practices checks have not run for it yet.

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

5 external dependencies (excludes base and recommended)

Depends (1)

R >= 3.5.0

Imports (3)

curl jsonlite xml2

LinkingTo (0)

none

Suggests (2)

covr testthat

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

Code & Tests

Datasets

People & History

People (1)

Maintainer (1)

Jason Foster

Author, Maintainer

Authors (1)

Jason Foster

Author, Maintainer

Package Timeline

1 release. R releases are shown for context.

0.1.1Latest
2026-08-08 · current release
R
R 4.6.0 released · 2026-04-24

Package metadata

First published: 2026-08-08
Total releases: 1 / 1 yrs
License: GPL (>= 2) OSI
Minimum R: ≥ 3.5.0
Bundled data: 11 KB / 2 files
Download size: not tracked yet
Installed size: not tracked yet
With dependencies: not tracked yet

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("secfile")

Format

Foster, J. (2026). secfile: SEC 'EDGAR' APIs (Version 0.1.1) [Computer software]. https://doi.org/10.32614/CRAN.package.secfile

This is what citation() produces when a package has no citation file of its own. If it prints something else, use that.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

Format

APA

Balamuta, J. J. (2026). R Observatory: Metrics for secfile version 0.1.1 [Data set]. HJJB, LLC. Data release v2026-08-11. https://doi.org/10.5281/zenodo.21843040

From data release v2026-08-11, 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 →