README.rst
1python-bibtexparser
2===================
3
4Python library to parse `bibtex <https://en.wikipedia.org/wiki/BibTeX>`_ files.
5
6
7IMPORTANT: the library is looking for new maintainers. Please, manifest yourself if you are interested.
8
9.. contents::
10
11
12Bibtexparser relies on `pyparsing <https://pypi.python.org/pypi/pyparsing>`_ and is compatible with Python 2.7 and 3.3 or newer.
13
14Documentation
15-------------
16
17Our documentation includes the installation procedure, a tutorial, the API and advices to report a bug.
18References, related projects and softwares based on bibtexparser are also listed. If you would like to appear on this list, feel free to open a ticket or send an email.
19
20`Documentation on readthedocs.io <https://bibtexparser.readthedocs.io/>`_
21
22Upgrading
23---------
24
25Please, read the changelog before upgrading regarding API modifications.
26Prior version 1.0, we do not hesitate to modify the API to get the best API from your feedbacks.
27
28License
29-------
30
31Dual license (at your choice):
32
33* LGPLv3.
34* BSD
35
36See COPYING for details.
37
38History and evolutions
39----------------------
40
41The original source code was part of bibserver from `OKFN <http://github.com/okfn/bibserver>`_. This project is released under the AGPLv3. OKFN and the original authors kindly provided the permission to use a subpart of their project (ie the bibtex parser) under LGPLv3. Many thanks to them!
42
43The parser evolved to a new core based on pyparsing.
44