Metadata-Version: 2.1
Name: caleb
Version: 0.4.2
Summary: A tool to automatically retrieve bibtex entries
Home-page: https://github.com/kevinywlui/caleb
License: MIT
Keywords: latex,python,crossref
Author: kevin lui
Author-email: kevinywlui@gmail.com
Requires-Python: >=3.7,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Text Processing :: Markup :: LaTeX
Requires-Dist: crossref-commons (>=0.0.5,<0.0.6)
Description-Content-Type: text/markdown

# caleb

[![PyPI version](https://badge.fury.io/py/caleb.svg)](https://badge.fury.io/py/caleb)
[![Coverage Status](https://coveralls.io/repos/github/kevinywlui/caleb/badge.svg)](https://coveralls.io/github/kevinywlui/caleb)
[![Build Status](https://travis-ci.org/kevinywlui/caleb.svg?branch=master)](https://travis-ci.org/kevinywlui/caleb)

**caleb** is a tool to automatically fill in your Latex citations.

## Usage examples

See the `examples` directory along with the `an_example.tex` file. The
following examples occur in the `examples` directory.

* The best way is probably to integrate into `latexmk`. The `-pdflatex` flag
  allows us to run `caleb` after each `pdflatex` call.
```
latexmk -pdf -pdflatex='pdflatex %O %S; caleb %B' an_example
```

* We can set the `-pdflatex` flag in a `.latexmkrc` file. This can either go in
  the your tex project folder or in the home directory. So in the `.latexmkrc`
  file, include the following line (see examples directory for an example):
```
$pdflatex='pdflatex %O %S; caleb %B'
``` 

* The barebone approach is to run `caleb` before running bibtex.
```
pdflatex an_example
caleb an_example
bibtex an_example
pdflatex an_example
pdflatex an_example
```

* By default, `caleb` will ignore any citation where crossref.org returns
  multiple results. To take the first result ordered by relevance, pass the
  `--take-first` flag. For example,
```
caleb --take-first an_example
```



## Installation

### Dependencies

* [crossref_commons_py](https://gitlab.com/crossref/crossref_commons_py)
* `python3`

### Testing and Development Dependencies

* [python-coveralls](https://github.com/z4r/python-coveralls)
* [pytest](https://pytest.org/en/latest/) 
* [pytest-cov](https://github.com/pytest-dev/pytest-cov)
* [flake8](http://flake8.pycqa.org/en/latest/)

### `setup.py`

```
python setup.py install --user
```

### `pip`

```
pip3 install caleb --user
```

## Goal of project

* [ ] Reach feature parity with IRL [Caleb](https://sites.math.washington.edu/~geigerc/)

## Homepage

* https://github.com/kevinywlui/caleb

