R Observatory
Search
install.packages("piggyback")
CRAN 30-day downloads, method
2,663+53.9% up on the 30 days before, the better direction
Test coverage, method
36%of lines run by tests

Because larger (> 50 MB) data files cannot easily be committed to git, a different approach is required to manage data associated with an analysis in a GitHub repository.

Full description

Because larger (> 50 MB) data files cannot easily be committed to git, a different approach is required to manage data associated with an analysis in a GitHub repository. This package provides a simple work-around by allowing larger (up to 2 GB) data files to piggyback on a repository as assets attached to individual GitHub releases. These files are not handled by git in any way, but instead are uploaded, downloaded, or edited directly by calls through the GitHub API. These data files can be versioned manually by creating different releases. This approach works equally well with public or private repositories. Data can be uploaded and downloaded programmatically from scripts. No authentication is required to download data from public repositories.

Maintainer
Carl Boettiger
Licence
GPL-3
Latest release
10 Jul 2023
First release
30 Sep 2018

Compare with another package

More details
Releases
11
Needs compilation
No
Language
en-US
RoxygenNote
7.2.1
Subjects (1) Method, Subjects
Cite

Package

Run in R for the authors' preferred citation:

citation("piggyback")
APA
Boettiger, C., Hanson, J. O., Ho, T., Kuo, K., & Padgham, M. (2023). piggyback: Managing Larger Data on a GitHub Repository (Version 0.1.5) [Computer software]. https://doi.org/10.32614/CRAN.package.piggyback
About

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

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 piggyback version 0.1.5 [Data set]. HJJB, LLC. Data release v2026-10-28. https://doi.org/10.5281/zenodo.21843040
About

From data release v2026-10-28, which the citation names so these numbers can be found later.

All 13 check platforms pass.

  • r-devel-linux-x86_64-debian-clang

    The unreleased R on Linux, x86_64, debian-clang

    OK

    Version checked
    0.1.5
    Time taken
    45 s
  • r-devel-linux-x86_64-debian-gcc

    The unreleased R on Linux, x86_64, debian-gcc

    OK

    Version checked
    0.1.5
    Time taken
    36 s
  • r-devel-linux-x86_64-fedora-clang

    The unreleased R on Linux, x86_64, fedora-clang

    OK

    Version checked
    0.1.5
    Time taken
    43 s
  • r-devel-linux-x86_64-fedora-gcc

    The unreleased R on Linux, x86_64, fedora-gcc

    OK

    Version checked
    0.1.5
    Time taken
    35 s
  • r-devel-windows-x86_64

    The unreleased R on Windows, x86_64

    OK

    Version checked
    0.1.5
    Time taken
    69 s
  • r-oldrel-macos-arm64

    The previous release of R on macOS, arm64

    OK

    Version checked
    0.1.5
  • r-oldrel-macos-x86_64

    The previous release of R on macOS, x86_64

    OK

    Version checked
    0.1.5
    Time taken
    52 s
  • r-oldrel-windows-x86_64

    The previous release of R on Windows, x86_64

    OK

    Version checked
    0.1.5
    Time taken
    69 s
  • r-patched-linux-x86_64

    The patched release of R on Linux, x86_64

    OK

    Version checked
    0.1.5
    Time taken
    38 s
  • r-release-linux-x86_64

    The current release of R on Linux, x86_64

    OK

    Version checked
    0.1.5
    Time taken
    38 s
  • r-release-macos-arm64

    The current release of R on macOS, arm64

    OK

    Version checked
    0.1.5
    Time taken
    18 s
  • r-release-macos-x86_64

    The current release of R on macOS, x86_64

    OK

    Version checked
    0.1.5
    Time taken
    64 s
  • r-release-windows-x86_64

    The current release of R on Windows, x86_64

    OK

    Version checked
    0.1.5
    Time taken
    64 s
  • 13 OK

Over time

No change since 5 Aug 2026

As a list (5)
ChangedWorst statusOKNotesWarningsErrors
5 Aug 2026OK13000
1 Aug 2026Note12100
8 Jun 2026OK13000
7 Jun 2026Error12001
10 Mar 2026OK14000

Since March 2026

Check results on CRAN

Total downloads in the last 30 days
2,809It is the sum of 5 channels: CRAN, r2u, autoCRAN, conda-forge and c2d4u.

CRAN rank

2,236 of 26,530

CRAN

2,663 downloads in the last 30 days

Rank
2,236 of 26,530
Change
+53.9% up on the 30 days before, the better direction

It is in the total. Take it out

r2u

39 downloads in the last 30 days

Rank
3,536 of 30,526
Change
+25.8% up on the 30 days before, the better direction

It is in the total. Take it out

autoCRAN

5 downloads in the last 30 days

Rank
10,893 of 29,212
Change
−70.6% down on the 30 days before, the worse direction

It is in the total. Take it out

conda-forge

102 downloads in the last 30 days

Rank
3,316 of 3,828
Change
+127% up on the 30 days before, the better direction

It is in the total. Take it out

c2d4u, no longer updated

0 downloads in the last 30 days

Rank
6,270 of 7,575
Change
−100% down on the 30 days before, the worse direction

It is in the total. Take it out

Over time

Compare downloads

Needs
8
Dependent packages
10
Suggested by
8
Needs (8)
Installing it adds
27 packages, 8.7 MB of source
Of those, need compilation
16
Optional extras (9)
Dependent packages (10)
PackageTitleDownloads in 30 days
wruWho are You? Bayesian Prediction of Racial Category Using Surname, First Name, Middle Name, and Geolocation603
cnefetoolsAccess and Analysis of Brazilian CNEFE Address Data542
bricksetInterface with the Brickset API for Getting Data About LEGO Sets422
clinTrialDataClinical Trial Example Datasets363
metaboDataExample Metabolomics Data Sets325
sprttSequential Probability Ratio Tests Toolbox252
ready4Develop and Use Modular Health Economic Models236
odbrDownload Data from Brazil's Origin Destination Surveys234
gwidGenome-Wide Identity-by-Descent226
pkgmatchFind R Packages Matching Either Descriptions or Other R Packages207
Functions
17
Public exports
10
Lines of R code
847
Median complexity
4
Functions (17)
Size and composition

Lines by kind (1,999)

KindLinesShare
R code84742%
Tests51626%
Documentation40520%
Guides23112%

Lines by language

LanguageLinesShare
R1,36368%
Rd40520%
Vignettes23112%

Languages are counted from file extensions.

Files
46
R functions
17
Complexity
Median
4
Mean
4.82
Highest
11
Median lines per function
39
About complexity

Cyclomatic complexity counts the independent paths through a function: 1 is a straight line, higher is harder to test. R functions only.

Call graph figures
R functions
17
Calls
35
Unconnected
1
Groups
1
Growth (11 releases)
Total lines by release
1,983 on 30 Sep 20181,999 on 10 Jul 2023
Release changes

The tests ran and coverage was measured.

Lines run by tests
36.4%
Expressions run by tests
41%
Test cases
28
Exports named in tests
80%
Coverage by file (10)
Coverage run
Lines counted
371
Lines the tests ran
135
Tests passed
Yes
Measured with
covr 3.6.5 on R 4.6.1
Test suite
Has tests
Yes
Test frameworks
testthat
Test cases
28
Lines of tests
516
Test lines per line of code
0.61
Exports documented
100%
Arguments documented
94.4%
Return value documented
55.6%
Help pages with examples
90%
Examples run in checks
11.1%
Guides (2)
Other documentation
README
Yes, 538 words
Release notes file
Yes
Help pages
10
Lines of documentation
405

ropensci / piggyback on github.com

Stars
205+0.49% up on 30 days ago, the better direction
Forks
29
Open issues
4
Last commit
10 Nov 2025
Activity
Commits
356
Open pull requests
0
Tagged releases
16
Latest tagged release
v0.1.5, 26 Dec 2023
In development
Default branch at 0.1.5.9007, ahead of CRAN 0.1.5 (checked 2026-10-25)
Issues closed in
6 days (median)
Pull requests closed in
0 days (median)
Pull requests merged
93%
Created
11 May 2018
Licence file reads as
GPL-3.0
Development practices (11)
KindFound
Continuous integrationGitHub Actions, R CMD check workflow
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
Governance and communityCode of conduct
Docs sourceREADME.Rmd, pkgdown
GitHub Pages site last deployed 2019-07-17
CoverageCoverage reporting (Codecov)
CRAN release processcran-comments.md
Research and citationcodemeta.json, JOSS paper
Lint, format, editorRStudio project

Method, repository practices

Across ropensci

R releases
  • On CRAN
  • Release
VersionReleasedR
0.1.5 current11 Jul 20234.3.1
0.1.420 Jul 20224.2.1
0.1.319 May 20224.2.0
0.1.227 Apr 20224.2.0
0.1.19 Sep 20214.1.1
0.1.06 Aug 20214.1.0
0.0.1125 Feb 20203.6.2
0.0.107 Feb 20193.5.2
Earlier versions (3)
VersionReleasedR
0.0.99 Jan 20193.5.2
0.0.86 Oct 20183.5.0
0.0.730 Sep 20183.5.0
Release notes (0.1.5)
  • Fix bug in pb_upload() to correctly resolve "latest" tag - if there is no release

tag actually named "latest" it will use the first release from pb_releases(). [#75]

  • Make pb_download() and pb_info() also resolve "latest" similarly: if there

is no release tag named "latest", use first release from pb_releases()

  • Updated test coverage to use GHA
  • Fixed error handling for pb_list() for no release.
  • pb_list() now respects the option "piggyback.verbose"
  • Fix download token handling [#88]
  • pb_upload() no longer prints out extra newlines [#93]
  • pb_new_release() now warns and exits early instead of failing if a release

already exists. [#95]

  • Fixup test issues [#100]
  • pb_upload adds a two-second sleep after user creates release [#101]
  • This is because it takes a few seconds for the GitHub API to register that

the new release has been created

  • Adds piggyback.cache R option to avoid memoising altogether
  • Adds .pb_cache_clear() function to empty the cache more consistently

(internally and externally)