=========
indiapins
=========
.. image:: https://img.shields.io/pypi/v/indiapins?label=PyPI&logo=PyPI&logoColor=white&color=blue
:target: https://pypi.python.org/pypi/indiapins
.. image:: https://img.shields.io/pypi/pyversions/indiapins?label=Python&logo=Python&logoColor=white
:target: https://www.python.org/downloads
:alt: Python versions
.. image:: https://ci.appveyor.com/api/projects/status/43hcwr4me6vjb1fg?svg=true
:target: https://ci.appveyor.com/project/pawangeek/indiapins
:alt: Build
.. image:: https://static.pepy.tech/badge/indiapins
:target: https://pepy.tech/project/indiapins
:alt: Downloads
**Indiapins is a Python package for getting the places tagged to particular Indian pincode**
**Data is last updated of 26, Jan, 2025, with 157191 area pin codes**
* Free software: MIT license
* Documentation: https://pawangeek.github.io/indiapins/
* Github Repo: https://github.com/pawangeek/indiapins
* PyPI: https://pypi.org/project/indiapins/
Installation
------------
Install the plugin using 'pip':
.. code-block:: shell
$ pip install indiapins
Alternatively, install from source by cloning this repo then running
'setup.py':
.. code-block:: shell
$ python setup.py install
Features
--------
* Get all the mappings of given pins
* The Python sqlite3 module is not required, so easily to use in Clouds (no additional dependencies)
* Works with 3.9, 3.10, 3.11, 3.12, 3.13 and PyPy
* Cross-platform: Windows, Mac, and Linux are officially supported.
* Simple usage and very fast results
Examples
--------
1. Exact Match
##############
To find the names of all places, districts, circles and related information by given Indian Pincode
**Important: The Pincode should be of 6 digits, in string format**
.. code-block:: python
indiapins.matching('110011')
[{'Name': 'Nirman Bhawan', 'BranchType': 'Sub Post Office', 'DeliveryStatus': 'Delivery', 'Circle': 'Delhi', 'District': 'Central Delhi', 'Division': 'New Delhi Central', 'Region': 'Delhi', 'Block': 'New Delhi', 'State': 'Delhi', 'Country': 'India', 'Pincode': '110011'},
{'Name': 'South Avenue', 'BranchType': 'Sub Post Office', 'DeliveryStatus': 'Non-Delivery', 'Circle': 'Delhi', 'District': 'Central Delhi', 'Division': 'New Delhi Central', 'Region': 'Delhi', 'Block': 'New Delhi', 'State': 'Delhi', 'Country': 'India', 'Pincode': '110011'},
{'Name': 'Udyog Bhawan', 'BranchType': 'Sub Post Office', 'DeliveryStatus': 'Non-Delivery', 'Circle': 'Delhi', 'District': 'Central Delhi', 'Division': 'New Delhi Central', 'Region': 'Delhi', 'Block': 'New Delhi', 'State': 'Delhi', 'Country': 'India', 'Pincode': '110011'}]
2. Valid Pincode
################
To check if the given Pincode is valid or not
.. code-block:: python
indiapins.isvalid('110011')
True
3. District by Pincode
######################
It extracts the district of given Indian pincode
.. code-block:: python
indiapins.districtmatch('302005')
'Jaipur'
4. Coordinates of Pincode
#########################
It extracts all the coordinates of given Indian pincode
.. code-block:: python
indiapins.coordinates('110011')
{'Udyog Bhawan': {'latitude': '28.6111111', 'longitude': '77.2127500'},
'Nirman Bhawan': {'latitude': '28.6108611', 'longitude': '77.2148611'}}
=======
History
=======
1.0.4 (2025-01-26)
------------------
* Added new pins
1.0.1 (2024-08-10)
------------------
* Added latest libs
1.0.1 (2023-09-12)
------------------
* Fix pins import error
0.1.7 (2023-09-11)
------------------
* Update Pincode data to latest (Sept 2023)
* Added coordinates info with pins
* Fetch longitude and latitude of any pin
* Update security vulnerabilities
0.1.0 (2021-07-27)
------------------
* Match location with the pins
* Mark pin is valid or not
* Extract cities on basis of pins
Raw data
{
"_id": null,
"home_page": "https://github.com/pawangeek/indiapins",
"name": "indiapins",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "indiapins india pincodes zipcodes",
"author": "Pawan Kumar Jain",
"author_email": "pawanjain.432@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/3a/50/ac08e3a7d08b162ea28e73939b7272531d7a52f8cdad1aabee8b8681e7ed/indiapins-1.0.4.tar.gz",
"platform": null,
"description": "=========\nindiapins\n=========\n\n\n.. image:: https://img.shields.io/pypi/v/indiapins?label=PyPI&logo=PyPI&logoColor=white&color=blue\n :target: https://pypi.python.org/pypi/indiapins\n\n.. image:: https://img.shields.io/pypi/pyversions/indiapins?label=Python&logo=Python&logoColor=white\n :target: https://www.python.org/downloads\n :alt: Python versions\n\n.. image:: https://ci.appveyor.com/api/projects/status/43hcwr4me6vjb1fg?svg=true\n :target: https://ci.appveyor.com/project/pawangeek/indiapins\n :alt: Build\n\n.. image:: https://static.pepy.tech/badge/indiapins\n :target: https://pepy.tech/project/indiapins\n :alt: Downloads\n\n\n**Indiapins is a Python package for getting the places tagged to particular Indian pincode**\n\n**Data is last updated of 26, Jan, 2025, with 157191 area pin codes**\n\n* Free software: MIT license\n* Documentation: https://pawangeek.github.io/indiapins/\n* Github Repo: https://github.com/pawangeek/indiapins\n* PyPI: https://pypi.org/project/indiapins/\n\n\nInstallation\n------------\n\nInstall the plugin using 'pip':\n\n.. code-block:: shell\n\n $ pip install indiapins\n\nAlternatively, install from source by cloning this repo then running\n'setup.py':\n\n.. code-block:: shell\n\n $ python setup.py install\n\n\nFeatures\n--------\n* Get all the mappings of given pins\n* The Python sqlite3 module is not required, so easily to use in Clouds (no additional dependencies)\n* Works with 3.9, 3.10, 3.11, 3.12, 3.13 and PyPy\n* Cross-platform: Windows, Mac, and Linux are officially supported.\n* Simple usage and very fast results\n\n\nExamples\n--------\n\n1. Exact Match\n##############\n\nTo find the names of all places, districts, circles and related information by given Indian Pincode\n\n**Important: The Pincode should be of 6 digits, in string format**\n\n.. code-block:: python\n\n indiapins.matching('110011')\n\n [{'Name': 'Nirman Bhawan', 'BranchType': 'Sub Post Office', 'DeliveryStatus': 'Delivery', 'Circle': 'Delhi', 'District': 'Central Delhi', 'Division': 'New Delhi Central', 'Region': 'Delhi', 'Block': 'New Delhi', 'State': 'Delhi', 'Country': 'India', 'Pincode': '110011'},\n {'Name': 'South Avenue', 'BranchType': 'Sub Post Office', 'DeliveryStatus': 'Non-Delivery', 'Circle': 'Delhi', 'District': 'Central Delhi', 'Division': 'New Delhi Central', 'Region': 'Delhi', 'Block': 'New Delhi', 'State': 'Delhi', 'Country': 'India', 'Pincode': '110011'},\n {'Name': 'Udyog Bhawan', 'BranchType': 'Sub Post Office', 'DeliveryStatus': 'Non-Delivery', 'Circle': 'Delhi', 'District': 'Central Delhi', 'Division': 'New Delhi Central', 'Region': 'Delhi', 'Block': 'New Delhi', 'State': 'Delhi', 'Country': 'India', 'Pincode': '110011'}]\n\n\n2. Valid Pincode\n################\n\nTo check if the given Pincode is valid or not\n\n.. code-block:: python\n\n indiapins.isvalid('110011')\n\n True\n\n3. District by Pincode\n######################\n\nIt extracts the district of given Indian pincode\n\n.. code-block:: python\n\n indiapins.districtmatch('302005')\n\n 'Jaipur'\n\n4. Coordinates of Pincode\n#########################\n\nIt extracts all the coordinates of given Indian pincode\n\n.. code-block:: python\n\n indiapins.coordinates('110011')\n\n {'Udyog Bhawan': {'latitude': '28.6111111', 'longitude': '77.2127500'},\n 'Nirman Bhawan': {'latitude': '28.6108611', 'longitude': '77.2148611'}}\n\n\n=======\nHistory\n=======\n1.0.4 (2025-01-26)\n------------------\n\n* Added new pins\n\n1.0.1 (2024-08-10)\n------------------\n\n* Added latest libs\n\n1.0.1 (2023-09-12)\n------------------\n\n* Fix pins import error\n\n0.1.7 (2023-09-11)\n------------------\n\n* Update Pincode data to latest (Sept 2023)\n* Added coordinates info with pins\n* Fetch longitude and latitude of any pin\n* Update security vulnerabilities\n\n0.1.0 (2021-07-27)\n------------------\n\n* Match location with the pins\n* Mark pin is valid or not\n* Extract cities on basis of pins\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "Python package for mapping pins to the place where it belong",
"version": "1.0.4",
"project_urls": {
"Homepage": "https://github.com/pawangeek/indiapins"
},
"split_keywords": [
"indiapins",
"india",
"pincodes",
"zipcodes"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "82a2c3694661c671bec63e267c8f39a69aa2b957db283d50a25eb2c1da0e8e50",
"md5": "1771bd198ae5d9767d6c8103046bb882",
"sha256": "638c19f8205e6ce63b3e687d747bd773f3ae347fabf086453527c87b0216e67f"
},
"downloads": -1,
"filename": "indiapins-1.0.4-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "1771bd198ae5d9767d6c8103046bb882",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.9",
"size": 2257271,
"upload_time": "2025-01-26T08:50:50",
"upload_time_iso_8601": "2025-01-26T08:50:50.506518Z",
"url": "https://files.pythonhosted.org/packages/82/a2/c3694661c671bec63e267c8f39a69aa2b957db283d50a25eb2c1da0e8e50/indiapins-1.0.4-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3a50ac08e3a7d08b162ea28e73939b7272531d7a52f8cdad1aabee8b8681e7ed",
"md5": "e09f8e80db17b59d2c3092ee44e30d9e",
"sha256": "016e885ea6f72ef7f5bf3709baae2a05dd0ed30add8d1752bbda1c1d3bab9230"
},
"downloads": -1,
"filename": "indiapins-1.0.4.tar.gz",
"has_sig": false,
"md5_digest": "e09f8e80db17b59d2c3092ee44e30d9e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 2261830,
"upload_time": "2025-01-26T08:50:53",
"upload_time_iso_8601": "2025-01-26T08:50:53.182556Z",
"url": "https://files.pythonhosted.org/packages/3a/50/ac08e3a7d08b162ea28e73939b7272531d7a52f8cdad1aabee8b8681e7ed/indiapins-1.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-26 08:50:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pawangeek",
"github_project": "indiapins",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"appveyor": true,
"tox": true,
"lcname": "indiapins"
}
JSON
