Metadata-Version: 2.5
Name: openodia
Version: 0.1.14
Summary: Open source Odia language tools
Project-URL: Repository, https://github.com/soumendrak/openodia
Project-URL: Documentation, https://openodia.soumendrak.com
Project-URL: Issues, https://github.com/soumendrak/openodia/issues
Author-email: Soumendra Kumar Sahoo <proud_odia@outlook.com>
License: MIT
License-File: LICENSE
Keywords: github-actions,nlp,odia,packaging,pip,pypi,python,uv
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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 :: 3.15
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.11
Requires-Dist: deep-translator>=1.11.4
Requires-Dist: faker>=13.4.0
Requires-Dist: rich>=12.2.0
Provides-Extra: cache
Requires-Dist: diskcache>=5.0.0; extra == 'cache'
Provides-Extra: dev
Requires-Dist: bandit>=1.7.1; extra == 'dev'
Requires-Dist: commitizen>=2.27.1; extra == 'dev'
Requires-Dist: diskcache>=5.0.0; extra == 'dev'
Requires-Dist: mkdocs-git-revision-date-localized-plugin>=0.10.0; extra == 'dev'
Requires-Dist: mkdocs-material>=7.3.2; extra == 'dev'
Requires-Dist: mkdocs>=1.2.2; extra == 'dev'
Requires-Dist: pre-commit>=2.17.0; extra == 'dev'
Requires-Dist: pytest-cov>=3.0.0; extra == 'dev'
Requires-Dist: pytest>=6.2.5; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: docs
Requires-Dist: mkdocs-git-revision-date-localized-plugin>=0.10.0; extra == 'docs'
Requires-Dist: mkdocs-material>=7.3.2; extra == 'docs'
Requires-Dist: mkdocs>=1.2.2; extra == 'docs'
Description-Content-Type: text/markdown

![image](docs/cover-pic.png)

<h4 align="center">
  <a href="https://img.shields.io/badge/Python-3.11+-blue"><img alt="python 3.11+" src="https://img.shields.io/badge/Python-3.11+-blue"></a>
  <a href="https://github.com/soumendrak/openodia/actions/workflows/codecov.yml"><img alt="Code coverage" src="https://github.com/soumendrak/openodia/actions/workflows/codecov.yml/badge.svg"></a>
  <a href="https://github.com/soumendrak/openodia/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
  <a href="https://codecov.io/gh/soumendrak/openodia"><img alt="code coverage" src="https://codecov.io/gh/soumendrak/openodia/branch/main/graph/badge.svg?token=1TOQIKGDQ2"/></a>
  <a href="https://pepy.tech/project/openodia" alt="downloads"><img src="https://static.pepy.tech/personalized-badge/openodia?period=total&units=none&left_color=black&right_color=orange&left_text=Downloads"/></a>
</h4>


- `openodia` is a Python package which contains various tools on Odia language.
- The short term goal of this package is to not make state-of-the-art methods, but to make tools which work.

## Install

- Requires **Python 3.11 or higher**.
- The library is tested on Python 3.11, 3.12, 3.13, 3.14, and 3.15.

### Using pip

```bash
pip install openodia
```

### Using uv (recommended)

[uv](https://docs.astral.sh/uv/) is a fast Python package installer and resolver.

```bash
# Install uv if you haven't already
pip install uv

# Install openodia
uv pip install openodia

# Or add to your project
uv add openodia
```

### From source

```bash
git clone https://github.com/soumendrak/openodia.git
cd openodia
uv sync  # or: pip install -e .
```

## Usage and Documentation

For usage and further documentation please visit the [Documentation](https://openodia.soumendrak.com/) page. 

### Command-line interface

Run `openodia --help` or `python -m openodia --help` for commands, and
`openodia --version` for the installed version.

```bash
openodia tokenize 'ରାମ ସୀତା'
openodia tokenize --file input.txt
cat input.txt | python -m openodia tokenize -
```

Text arguments are literal text, even when they match an existing filename.
Use `--file` to read a UTF-8 file explicitly (implicit file detection has been
removed). Pass `-` without `--file` to read UTF-8 text from stdin.

## Sponsor

If this project helps you, consider [sponsoring my work on GitHub](https://github.com/sponsors/soumendrak). Your support helps fund maintenance, documentation, and continued development.

## License

Released under the [MIT License](LICENSE).
