Skip to main content

CLI organize PDFs by attaching bibtex metadata

Project description

Maper

Maper (may-per, like paper with an 'm', as in meta-paper) is a minimal, easy to use, command line tool to download/manage scientific papers in pdf-format by attaching a bibtex-file and updating its metadata using pikepdf.

Install

Install from PyPI:

$ pip install maper

Additionally, pandoc needs to be installed and available.

Run

Use either python -m maper <command> or if PATH is set correctly, maper <command>.

Currently available commands are:

  • create
  • show
  • bibtex

create

Create a PDF file with an attached bibtex file and metadata title and authors set:

$ maper create <bibtex> <pdf> [-o <output>]

where <bibtex> and <pdf> may be either local files or URLs, and output is a filename, or a directory. If <output> is not a directory, the resulting pdf will be stored in that file. If <output> is an existing directory, the file will be stored in <output>/<FirstAuthorFamilyName><Year><FirstTitleWord>.pdf. If <output> is omitted, the current directory is assumed.

show

Show a summary of the attached bibtex of one or multiple pdfs:

maper show [<pdf> ...]

bibttex

Show the bibtex of one or combined of multiple pdfs (e.g. to create a full bibtex file)

$ maper bibtex [<pdf> ...]

Example

The following creates the pdf Weizenbaum1966ELIZA.pdf, shows a summary, and the full attached bibtex filed:

$ maper create 'https://dblp.uni-trier.de/rec/journals/cacm/Weizenbaum66.bib?param=1' 'https://cse.buffalo.edu/~rapaport/572/S02/weizenbaum.eliza.1966.pdf'
$ maper show Weizenbaum1966ELIZA.pdf
$ maper bibtex Weizenbaum1966ELIZA.pdf

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

maper-0.1.0.tar.gz (4.3 kB view hashes)

Uploaded source

Built Distribution

maper-0.1.0-py3-none-any.whl (5.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page