=========
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
.. image:: https://pyup.io/repos/github/pawangeek/indiapins/shield.svg
:target: https://pyup.io/repos/github/pawangeek/indiapins/
:alt: Updates
**Indiapins is a Python package for getting the places tagged to particular Indian pincode**
* 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 Python 3.8, 3.9, 3.10, 3.11 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.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": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "indiapins india pincodes zipcodes",
"author": "Pawan Kumar Jain",
"author_email": "pawanjain.432@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/7a/5f/ce9771923e2fc06430587218d8002f92749364684637348476ea5db9362f/indiapins-1.0.1.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.. image:: https://pyup.io/repos/github/pawangeek/indiapins/shield.svg\n :target: https://pyup.io/repos/github/pawangeek/indiapins/\n :alt: Updates\n\n\n**Indiapins is a Python package for getting the places tagged to particular Indian pincode**\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 Python 3.8, 3.9, 3.10, 3.11 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=======\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.1",
"project_urls": {
"Homepage": "https://github.com/pawangeek/indiapins"
},
"split_keywords": [
"indiapins",
"india",
"pincodes",
"zipcodes"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "40a67a19b7757dc551d1b9de61cc8c45292763ef954d797f34316995fd110964",
"md5": "0af1a3cbafcfb6e9b7d8791f679018b0",
"sha256": "f90e747870c93ed9ac70c39f2f0e1999789f9f4869be6b4bfbe3b23d1ef7d45e"
},
"downloads": -1,
"filename": "indiapins-1.0.1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "0af1a3cbafcfb6e9b7d8791f679018b0",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.8",
"size": 2254009,
"upload_time": "2023-09-12T11:04:07",
"upload_time_iso_8601": "2023-09-12T11:04:07.518354Z",
"url": "https://files.pythonhosted.org/packages/40/a6/7a19b7757dc551d1b9de61cc8c45292763ef954d797f34316995fd110964/indiapins-1.0.1-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7a5fce9771923e2fc06430587218d8002f92749364684637348476ea5db9362f",
"md5": "c87ecf60b91f45bed43604152e473840",
"sha256": "b6dcd952b3f9aee6e7ead16d8f1ff7d974fef9f4b46b82f837c2706060a6eebc"
},
"downloads": -1,
"filename": "indiapins-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "c87ecf60b91f45bed43604152e473840",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 2258223,
"upload_time": "2023-09-12T11:04:09",
"upload_time_iso_8601": "2023-09-12T11:04:09.902705Z",
"url": "https://files.pythonhosted.org/packages/7a/5f/ce9771923e2fc06430587218d8002f92749364684637348476ea5db9362f/indiapins-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-12 11:04:09",
"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
