bibtexautocomplete 1.0.2

Module to complete bibtex files by polling online databases

Bibtex Autocomplete

This repository contains a python package to autocomplete bibtex bibliographies. It is inspired and expanding on the solution provided by thando in this tex stackexchange post.

It attempts to complete a bibtex file by querying the following domains:

• www.crossref.org
• dlbp.org
• researchr.org
• unpaywall.org

Disclaimers

The searches are performed using the entries' dois if present, title or author otherwise. Titles are compared excluding punctuation and case, so make sure to include the full title to get matches.

There is no guarantee that this script will find matches for your entries, or that the websites will have any data to add to your entries.

The script will not overwrite any user given non-empty fields, unless the -f/--force-overwrite flag is given. It is designed to minimize the chance of false positive - that is adding data from another similar-ish entry to your entry. If you find any such false positive please report them using the issue tracker.

Installation

Can be installed with pip :

pip install bibtexautocomplete

You should now be able to run the script using either commands:

btac --version
python3 -m bibtexautocomplete --version

Dependencies

This package has two dependencies (automatically installed by pip) :

• bibtexparser
• alive_progress for the fancy progressbar

Usage

The command line tool can be used as follows:

btac [-flag] <input_files>

Examples :

• btac my/db.bib : reads from ./my/db.bib, writes to ./my/db.btac.bib
• btac -i db.bib : reads from db.bib and overwrites it (inplace flag)
• btac db1.bib db2.bib -o out1.bib -o out2.bib reads multiple files and write their outputs to out1.bib and out2.bib respectively

Optional arguments:

• -o --output <file>

  Write output to given file. Can be used multiple times when also giving multiple inputs. Maps inputs to outputs in order in that case If there are extra inputs, use default name (old_name.btac.bib). Ignored in inplace (-i) mode.

• -q --only-query <site> or -Q --dont-query <site>

  Restrict which websites to query from. <site> must be one of: crossref, dblp, researchr, unpaywall. These arguments can be used multiple times, for example to only query crossref and dblp use -q crossref -q dblp or -Q researchr -Q unpaywall

• -e --only-entry <id> or -E --exclude-entry <id>

  Restrict which entries should be autocomplete. <id> is the entry id used in your bibtex file (e.g. @inproceedings{<id> ... }). These arguments can also be used multiple times to select only/exclude multiple entries

• -c --only-complete <field> or -C --dont-complete <field>

  Restrict which fields you wish to autocomplete. Field is a bibtex field (e.g. author, doi,...). So if you only wish to add missing doi's used -c doi.

Output formatting:

• --fa --align-values pad fieldnames to align all values

  @article{Example,
    author = {Someone},
    doi    = {10.xxxx/yyyyy},
  }
  

• --fc --comma-first use comma first syntax

  @article{Example
    , author = {Someone}
    , doi = {10.xxxx/yyyyy}
    ,
  }
  

• --fl --no-trailing-comma don't add the last trailing comma

• --fi --indent <space> space used for indentation, default is a tab

Flags:

• -i --inplace Modify input files inplace, ignores any specified output files

• -f --force-overwrite Overwrite already present fields. The default is to overwrite a field if it is empty or absent

• -t --timeout <float> set timeout on request in seconds, default: 10.0 s, increase this if you are getting a lot of timeouts.

• -v --verbose verbose mode shows more info. It details entries as they are being processed and shows a summary of new fields and their source at the end. Using it more then once prints debug info (up to three times).

• -s --silent hide info and progressbar. Keep showing warnings and errors. Use twice to also hide warnings, thrice to also hide errors and four times to also hide critical error, effectively killing all output.

• -n --no-color don't color use ansi codes to color and stylise output

• --version show version number

• -h --help show help