Metadata-Version: 2.1
Name: ziptimezone
Version: 1.0.4
Summary: A package to convert ZIP codes to time zones and get geographic coordinates.
License: MIT
Author: Manjunath Bettadapura
Author-email: manjunathbettadapura412@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: pandas (>=1.3.3,<=2.2.2)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Requires-Dist: timezonefinder (>=6.1.5,<=6.5.0)
Description-Content-Type: text/x-rst

==============
timezonefinder
==============


..
    Note: can't include the badges file from the docs here, as it won't render on PyPI -> sync manually

.. image:: https://readthedocs.org/projects/ziptimezone/badge/?version=latest
    :alt: documentation status
    :target: https://ziptimezone.readthedocs.io/en/latest/?badge=latest

.. image:: https://img.shields.io/pypi/wheel/ziptimezone.svg
    :target: https://pypi.python.org/pypi/ziptimezone

.. image:: https://pepy.tech/badge/ziptimezone
    :alt: total PyPI downloads
    :target: https://pepy.tech/project/ziptimezone

.. image:: https://img.shields.io/pypi/v/ziptimezone.svg
    :alt: latest version on PyPI
    :target: https://pypi.python.org/pypi/ziptimezone

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black


This is a python package with US Zip Code convenience functions such as those listed in the examples below. 
It uses the geonames data, coupled with the timezonefinder package. It uses a mapping of the popular 
timezone regions in US, and returns the outputs accordingly.   


Quick Guide:

.. code-block:: console

    pip install ziptimezone


.. code-block:: python

    import ziptimezone as zpt

    # returns a tuple (42.377, -71.1256)
    zpt.get_lat_long_for_zip('02138')

    # returns 'Eastern' the timezone has been reduced to the more popular zones 
    # for United States Regions
    zpt.get_timezone_by_zip('02138') 

    # returns a dictionary, {'02138': 'Eastern', '85260': 'Mountain'}
    zpt.get_timezone_for_many_zips(['02138', '85260']) 


For more refer to the `Documentation <https://ziptimezone.readthedocs.io/en/latest/>`__.

Also check:

`PyPI <https://pypi.python.org/pypi/ziptimezone/>`__

