Metadata-Version: 2.4
Name: pninfo
Version: 0.0.1
Summary: Ushbu kutubxona orqali istalgan raqamingizni taxmin qilib yaratib olishingiz mumkin!
Home-page: https://github.com/ozodbekcommunity
Author: G'ulomjonov Javohir
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# рџ“± pninfo

O'zbekiston mobil raqamlarini generatsiya qilish, validatsiya qilish, detalizatsiya yig'ish va holatini tekshirish uchun mo'ljallangan Python kutubxonasi.

## вњЁ Xususiyatlari
- вњ… **Generatsiya**: Operator, prefix, regex/oddiy shablon, format (+998, 99..., raw) bo'yicha
- вњ… **Validatsiya**: O'zbekiston raqamlash rejasiga moslikni tekshirish
- вњ… **Detalizatsiya**: Operator, prefix, mintaqa, format, uzunlik haqida to'liq ma'lumot
- вњ… **Holat tekshiruvi**: Simulyatsiya + API-integratsiya tayyor struktura
- вњ… **Kengaytiriluvchan**: Yangi operator/kod qo'shish, custom API callback ulash

## вљ–пёЏ Huquqiy & Texnik Ogohlantirish
> рџ”Ќ **Real vaqtda raqamning band/bo'sh yoki faol/nofaol ekanligini aniqlash** faqat litsenziyalangan HLR (Home Location Register) tizimlari, operatorlarning rasmiy API'lar yoki tegishli shartnomalar orqali amalga oshirilishi mumkin. Ochiq internetdagi "bepul skanerlash" usullari qonunga zid va texnik jihatdan ishonchsiz. `pninfo` kutubxonasi default holatda **xavfsiz simulyatsiya** qiladi. Real tekshiruv uchun litsenziyalangan API kalitlarini ulashingiz kerak.

## рџ“¦ O'rnatish
```bash
pip install pninfo
# yoki lokal o'rnatish:
pip install .
```

## рџљЂ Tez Boshlash

```python
from pninfo import generate, get_info, check_availability, configure_api

# 1. Generatsiya
nums = generate(operator="beeline", count=5, pattern="endswith:1234", format_type="local")
print(nums)  # ['9012341234', ...]

# 2. Ma'lumot yig'ish
info = get_info("+998901234567")
print(info.operator)       # beeline
print(info.is_valid_format)# True
print(info.metadata)       # {...}

# 3. Real holat tekshiruvi (API bilan)
configure_api("numverify", {"api_key": "SIZNING_API_KALITINGIZ"})
status = check_availability("+998901234567")
print("Faol" if status else "Nofaol/Band")
```
