Metadata-Version: 2.4
Name: ru-api-free
Version: 1.0.1
Summary: Free API for conjugating Russian verbs in all tenses (present, past, future)
Author-email: Radoslaw <faharht@email.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/faharht/ru-api-free
Project-URL: Source, https://github.com/faharht/ru-api-free
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
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
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi
Requires-Dist: uvicorn[standard]
Requires-Dist: aiofiles
Requires-Dist: deep_translator
Dynamic: license-file

# ru-api-free

Free API for conjugating Russian verbs in all tenses (present, past, future).

## Install

```bash
pip install ru-api-free
```

## Usage

Start the API server:

```bash
ru-api-free
```

Or directly with uvicorn:

```bash
uvicorn ru_api_free.main:app
```

The API will be available at `http://localhost:8000`. Open `http://localhost:8000/docs` for interactive documentation.

### Endpoints

| Endpoint | Description |
|---|---|
| `GET /conjugate?verb={verb}` | Get full conjugation of a Russian verb |
| `GET /translate?english={word}` | Enter an English verb, get Russian conjugation |
| `GET /verbs` | List all available verbs |
| `GET /search?q={query}` | Search for verbs |
| `GET /exceptions` | List all verbs with conjugation exceptions |
| `GET /exceptions/{verb}` | Get exceptions for a specific verb |

## Python API

```python
from ru_api_free import conjugate

result, status = conjugate("читать")
print(result)
```

```python
from ru_api_free import translate_en_to_ru

russian = translate_en_to_ru("read")
print(russian)  # читать
```

## License

MIT
