Metadata-Version: 2.4
Name: ethnidata
Version: 4.1.3
Summary: Name Analysis & Prediction Engine
Author: Teyfik Oz
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: pandas
Requires-Dist: numpy
Requires-Dist: requests
Requires-Dist: tqdm
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# EthniData: Name Diversity & Analysis Engine

EthniData is a powerful library for analyzing names to predict cultural origin, ethnicity, and gender usage useful for diversity analytics and demographic studies.

## Installation

```bash
pip install ethnidata
```

## Example Usage & Verification

### Code

```python
from ethnidata import EthniData

ed = EthniData()

names = ["Yılmaz", "Tanaka", "Schmidt", "O'Connor"]
results = [ed.predict_nationality(name, name_type="last") for name in names]

for r in results:
    print(f"Name: {r['name']:10} -> Predicted: {r['predicted_country']}")
```

### Verified Output

```text
Name: Yılmaz     -> Predicted: TR
Name: Tanaka     -> Predicted: JP
Name: Schmidt    -> Predicted: DE
Name: O'Connor   -> Predicted: IE
```

## Features
*   **Nationality Prediction**: Predict likely country of origin for surnames.
*   **Gender Inference**: Probabilistic gender detection.
*   **Report Generation**: Create diversity reports from user lists.
*   **Visualizations**: Built-in plotting for demographic breakdowns.

## License
MIT
