Metadata-Version: 2.1
Name: pybib
Version: 2.3.1
Summary: Fetch BibTeX citation information, given a Digital Object Identifier
Home-page: https://jgilchrist.github.io/pybib/
License: BSD-3-Clause
Author: Jonathan Gilchrist
Author-email: jonathan.gilchrist@factset.com
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: colorama (>=0.4.1,<0.5.0)
Requires-Dist: requests (>=2.21,<3.0)
Project-URL: Repository, https://github.com/jgilchrist/pybib
Description-Content-Type: text/x-rst

pybib |PyPI version| |Travis CI|
===========================================================

pybib is an easy way to get citations for your LaTeX document.
Instead of typing out BibTeX entries yourself, just give pybib the
Digital Object Identifier (DOI) of the resource you want to cite and it
will get all the information for you. Then, you can just add the
citation it gives you to your BibTeX file.

Demo
----

|demo|

Installation
------------

The package is available on PyPi and can be installed with the following
command:

.. code:: sh

    $ pip3 install --user pybib

For user-only installs, pip installs scripts to the directory
``~/.local/bin``, so make sure itâ€™s in your path. If you would prefer to
install it system-wide, just leave out the ``--user`` flag.

Usage examples
--------------

Get a citation:

.. code:: sh

    $ bib get 10.1112/plms/s2-42.1.230

Get a citation and add it to your bibliography file:

.. code:: sh

    $ bib get 10.1145/159544.159617 >> citations.bib

Get a citation and add it to your bibliography file, running it through
``bibtool`` first to format the entry and auto-generate a citation key:

.. code:: sh

    $ bib get 10.1145/159544.159617 | bibtool >> citations.bib

Searching
---------

Search for a resource:

.. code:: sh

    $ bib search name of the resource

Get the citation for search result number ``N``:

.. code:: sh

    $ bib search name of the resource --get N

Troubleshooting
---------------

If you encounter any problems, please open an issue so I can rectify
them as soon as possible.

.. |demo| image:: https://asciinema.org/a/d28uzeuzswvbzvd1itd5gd1gi.png
   :target: https://asciinema.org/a/d28uzeuzswvbzvd1itd5gd1gi?autoplay=1
.. |PyPI version| image:: https://img.shields.io/pypi/v/pybib.svg?style=flat
   :target: https://pypi.python.org/pypi?:action=display&name=pybib
.. |Travis CI| image:: https://travis-ci.org/jgilchrist/pybib.svg?branch=master
    :target: https://travis-ci.org/jgilchrist/pybib

