Skip to main content
bibliography-io logo

bibliography-io

PyPI - Version PyPI - Python Version License GitHub Actions Documentation

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.

The following libraries support additional bibliographic formats, conversion workflows, and reference extraction:

  • BibtexParser — A lightweight, actively maintained library for reading, writing, and modifying .bib files. 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)

Source distribution for bibliography-io 0.2.0
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)

Table of built distributions (wheels) for bibliography-io 0.2.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page