Skip to main content
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 details)

Uploaded Source

File details

Details for the file arxiv-cli-0.1.6.tar.gz.

File metadata

  • Download URL: arxiv-cli-0.1.6.tar.gz
  • Upload date:
  • Size: 4.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/2.7.14

File hashes

Hashes for arxiv-cli-0.1.6.tar.gz
Algorithm Hash digest
SHA256 2e97e602f3ae2d0ecbd441a400ea7343f4da7154abd97bd646e3c5a26aa6c9cd
MD5 ccdea506d9cd64006869f6dd0c4cc4f9
BLAKE2b-256 818b113573595b18456f38ccec07bc44da68f06c51cb2ff34438b39a773192a6

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.6 This release

1 file

0.1.5

1 file

0.1.4

1 file

0.1.3

1 file

0.1.0

1 file

0.0.3

1 file

0.0.2

1 file

0.0.1

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page