Metadata-Version: 2.4
Name: tcknvkn
Version: 1.0.0
Summary: TCKN and VKN validation library for Python.
Author-email: "tcknvkn.com" <info@tcknvkn.com>
License: MIT
Project-URL: Homepage, https://www.tcknvkn.com/kutuphaneler/python
Project-URL: Repository, https://github.com/tcknvkn/tcknvkn-python
Project-URL: Documentation, https://www.tcknvkn.com/kutuphaneler/python
Keywords: tckn,vkn,turkey,validation
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# tcknvkn (Python)

Python library for validating Turkish TCKN (TC Kimlik Numarasi) and VKN (Vergi Kimlik Numarasi).

## Install

```bash
pip install tcknvkn
```

## Quick Start

```python
from tcknvkn import (
    validate_tckn,
    validate_multiple_tckn,
    validate_vkn,
    validate_multiple_vkn,
)

tckn = validate_tckn("10000000146")
print(tckn.valid)   # True
print(tckn.errors)  # []

vkn = validate_vkn("1000036109")
print(vkn.valid)    # True

bulk = validate_multiple_tckn(["10000000146", "99999999999"])
for item in bulk:
    print(item.value, item.valid)
```

## API

- `validate_tckn(value: str) -> ValidationResult`
- `validate_multiple_tckn(values: list[str]) -> list[ValidationResult]`
- `validate_vkn(value: str) -> ValidationResult`
- `validate_multiple_vkn(values: list[str]) -> list[ValidationResult]`

## ValidationResult

```python
from dataclasses import dataclass

@dataclass(frozen=True)
class ValidationResult:
    valid: bool
    value: str
    errors: list[str]
```

## Run Tests

```bash
PYTHONPATH=src python3 -m unittest discover -s tests
```

## License

MIT

## SEO Links

- Libraries hub: https://www.tcknvkn.com/kutuphaneler
- Library detail page: https://www.tcknvkn.com/kutuphaneler/python
- TC generator: https://www.tcknvkn.com/tc-uretici
- VKN generator: https://www.tcknvkn.com/vergi-no-uretici
