listofpublicationsfrominspirehep 0.1.0

Create and validate publication lists from INSPIREHEP and generate LaTeX/PDF output

ListOfPublicationsFromInspireHEP

Create a list of publications from InspireHEP and produce a LaTeX document and a PDF. This tool can be useful when the list is very long and there are some LaTeX errors in the BibTeX entries.

Install

From a local checkout (classic workflow):

python -m pip install -r requirements.txt

CLI tools via pipx/uvx directly from GitHub, without publishing to PyPI:

pipx install "git+https://github.com/wiso/ListOfPublicationsFromInspireHEP.git"

or run one-shot without a persistent install:

uvx --from "git+https://github.com/wiso/ListOfPublicationsFromInspireHEP.git" check_biblio -h

uvx --from "git+https://github.com/wiso/ListOfPublicationsFromInspireHEP.git" create_bibtex -h

uvx --from "git+https://github.com/wiso/ListOfPublicationsFromInspireHEP.git" create_latex -h

Installed/exposed commands are:

check_biblio
create_bibtex
create_latex

Publish to PyPI

The repository now includes a GitHub Actions workflow that publishes a release to PyPI when you push a tag that starts with v.

Typical flow:

1. Bump the version in pyproject.toml and commit it.
2. Create and push a tag such as v0.1.1.
3. GitHub Actions runs tests, builds the wheel/sdist, and publishes to PyPI.

Before the first release, enable trusted publishing for this repository in your PyPI project settings, or replace it with an API token-based setup if you prefer that model.

How to use it

First create the BibTex file downloading all your bib entries, for the options try:

create_bibtex -h

it downloads the entries from http://inspirehep.net/ and produces a BibTeX file as bibtex_2016-02-07.bib. If you get problems you can download the BibTex from inspire.hep, going on your profile and using the "cite all" button. Actually, this is faster, but you can download only 1000 entries. In this case, you can select a few years on the left and then merge the files.

Usually, many LaTeX errors are present, you can fix them with:

check_biblio --fix-unicode <bibtexfilename.bib>

Finally to create the pdf:

create_latex <bibtexfilename_new.bib>