Metadata-Version: 2.4
Name: kannada-ascii-unicode
Version: 0.1.1
Summary: Kannada ASCII ↔ Unicode converter (basic mapping-based)
Author: Ravikumar Pawar
License-Expression: MIT
Project-URL: Homepage, https://github.com/kagapa-blr/py-kannada-ascii-unicode
Project-URL: Repository, https://github.com/kagapa-blr/py-kannada-ascii-unicode
Keywords: kannada,unicode,ascii,conversion,indic,indian-language
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Kannada ASCII ↔ Unicode Converter

A lightweight Python library to convert Kannada text between
ASCII-based legacy encodings and modern Unicode.

This package is useful when working with:
- Legacy Kannada ASCII fonts and data
- Unicode migration projects
- Text processing and validation

---

## Project Status

This is version 0.1.x and uses a mapping-based approach.

- Basic conversions work correctly
- Complex conjunct handling and full round-trip accuracy
  are still under improvement
- API is stable and mappings will improve over time

---

## Installation

```bash
pip install kannada-ascii-unicode
```

---

## Quick Start

```python
from kannada_converter import ascii_to_unicode, unicode_to_ascii
```

---

## ASCII to Unicode Conversion

Convert legacy ASCII-encoded Kannada text into Unicode.

```python
from kannada_converter import ascii_to_unicode

text_ascii = "kannaDa"
text_unicode = ascii_to_unicode.convert(text_ascii)

print(text_unicode)
```

Output:

```
ಕನ್ನಡ
```

---

## Unicode to ASCII Conversion

Convert Unicode Kannada text back to ASCII encoding.

```python
from kannada_converter import unicode_to_ascii

text_unicode = "ಕನ್ನಡ"
text_ascii = unicode_to_ascii.convert(text_unicode)

print(text_ascii)
```

Output:

```
kannaDa
```

---

## Sentence Conversion Example

```python
from kannada_converter import ascii_to_unicode

sentence = "namma kannaDa bhaashe"
result = ascii_to_unicode.convert(sentence)

print(result)
```

---

## Round-trip Behavior

```python
ascii_text = "kannaDa bhaashe"

unicode_text = ascii_to_unicode.convert(ascii_text)
back_to_ascii = unicode_to_ascii.convert(unicode_text)

print(back_to_ascii)
```

Due to the current mapping-based approach, round-trip results
may not be identical in all cases. This will improve in
future versions.

---

## How It Works

- Uses JSON-based character mappings
- Applies longest-key-first replacement
- No external dependencies
- Fast and lightweight

---

## Supported Python Versions

- Python 3.8 and above
- Works on Windows, Linux, and macOS

---

## Roadmap

Planned improvements include:
- Better conjunct handling
- Improved round-trip accuracy
- Optional command-line interface
- Font-specific mapping profiles

---

## License

MIT License

---

## Author

Ravikumar Pawar  
GitHub: https://github.com/kagapa-blr
