Skip to main content

A utility for archiving osf storage projects at archive.org

Project description

# osf-pigeon

A utility for archiving OSF data to archive.org

Purpose

This utility takes a publicly available OSF registration guid as a parameter and using that info alone it will transfer that registration, file data, metadata et all to Internet Archive.

Install

Simply install the package using python’s package manager pip with bash:

pip3 install osf_pigeon

To use for local development just remember to install the developer requirements using:

pip3 install -r dev.txt

Use

Simply import the module and enter a guid with credentials:

from osf_pigeon import pigeon

pigeon(
   'guid0',
   datacite_username='test_datacite_username',
   datacite_password='test_datacite_password',
   datacite_prefix='test_datacite_prefix',
   ia_access_key='test_datacite_password',
   ia_secret_key='test_datacite_password',
)

That’s it!

Assuming the registration is fully public and the DOI has been minted properly at datacite.

## Running for development

#### Tests

Running tests are easy enough just:

pip3 install -r dev.txt
python3 -m pytest .

#### Linting

Optional, but recommended: To set up pre-commit hooks (will run formatters and linters on staged files):

pip install pre-commit
pre-commit install --allow-missing-config

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

osf_pigeon-0.0.2.tar.gz (2.9 kB view hashes)

Uploaded Source

Built Distribution

osf_pigeon-0.0.2-py3-none-any.whl (4.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page