Metadata-Version: 2.1
Name: zipcodes-in
Version: 0.1.0
Summary: Indian Zip Codes
Home-page: https://github.com/arpitfalcon/zipcodes-in
Author: Arpit
Author-email: arpitfalcon1@gmail.com
License: UNKNOWN
Keywords: zipcode zip code india in state validate filter find query
Platform: UNKNOWN
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

# zipcodes-in
<img width="811" alt="zipcode" align="middle" src="https://user-images.githubusercontent.com/44089458/127119397-8ce57b68-d03c-4d2e-b0a2-a4a19ab58309.png">

## ✍ Description of the project 

Zipcodes-in is a Python library built for querying India zipcodes, post offices and particular state/UT.

## 📊 Data description and preparation 
- Data was extracted from [here](https://github.com/Zeeshanahmad4/Zip-code-of-all-countries-cities-in-the-world-CSV-TXT-SQL-DATABASE)
- Cleaned the data and extracted all the values for India (IN). Script can be found [here](https://github.com/ArpitFalcon/zipcodes-in/tree/main/make_data/extract%20data)
- Finally, the data was converted from CSV to JSON. The data can be found [here](https://github.com/ArpitFalcon/zipcodes-in/tree/main/make_data)

## 📍 Functionalities
- Query if a zipcode matches or not  
- List random zipcodes 
- Validate of a zipcode exists or not
- List top N zipcodes
- List any random N zipcodes 
- List all the zipcodes in the dataset (absolutely NOT recommended!)

## 💻 Installation 
```python
# Install the package 
>>> pip install . 
```

## 👩‍💻 Running Scripts
```python

# 

NOTE: Version 1.0 is tested on Windows10. 
## If you face any issue while running, please raise an issue on this repository
```

⚠️ The zipcode data was last updated on: **Jul. 27th, 2021** ⚠️

## Looking forward to make the project better? 🤔
We are open to suggestions and ideas! Feel free to raise an issue and we shall get back to you super soon! 

## 📑 LISENCE 
[MIT LICENSE](https://github.com/ArpitFalcon/zipcodes-in/blob/main/LICENSE)


