Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Simple bibliography manager

Project description

# pdfs
Simple Bibliography Database

## Introduction

This tool manages article PDFs. This tool is based on two working principles.
First, DOIs are central. Only documents with a DOI can be stored in the
database. All metadata is acquired through the [Crossref](https://crossref.org)
[API](https://github.com/CrossRef/rest-api-doc) through DOIs scraped from the
PDF or entered by the user. Second, document repositories are local to a
directory hierarchy. For example, if I have a project based in ~/projects/foo,
I can create a document repository by

cd ~/projects/foo
pdfs init

This creates a new direcory in ~/projects/foo called articles. All PDFs
imported into the database will be copied here. Running `pdfs` in
~/projects/foo, or any directory below it will use the repository at
~/projects/foo/articles.

## Commands

usage: pdfs command ...

| Command | Description |
|---------|--------------------------------------------|
| add | Import new PDF into repository |
| aux2bib | Read LaTeX .aux file and dump a .bib file |
| bibtex | Dump bibtex for keys |
| edit | Edit bibtex, metadata and file attachments |
| import | Import entries from other database |
| info | Print information about current repository |
| init | Initialize new document repository |
| list | List all items in database |
| search | Search full text of PDF |
| view | View article PDF and attachements |
| watch | Watch a directory for new pdf files to add |
| www | Spin up http server |


## Command line completion

Command line autocomplete support via
[argcomplete](https://argcomplete.readthedocs.io).

To start quickly with zsh:

autoload bashcompinit
bashcompinit
eval "$(register-python-argcomplete pdfs)"

Project details


Release history Release notifications

Download files

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

Files for pdfs, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size pdfs-0.1.0-py3.6.egg (622.2 kB) File type Egg Python version 3.6 Upload date Hashes View hashes
Filename, size pdfs-0.1.0-py3-none-any.whl (550.0 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size pdfs-0.1.0.tar.gz (535.4 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page