Metadata-Version: 2.4
Name: listofpublicationsfrominspirehep
Version: 0.1.3
Summary: Create and validate publication lists from INSPIREHEP and generate LaTeX/PDF output
Author: Ruggero Turra
License-Expression: MIT
Project-URL: Homepage, https://github.com/wiso/ListOfPublicationsFromInspireHEP
Project-URL: Repository, https://github.com/wiso/ListOfPublicationsFromInspireHEP
Project-URL: Issues, https://github.com/wiso/ListOfPublicationsFromInspireHEP/issues
Keywords: bibtex,inspirehep,latex,publications,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Text Processing :: Markup :: LaTeX
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: bibtexparser<2,>=1.4.4
Requires-Dist: requests
Requires-Dist: tqdm
Dynamic: license-file

# ListOfPublicationsFromInspireHEP

[![Python application](https://github.com/wiso/ListOfPublicationsFromInspireHEP/actions/workflows/python-app.yml/badge.svg)](https://github.com/wiso/ListOfPublicationsFromInspireHEP/actions/workflows/python-app.yml)

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.

## Run it

The simplest way to run the CLI commands once without installing them is `uvx`:

    uvx listofpublicationsfrominspirehep -h
    uvx listofpublicationsfrominspirehep check-biblio -h

## Install

The simplest persistent install for end users is `pipx`:

    pipx install listofpublicationsfrominspirehep

After installation, all commands are available:

    listofpublications --help
    listofpublications check-biblio --help
    listofpublications create-bibtex --help
    listofpublications create-latex --help

Legacy individual commands are also available (backward compatible):

    check_biblio --help
    create_bibtex --help
    create_latex --help

From a local checkout, you can still install it with `pip` in editable mode:

    python -m pip install -e .

## Requirements

To generate the final PDF you need a working LaTeX toolchain with `pdflatex` and `bibtex` available in `PATH`.

`check_biblio` also invokes LaTeX checks and may open your editor for manual fixes, so you should also have the `EDITOR` environment variable configured.

## How to use it

First create the BibTeX file downloading all your bib entries:

    listofpublications create-bibtex --help
    listofpublications create-bibtex --query "author%3AR.Turra.1%20and%20collection%3APublished"

This downloads the entries from [inspirehep.net](https://inspirehep.net/) and produces a BibTeX file as `bibtex_YYYY-MM-DD.bib`. 

*Note: If you get problems downloading from INSPIREHEP, you can manually download the BibTeX from inspire.hep going to your profile and using the "cite all" button. However, this is limited to 1000 entries. If needed, select different years and merge the files.*

Then fix LaTeX/Unicode errors:

    listofpublications check-biblio --fix-unicode <bibtexfilename.bib>

Finally generate the PDF:

    listofpublications create-latex <bibtexfilename_new.bib>
