Metadata-Version: 2.4
Name: r_nida
Version: 0.1.0
Summary: A package for reverse engineering with NIDA
Home-page: https://github.com/Henryle-hd/r_nida
Author: Henrylee
Author-email: Henrylee <henrydionizi@gmail.com>
Project-URL: Homepage, https://github.com/Henryle-hd/reverse_nida
Project-URL: Bug Reports, https://github.com/Henryle-hd/reverse_nida/issues
Project-URL: Source, https://github.com/Henryle-hd/reverse_nida
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# Reverse NIDA

A Python package that attempts to reverse engineer how NIDA (National Identification Authority) numbers are generated and extract basic information from National Identification Numbers (NIN) without using the official NIDA API.

## ⚠️ Disclaimer

This project is for educational and research purposes only. It attempts to understand the structure and patterns in NIDA numbers through reverse engineering. The accuracy of extracted information is not guaranteed, and this should not be used for official verification purposes.


## 🚀 Installation

### From PyPI
```bash
pip install reverse-nida
```

## 📖 Usage

### Simple Usage (Recommended)
```python
from r_nida import get_basic_info

# Analyze a NIDA number (supports both dashed and compact formats)
nin_dashed = "xxxxxxxx-xxxxx-xxxxx-xx"
nin_compact = "xxxxxxxxxxxxxxxxxxxx"

# Get basic information
info = get_basic_info(nin_dashed, debug=False)
print(info)
# Output: {
#   'BIRTHDATE': '',
#   'GENDER': '',
#   'REGIONCODE':'',
#   'REGION': '',
#   'DISTRICT': '',
#   'WARDCODE':'',
#   'WARD': '',
#   'WARDCODE': '',
#   'STREET': '',
#   'PLACES':'',
# }

# Get full information with debug
info = service.get_basic_info("xxxxxxxx-xxxxx-xxxxx-xx", debug=True)
```

### Setup Development Environment
```bash
git clone https://github.com/Henryle-hd/reverse-nida.git
cd reverse-nida
```
