Skip to main content

A Python wrapper for the arXiv API.

Project description

https://travis-ci.org/jacquerie/arxiv-cli.svg?branch=master https://coveralls.io/repos/github/jacquerie/arxiv-cli/badge.svg?branch=master

About

A Python wrapper for the arXiv API.

Install

$ pip install arxiv-cli

Usage

You can use arXiv-CLI as a CLI to navigate arXiv or as a library to query its API.

CLI

Currently arXiv-CLI implements three subcommands:

$ arxiv download [-t/--timeout seconds] IDS
$ arxiv fetch [-t/--timeout seconds] IDS
$ arxiv find [-i/--ids, -t/--timeout seconds] QUERY

The first two commands accept a list of arXiv ids and, respectively, download the corresponding PDFs or display their metadata in JSON format.

The third command runs a query against arXiv and prints the metadata in JSON format of the records that match. Adding the -i/--ids flag will return only their ids.

Adding the -t/--timeout seconds option will sleep for that amount of seconds between successive requests to the arXiv API.

Note that the previous commands can be chained, therefore running

$ arxiv download $(arxiv find --ids QUERY)

will download all papers that match QUERY, while

$ arxiv fetch $(arxiv find --ids QUERY)

will fetch all their metadata.

API

The previous CLI is built on top of a Python library that can be used on its own to query arXiv’s API. For example:

>>> from arxiv_cli import Client
>>> client = Client()
>>> client.download([IDS])

will achieve the same effect as

$ arxiv download IDS

Author

Jacopo Notarstefano (@Jaconotar)

License

MIT

Download files

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

Source Distribution

arxiv-cli-0.1.6.tar.gz (4.5 kB view hashes)

Uploaded Source

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