indian-states 1.0

India's states and cities

India package

Version 1.0

Installation

Installation Using pip

pip install indian-states

Running Tests

python -m unittest discover -s tests

Usage

This repository makes it easy to access metadata of states and union territories of India.

>>> import india
>>> india.states.AR
OUT: <State: Arunachal Pradesh>

You can also lookup whether your input is state or not.

>>> import india
>>> india.states.lookup('arunachal pradesh')
OUT: <State: Arunachal Pradesh>

New release enables you to access districts/cities across india with several attributes

>>> import india
>>> india.cities.KA_BLR
OUT: <City: Bangalore>

New release enables you to track post offices based on pincode

>>> from india import pincodes
>>> pincodes.lookup('691522')
OUT: ['Panthaplavu B.O', 'Pattazhy S.O', 'Thekketheri B.O']

Lookup for cities

>>> import india
>>> india.cities.lookup('Bangalore')
OUT: <City: Bangalore>

Check whether the city is capital

>>> import india
>>> india.cities.lookup('Bangalore').iscapital()
OUT: True

Attributes

Attributes of state object

state.name       # name of the state
state.capital    # returns the capital of that state
state.population # returns the population of the state
state.area       # returns the area of state in km^2
state.density    # returns population density per km^2 of state
state.language   # primary official language of the state

Attributes of Cities object

city.name       # name of the city
city.state      # returns the state of city
city.population # returns the population of the city
city.area       # returns the area of the district
city.density    # returns population density per km^2 of the city
city.url        # returns official webpage of the city

Release Notes

Added option to list all post offices under given pincode