bibliography-io provides standalone loading and writing of bibliographic
records. Using the base bibliography-io installation does not require CoLRev or
GROBID.
Installation
Install the base package with:
pip install bibliography-io
Install optional features as needed:
pip install "bibliography-io[markdown]" # Markdown parsing through CoLRev/GROBID
pip install "bibliography-io[excel]" # Excel file support
pip install "bibliography-io[all]" # Both optional features
Markdown reference-list parsing also requires a running GROBID service. Formats available in the base bibliography-io installation do not require either extra.
Usage
from bibliography_io import load_raw, write
records = load_raw("references.bib")
write(records, path="references.ris")
File APIs infer the format from recognized suffixes; an explicit format can
override inference. String APIs always require format:
from bibliography_io import to_string
from bibliography_io import loads_raw
records = loads_raw("@article{example, title={An example}}", format="bib")
text = to_string(records, format="bib")
File formats are inferred from their suffixes; pass format to load() when a
suffix is ambiguous or does not match the file's actual format.
Format support
| Format | Read files | Write files | String APIs |
|---|---|---|---|
BibTeX (.bib) |
Yes | Yes | loads_raw() / to_string() |
RIS (.ris) |
Yes | Yes | loads_raw() / to_string() |
ENL / EndNote (.enl) |
Yes | Planned | loads_raw() (to_string() planned) |
NBIB (.nbib) |
Yes | Planned | loads_raw() (to_string() planned) |
JSON (.json) |
Yes | Planned | loads_raw() (to_string() planned) |
CSV (.csv) |
Yes | Yes | loads_raw() / to_string() |
Excel (.xls, .xlsx) |
Yes | Yes | File APIs only |
Markdown (.md) |
Planned | Planned | Planned |
Markdown table writing is built into bibliography-io.
Markdown reference-list parsing is planned as a separate optional feature; its
backend and installation extra are not finalized. Requesting Markdown
reference-list input without a registered backend raises
OptionalBackendUnavailableError.
See the documentation for installation details, usage examples, and the generated API reference.
Development
See the development documentation for test, lint, and documentation build instructions.
Related Python Libraries
The following libraries support additional bibliographic formats, conversion workflows, and reference extraction:
- BibtexParser — A lightweight, actively maintained library for reading, writing, and modifying
.bibfiles. Supports customizable parsing, field transformations, and BibTeX writing. Best suited for general-purpose BibTeX processing. - Pybtex — A bibliography processing library that supports BibTeX parsing, citation formatting, and conversion between bibliography formats. Provides extensible formatting styles and output formats such as LaTeX, HTML, and plain text. Best suited for generating formatted references.
- biblib — A library for managing bibliographic databases, including merging entries, accessing metadata, and retrieving references using DOI or ISBN identifiers. Useful for building custom bibliography management workflows, although its last PyPI release was in 2018.
- rispy — A lightweight Python library for reading and writing RIS files. Supports configurable tag mappings and custom parsers/writers. Best suited for standalone RIS processing.
- pybtexris — A Pybtex plugin for reading RIS files and converting them into formats such as BibTeX. Also supports bibliography formatting through Pybtex.
- pybtexnbib — A Pybtex plugin for parsing PubMed/MEDLINE (
.nbib) files. Useful for integrating PubMed references into BibTeX and other bibliography workflows. - endnote-utils — A utility for converting EndNote XML and RIS records to CSV, JSON, and Excel formats. Also provides command-line tools for bibliographic data processing.
- Biopython (Bio.Medline) — Provides parsers for MEDLINE-formatted records, including PubMed exports. Best suited for biomedical literature processing.
- pubmed-parser — A Python library for extracting structured metadata from PubMed and PubMed Central XML datasets. Particularly useful for large-scale biomedical literature analysis.
License
This project is distributed under the MIT License.
Metadata
Release files for bibliography-io 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| bibliography_io-0.2.0.tar.gz | 581.3 kB | With provenance | Details for bibliography_io-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| bibliography_io-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for bibliography_io-0.2.0-py3-none-any.whl |
Total release size: 618.3 kB
Release files / bibliography_io-0.2.0.tar.gz
| Download URL | bibliography_io-0.2.0.tar.gz |
|---|---|
| Size | 581.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d0381e80f7d30f6606c6aa8cf7433cf767a45c196defcd4274b010761a26dc7e
|
|
BLAKE2b-256 checksum How to use checksums |
2abc83687a60b758a82a24bf5f13162b6b394dd428e2794db21e60800447c047
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.
Transparency logRelease files / bibliography_io-0.2.0-py3-none-any.whl
| Download URL | bibliography_io-0.2.0-py3-none-any.whl |
|---|---|
| Size | 37.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cf03d60ad93bcd5fe4d15723b70b60c3ca4bbe21b7d44a834e83927ddc84250b
|
|
BLAKE2b-256 checksum How to use checksums |
a858ffa4429937bcee3401ae7a330d96e1c5494da82ab7687d21a6b531c3a983
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.
Transparency logSecurity for bibliography-io 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for bibliography_io-0.2.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.