arXiv-CLI
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