Pytzdata
########

.. image:: https://travis-ci.org/sdispater/pytzdata.png
   :alt: Pytzdata Build status
   :target: https://travis-ci.org/sdispater/pytzdata

The Olson timezone database for Python.

Supports Python **2.7+** and **3.5+**.


Installation
============

    pip install pytzdata


Usage
=====

You can access the content of a specific timezone file by using the `tz_file()` function:

.. code-block:: python

    from pytzdata import tz_file

    with tz_file('Europe/Paris') as f:
        # Do something with the file

If you just want to know the path to a specific timezone file, you may use the `tz_path()` function:

.. code-block:: python

    from pytzdata import tz_path

    tz_path('Europe/Paris')

By default, ``pytzdata`` will use the bundled timezone database, however you can set
a custom directory that holds the timezone files using the ``set_directory`` function:

.. code-block:: python

    import pytzdata

    pytzdata.set_directory('/custom/zoneinfo')

You can also set the ``PYTZDATA_TZDATADIR`` environment variable to set a custom directory.


Release
=======

To make a new release just follow these steps:

- ``make data``
- Update version numbers in ``pytzdata/version.py`` and ``tests/test_version.py``
- ``make tox``


Resources
=========

* `Issue Tracker <https://github.com/sdispater/pytzdata/issues>`_