Metadata-Version: 2.4
Name: inspiretools
Version: 0.4
Summary: Python package to auto-generate bibliographies pulling the bibtex data from Inspire
Author: David M. Straub
License-Expression: MIT
Project-URL: Homepage, https://github.com/DavidMStraub/inspire-tools
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Dynamic: license-file

# INSPIRE tools

This Python 3 package provides two scripts, `auxtobib` and `blgtobib`, which take a LaTeX `.aux` or `.blg` file as input.
`auxtobib` fetches the `bibtex` entries for all the articles cited in the document from
[INSPIRE](http://inspirehep.net/). `blgtobib` does the same, but only fetches those entries which are missing.

## Installation


To install the package in your home directory, run
```
python3 -m pip install inspiretools --user
```

## Requirements

The script requires Python 3.5+.

## Usage

Given a LaTeX `.aux` file, simply execute
```
auxtobib paper.aux
```
and the `bibtex` entries will be printed to `stdout`. If you want to save them
into a `.bib` file, simply use
```
auxtobib paper.aux > bibliography.bib
```

The script `blgtobib` will fetch only `bibtex` entries which are not already in
the `.bib` file associated with your project. It uses the `bibtex` log file
associated with the LaTeX project. For example,
```
blgtobib paper.blg >> bibliography.bib
```
will append new entries to `bibliography.bib`.

By default, both commands use the current TeX key returned by INSPIRE. Pass
`--keep-old-texkeys` to preserve the original key from the `.aux` or `.blg` file.
