arxiv-client-cli: Command line tool to search and download papers from arXiv.org

[ bsd3, cli, network, program ] [ Propose Tags ] [ Report a vulnerability ]

This is a command line interface (cli) application wrapping the library arxiv-client, which is a Haskell tool to search and download papers from arXiv.org using a simple query DSL.

[Skip to Readme]

Downloads

arxiv-client-cli-0.1.0.0.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

eiko

For package maintainers and hackage trustees

edit package information

Candidates

No Candidates

Versions [RSS]	0.1.0.0
Change log	CHANGELOG.md
Dependencies	aeson (>=2 && <2.3), arxiv-client (>=0.1 && <0.2), base (>=4 && <5), bytestring (>=0.10 && <0.13), directory (>=1.3 && <1.4), filepath (>=1.5.2 && <1.5.5), megaparsec (>=9.5 && <9.8), optparse-generic (>=1.5 && <1.6), process (>=1.6 && <1.7), text (>=2.0 && <2.2), time (>=1.11 && <1.15) [details]
Tested with	ghc ==9.12.2
License	BSD-3-Clause
Author	Eiko
Maintainer	eikochanowo@outlook.com
Category	Network, CLI
Source repo	head: git clone https://github.com/Eiko-Tokura/arxiv-client-cli.git
Uploaded	by eiko at 2025-10-28T09:17:08Z
Distributions
Executables	arxiv-client-cli
Downloads	2 total (2 in the last 30 days)
Rating	(no votes yet) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs not available [build log] All reported builds failed as of 2025-10-28 [all 2 reports]

Readme for arxiv-client-cli-0.1.0.0

[back to package description]

Arxiv Cli

arxiv-client-cli is a command-line interface (CLI) tool for searching and downloading research papers from arXiv.org, it warps the library arxiv-client.

Help Text

Arxiv Client CLI

Usage: arxiv-client-cli [-q|--query TEXT] [-H|--helpQuery] [-p|--downloadPdf] 
                        [-s|--downloadSrc] [-u|--ungzip] [-c|--concise] 
                        [-v|--detail] [-a|--abstract] [-j|--json] 
                        [-d|--downloadDir STRING] [--after yyyy-mm-dd] 
                        [--before yyyy-mm-dd] [-m|--maxResult INT] 
                        [-n|--page INT]

Available options:
  -h,--help                Show this help text
  -q,--query TEXT          Search query string
  -H,--helpQuery           Display help for constructing query strings
  -p,--downloadPdf         Download PDF files for each entry
  -s,--downloadSrc         Download source .tar.gz files for each entry
  -u,--ungzip              Automatically ungzip source files (by running "tar
                           -xzf")
  -c,--concise             Concise output (only titles)
  -v,--detail              Detailed output
  -a,--abstract            Include abstracts in the output
  -j,--json                Output results in JSON format, turn off
                           human-readable output
  -d,--downloadDir STRING  Directory path to save downloaded files
                           (default: "./")
  --after yyyy-mm-dd       Only include papers published after this date
                           (YYYY-MM-DD)
  --before yyyy-mm-dd      Only include papers published before this date
                           (YYYY-MM-DD)
  -m,--maxResult INT       Maximum results per page (default: 25)
  -n,--page INT            Page number to retrieve (starting from 0)

Constructing Query String

--query parameter is mandatory.
Query string is constructed by using

* <field> <match> <value>
  <field> := title | author | abstract | category | anywhere
  (<match>, <value>) :=
    is <string>          -- exact match
    has <string>         -- substring match
    any [<string>, ...]  -- any of the strings (ors)
    all [<string>, ...]  -- all of the strings (ands)

* You can write a single string "value" without specifying field and match,
  which is equivalent to: anywhere has "value"

* Logical operators:
  &&      -- and (note that these operators are right associative, use brackets for clarity)
  ||      -- or  (note that these operators are right associative, use brackets for clarity)
  ands [<queryTerm>, ...]  -- and multiple terms
  ors  [<queryTerm>, ...]  -- or  multiple terms
  not <queryTerm>          -- negate term

Examples:
  --query 'title has "quantum" && author is "Albert Einstein"'
  --query 'author any ["john doe", "jane smith"]'
  --query 'ands [title is "coleman", author has "doe"]'
  --query 'ors [category is "math.NT", category is "math.AG"]'

Installation

cabal install arxiv-client-cli