Metadata-Version: 2.4
Name: kotobuki
Version: 0.4.0
Summary: Usagi mappings update tool
Project-URL: Repository, https://github.com/thehyve/kotobuki
Project-URL: Documentation, https://github.com/thehyve/kotobuki/blob/main/docs/kotobuki.md
Project-URL: Bug Tracker, https://github.com/thehyve/kotobuki/issues
Project-URL: Changelog, https://github.com/thehyve/kotobuki/blob/main/CHANGELOG.md
License: Apache Software License
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Requires-Python: >=3.11
Requires-Dist: click>=8.2.1
Requires-Dist: omop-cdm>=0.4.0
Requires-Dist: pandas>=2.2.3
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: sqlalchemy>=2.0.41
Description-Content-Type: text/markdown

# kotobuki

[![tests](https://github.com/thehyve/kotobuki/actions/workflows/tests.yml/badge.svg)](https://github.com/thehyve/kotobuki/actions/workflows/tests.yml)
[![PyPI Latest Release](https://img.shields.io/pypi/v/kotobuki.svg)](https://pypi.org/project/kotobuki/)
[![License](https://img.shields.io/pypi/l/kotobuki.svg)](https://github.com/thehyve/kotobuki/blob/main/LICENSE)

kotobuki is a Python package that can update custom mappings created in Usagi that have become
outdated in a new release of the OHDSI vocabularies.

## Installation

kotobuki requires Python 3.11+ and is available on [PyPI](https://pypi.org/project/kotobuki/).

Depending on the type of database you have, you'll also need to install the required python
adapter library.
E.g. for postgresql, you can use [psycopg2](https://pypi.org/project/psycopg2/).

See SQLAlchemy docs for a list of supported [dialects](https://docs.sqlalchemy.org/en/20/dialects/).

As kotobuki is intended to be used as a standalone tool, the recommended method of installation is
in an isolated (temporary) environment.

E.g. if using [uv](https://docs.astral.sh/uv/) with a postgresql database:

```shell
uvx --with psycopg2 --from kotobuki update-usagi-file --help
```

Or within a Jupyter notebook:

```shell
uv run --with jupyter,psycopg2,kotobuki jupyter lab
```


## Usage
See [User documentation](https://github.com/thehyve/kotobuki/blob/main/docs/kotobuki.md)

## Contributing

We welcome all contributions, including bug reports, fixes, documentation enhancements,
new ideas, and general improvements.

- We use the GitHub [issue tracker](https://github.com/thehyve/kotobuki/issues)
  for all bugs/issues/enhancements.
- See the [contributing](https://github.com/thehyve/kotobuki/CONTRIBUTING.md) page
  for instructions on kotobuki development.
