Metadata-Version: 2.1
Name: cas-python
Version: 0.0.5
Summary: Database of CAS Registry Number for Python
Author: Antonio Silva
Maintainer: Antonio Silva
Project-URL: Homepage, https://github.com/asergios/cas-python
Project-URL: Bug Reports, https://github.com/asergios/cas-python/issues
Project-URL: Source, https://github.com/asergios/cas-python/
Keywords: cas,registry,chemical,abstracts,service,database,formula
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: pre-commit<4.0.0,>=3.8.0; extra == "dev"
Requires-Dist: ruff<1.0.0,>=0.6.1; extra == "dev"
Requires-Dist: black<25.0.0,>=24.8.0; extra == "dev"
Requires-Dist: mypy<2.0.0,>=1.11.1; extra == "dev"
Provides-Extra: test

# cas-python

cas-python is a Python library that provides access to a database of CAS Registry Numbers, allowing easy retrieval of chemical information by CAS number, chemical formula, or name.

## Installation

Use the package manager [pip](https://pip.pypa.io/en/stable/) to install cas-python.

```bash
pip install cas-python
```

## Usage

```python
>>> import cas

>>> # Get entry by CAS number
>>> cas.database.get(cas="7732-18-5")
CASEntry(cas='7732-18-5', name='water', formula='H2O')

>>> # Get entry by chemical formula
>>> cas.database.get(formula="H2O")
CASEntry(cas='7732-18-5', name='water', formula='H2O')

>>> # Get entry by chemical name
>>> cas.database.get(name="water")
CASEntry(cas='7732-18-5', name='water', formula='H2O')

>>> # Explore the retrieved entry
>>> gold = cas.database.get(name="gold")
>>> gold
CASEntry(cas='7440-57-5', name='gold', formula='Au')

>>> # Access specific attributes of the entry
>>> gold.cas
'7440-57-5'
>>> gold.formula
'Au'
```
