Metadata-Version: 2.1
Name: bactax
Version: 0.2.0
Summary: A simple python tool for getting bacterial taxonomy and gram stain information from NCBI taxonomy data.
License: MIT
Author: Adam Bates
Author-email: adambates923@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: polars (>=1.19.0,<2.0.0)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Requires-Dist: rich (>=13.9.4,<14.0.0)
Description-Content-Type: text/markdown

# bactax 0.2.0

A simple python tool for getting bacterial taxonomy and gram stain information
from NCBI taxonomy data.

## Installation

The most recently released version of bactax can be downloaded with pip:

```sh
pip install bactax
```

## Usage

### Getting taxonomic information for a bacteria

```python
import bactax

genus = "akkermansia"
taxonomy = bactax.get_taxonomy(genus=genus) # returns a Taxonomy object
```

This will return a `Taxonomy` object with all the information above the level of
genus filled in (i.e., family, order, class, etc.).

### Determining gram stain

```python
import bactax

genus = "escherichia"
gram_stain = bactax.gram_stain(genus=genus) # returns Gram.NEGATIVE
```

### Updating the taxonomy data

`bactax` uses data from NCBI's taxonomy database. This data is downloaded and
stored in a gzipped csv within the package. Since NCBI regularly updates their
data, bactax provides a method to download the latest taxonomy database from
NCBI.

```python
import bactax
bactax.update()
```

