/usr/lib/python2.7/dist-packages/pybtex/bibtex/__init__.py is in pybtex 0.20.1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 | # Copyright (c) 2006-2016 Andrey Golovizin
# Permission is hereby granted, free of charge, to any person obtaining
# a copy of this software and associated documentation files (the
# "Software"), to deal in the Software without restriction, including
# without limitation the rights to use, copy, modify, merge, publish,
# distribute, sublicense, and/or sell copies of the Software, and to
# permit persons to whom the Software is furnished to do so, subject to
# the following conditions:
#
# The above copyright notice and this permission notice shall be
# included in all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
# CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
"""BibTeX unnamed stack language interpreter and related stuff
"""
from os import path
from pybtex import Engine
class BibTeXEngine(Engine):
"""
The Python fomatting engine.
See :py:class:`pybtex.Engine` for inherited methods.
"""
def format_from_files(
self,
bib_files_or_filenames,
style,
citations=['*'],
bib_format=None,
bib_encoding=None,
output_encoding=None,
bst_encoding=None,
min_crossrefs=2,
output_filename=None,
add_output_suffix=False,
**kwargs
):
"""
Read the bigliography data from the given files and produce a formated
bibliography.
:param bib_files_or_filenames: A list of file names or file objects.
:param style: The name of the formatting style.
:param citations: A list of citation keys.
:param bib_format: The name of the bibliography format. The default
format is ``bibtex``.
:param bib_encoding: Encoding of bibliography files.
:param output_encoding: Encoding that will be used by the output backend.
:param bst_encoding: Encoding of the ``.bst`` file.
:param min_crossrefs: Include cross-referenced entries after this many
crossrefs. See BibTeX manual for details.
:param output_filename: If ``None``, the result will be returned as a
string. Else, the result will be written to the specified file.
:param add_output_suffix: Append a ``.bbl`` suffix to the output file name.
"""
from io import StringIO
import pybtex.io
from pybtex.bibtex import bst
from pybtex.bibtex.interpreter import Interpreter
if bib_format is None:
from pybtex.database.input.bibtex import Parser as bib_format
bst_filename = style + path.extsep + 'bst'
bst_script = bst.parse_file(bst_filename, bst_encoding)
interpreter = Interpreter(bib_format, bib_encoding)
bbl_data = interpreter.run(bst_script, citations, bib_files_or_filenames, min_crossrefs=min_crossrefs)
if add_output_suffix:
output_filename = output_filename + '.bbl'
if output_filename:
output_file = pybtex.io.open_unicode(output_filename, 'w', encoding=output_encoding)
else:
output_file = StringIO()
with output_file:
output_file.write(bbl_data)
if isinstance(output_file, StringIO):
return output_file.getvalue()
def make_bibliography(*args, **kwargs):
"""A convenience function that calls :py:meth:`.BibTeXEngine.make_bibliography`."""
return BibTeXEngine().make_bibliography(*args, **kwargs)
def format_from_file(*args, **kwargs):
"""A convenience function that calls :py:meth:`.BibTeXEngine.format_from_file`."""
return BibTeXEngine().format_from_file(*args, **kwargs)
def format_from_files(*args, **kwargs):
"""A convenience function that calls :py:meth:`.BibTeXEngine.format_from_files`."""
return BibTeXEngine().format_from_files(*args, **kwargs)
def format_from_string(*args, **kwargs):
"""A convenience function that calls :py:meth:`.BibTeXEngine.format_from_string`."""
return BibTeXEngine().format_from_string(*args, **kwargs)
def format_from_strings(*args, **kwargs):
"""A convenience function that calls :py:meth:`.BibTeXEngine.format_from_strings`."""
return BibTeXEngine().format_from_strings(*args, **kwargs)
|