pybtexris 0.2.0

Installation

Install pybtexris from PyPI using pip:

pip install pybtexris

Command-line usage

To convert an RIS file to another format, use the pybtex-convert command. For example:

pybtex-convert bibliography.ris bibliography.bib

The extension of the output file must be supported by pybtex or an associated plugin.

To format an RIS file into a human-readable bibliography, use the pybtex-format command. For example:

pybtex-format bibliography.ris bibliography.txt

For more information, see the documentation for pybtex.

Programmatic usage

RIS files can be formatted into a human-readable bibliography as a string as follows:

from pybtex import format_from_file
bibliography_string = format_from_file(
    "path/to/file.ris",
    style="plain",
    output_backend="plaintext",
    bib_format="ris",
)

Multiple RIS files can be formatted in a similar way:

from pybtex import format_from_files
bibliography_string = format_from_files(
    ["path/to/file1.ris", "path/to/file2.ris"],
    style="plain",
    output_backend="plaintext",
    bib_format="ris",
)

So that RIS files can be combined with bibliography files of other formats (such as BibTeX), pybtexris also adds SuffixParser to the list of plugins which pybtex can use. The user just needs to give suffix as the argument to bib_format.

from pybtex import format_from_files
result = format_from_files(
    ["path/to/file1.ris", "path/to/file2.bib"],
    style="plain",
    output_backend="plaintext",
    bib_format="suffix",
)

The parsers for the files for other formats need to be registered on the pybtex.database.input.suffixes entry point as discussed pybtex plugin documentation. To combine with NBIB citation files, please use the pybtexnbib plugin.

For more information on programmatic use of pybtex, see the documentation of the Python API of pybtex.

Credit

Robert Turnbull (Melbourne Data Analytics Platform, University of Melbourne)