# [Nida](https://kalebu.github.io/Nida/)
Unofficial package for fetching users information based on National ID Number made by [kalebu](https://github.com/Kalebu/)
[](https://github.com/Kalebu/nida)
[](https://pepy.tech/project/nida)
[](https://pepy.tech/project/nida)
[](https://pepy.tech/project/nida)
[](https://opensource.org/licenses/MIT)
## Installation
You can install it directly or using pip
Here how to install directly
```bash
git clone https://github.com/Kalebu/Nida
cd Nida
Nida -> python setup.y install
```
Here how to install from pip
```bash
pip install nida
```
## Usage
To fetch user information based on ID number do this;
```python
>>> from nida import load_user
>>> user_detail = load_user(national_id='XXXXXXXXX')
>>> print(user_detail)
user
{'Nin': 'XXXXXX', 'Firstname': 'XXXXXX', 'Middlename': 'XXXXXX', 'Surname': 'XXXXXX', 'Othernames': 'XXXXXX', 'Sex': 'XXXXXX', 'Dateofbirth': 'XXXXXX', 'Residentregion': 'XXXXXX', 'Residentdistrict': 'XXXXXX', 'Residentward': 'XXXXXX', 'Residentvillage': 'XXXXXX', 'Residentstreet': 'XXXXXX', 'Residentpostcode': 'XXXXXX', 'Permanentregion': 'XXXXXX', 'Permanentdistrict': 'XXXXXX', 'Permanentward': 'XXXXXX', 'Permanentvillage': 'XXXXXX', 'Permanentstreet': 'XXXXXX', 'Birthcountry': 'XXXXXX', 'Birthregion': 'XXXXXX', 'Birthdistrict': 'XXXXXX', 'Birthward': 'XXXXXX', 'Nationality': 'XXXXXX', 'Phonenumber': 'XXXXXX', 'Maritalstatus': 'XXXXXX', 'Occupation': 'XXXXXX', 'Primaryschooleducation': 'XXXXXX', 'Primaryschooldistrict': 'XXXXXX', 'Primaryschoolyear': 'XXXXXX', 'Photo': 'XXXXXX', 'Signature': 'XXXXXX', 'Nationalidnumber': 'XXXXXX', 'Lastname': 'XXXXXX'}
```
You can access user infromation by using keys and attributes just as shown below;
```python
>>> user_detetail['Firstname']
'XXXXXX'
>>> user_detail.get('Middlename')
'XXXXXX'
>>> user_detail.Lastname
'XXXXXX'
```
## Image and Signature are currently not supported (Depreciated !!)
National ID Photo and Signature are auto converted into PIL Images and you can easily save just as shown below;
```python
>>> user_detail.Photo.save('National_ID.png')
>>> user_detail.Signature.save('Signature.png')
```
If you want the data to be in the same from an API without any side effect preprocessing do this instead while loading user;
```python
>>> user_detail = load_user('xxxxxxxxxx', json = True)
>>> print(user_detail)
{
....
}
```
## Give it star
Did you find this repository useful to you ? Well then give it a star so as more people can get to know about it;
## Issues
Are you facing any issue with usage of the package, just raise an issue and I looking to fixing it as soon as I can.
## Contributions
If there is anything yould would like to add warmly welcome, Just fork it
## Disclaimers
This is not an official package, therefore I'm not responsible for any misinformation or misuse of the package of any kind !!!
## Credits
All the credits to [Kalebu](https://github.com/Kalebu/) and [StackOverflow comment](https://stackoverflow.com/questions/53369396/how-to-integrate-national-identification-authority-nida-api-for-tanzania) from [dbrax](https://stackoverflow.com/users/6131960/emanuel-paul-mnzava)
Raw data
{
"_id": null,
"home_page": "https://github.com/Kalebu/nida",
"name": "nida",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "nida,nida apinida python packagepython nidatanzania nida,python-tanzania",
"author": "Jordan Kalebu",
"author_email": "isaackeinstein@gmail.com",
"download_url": "https://github.com/Kalebu/Nida/archive/0.2.tar.gz",
"platform": null,
"description": "# [Nida](https://kalebu.github.io/Nida/)\n\nUnofficial package for fetching users information based on National ID Number made by [kalebu](https://github.com/Kalebu/)\n\n[](https://github.com/Kalebu/nida)\n[](https://pepy.tech/project/nida)\n[](https://pepy.tech/project/nida)\n[](https://pepy.tech/project/nida)\n[](https://opensource.org/licenses/MIT)\n\n## Installation\n\nYou can install it directly or using pip\n\nHere how to install directly\n\n```bash\ngit clone https://github.com/Kalebu/Nida\ncd Nida\nNida -> python setup.y install\n```\n\nHere how to install from pip\n\n```bash\npip install nida\n```\n\n## Usage\n\nTo fetch user information based on ID number do this;\n\n```python\n>>> from nida import load_user\n>>> user_detail = load_user(national_id='XXXXXXXXX')\n>>> print(user_detail)\nuser\n{'Nin': 'XXXXXX', 'Firstname': 'XXXXXX', 'Middlename': 'XXXXXX', 'Surname': 'XXXXXX', 'Othernames': 'XXXXXX', 'Sex': 'XXXXXX', 'Dateofbirth': 'XXXXXX', 'Residentregion': 'XXXXXX', 'Residentdistrict': 'XXXXXX', 'Residentward': 'XXXXXX', 'Residentvillage': 'XXXXXX', 'Residentstreet': 'XXXXXX', 'Residentpostcode': 'XXXXXX', 'Permanentregion': 'XXXXXX', 'Permanentdistrict': 'XXXXXX', 'Permanentward': 'XXXXXX', 'Permanentvillage': 'XXXXXX', 'Permanentstreet': 'XXXXXX', 'Birthcountry': 'XXXXXX', 'Birthregion': 'XXXXXX', 'Birthdistrict': 'XXXXXX', 'Birthward': 'XXXXXX', 'Nationality': 'XXXXXX', 'Phonenumber': 'XXXXXX', 'Maritalstatus': 'XXXXXX', 'Occupation': 'XXXXXX', 'Primaryschooleducation': 'XXXXXX', 'Primaryschooldistrict': 'XXXXXX', 'Primaryschoolyear': 'XXXXXX', 'Photo': 'XXXXXX', 'Signature': 'XXXXXX', 'Nationalidnumber': 'XXXXXX', 'Lastname': 'XXXXXX'}\n```\n\nYou can access user infromation by using keys and attributes just as shown below;\n\n```python\n>>> user_detetail['Firstname']\n'XXXXXX'\n>>> user_detail.get('Middlename')\n'XXXXXX'\n>>> user_detail.Lastname\n'XXXXXX'\n```\n\n## Image and Signature are currently not supported (Depreciated !!)\n\nNational ID Photo and Signature are auto converted into PIL Images and you can easily save just as shown below;\n\n```python\n>>> user_detail.Photo.save('National_ID.png')\n>>> user_detail.Signature.save('Signature.png')\n```\n\nIf you want the data to be in the same from an API without any side effect preprocessing do this instead while loading user;\n\n```python\n>>> user_detail = load_user('xxxxxxxxxx', json = True)\n>>> print(user_detail)\n{\n ....\n}\n```\n\n## Give it star\n\nDid you find this repository useful to you ? Well then give it a star so as more people can get to know about it;\n\n## Issues\n\nAre you facing any issue with usage of the package, just raise an issue and I looking to fixing it as soon as I can.\n\n## Contributions\n\nIf there is anything yould would like to add warmly welcome, Just fork it\n\n## Disclaimers\n\nThis is not an official package, therefore I'm not responsible for any misinformation or misuse of the package of any kind !!!\n\n## Credits\n\nAll the credits to [Kalebu](https://github.com/Kalebu/) and [StackOverflow comment](https://stackoverflow.com/questions/53369396/how-to-integrate-national-identification-authority-nida-api-for-tanzania) from [dbrax](https://stackoverflow.com/users/6131960/emanuel-paul-mnzava)\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A python libary to Easy fetching user information based on National ID (Tanzania)",
"version": "0.1.7",
"project_urls": {
"Download": "https://github.com/Kalebu/Nida/archive/0.2.tar.gz",
"Homepage": "https://github.com/Kalebu/nida"
},
"split_keywords": [
"nida",
"nida apinida python packagepython nidatanzania nida",
"python-tanzania"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ca8d35b0cc59e481231fb644ea3c73538cf4041ac598d1376a5e68efabe94718",
"md5": "765d4a201dd3c0740a0f430693b96dc1",
"sha256": "6326f34da19327ed2f0ab578d0bf3d5f56324d9ac6ad521a445d30b87fb385d2"
},
"downloads": -1,
"filename": "nida-0.1.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "765d4a201dd3c0740a0f430693b96dc1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 3630,
"upload_time": "2023-09-17T11:02:36",
"upload_time_iso_8601": "2023-09-17T11:02:36.371511Z",
"url": "https://files.pythonhosted.org/packages/ca/8d/35b0cc59e481231fb644ea3c73538cf4041ac598d1376a5e68efabe94718/nida-0.1.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-17 11:02:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Kalebu",
"github_project": "nida",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "nida"
}
JSON
