Skip to content

Commit

Permalink
Update README for 2023
Browse files Browse the repository at this point in the history
Closes #101
  • Loading branch information
stub42 committed Mar 29, 2023
1 parent cadd6a9 commit 78dd05a
Showing 1 changed file with 18 additions and 7 deletions.
25 changes: 18 additions & 7 deletions src/README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,14 @@ Library Reference (``datetime.tzinfo``).

Almost all of the Olson timezones are supported.

.. note::

Projects using Python 3.9 or later should be using the support
now included as part of the standard library, and third party
packages work with it such as `tzdata <https://pypi.org/project/tzdata/>`_.
pytz offers no advantages beyond backwards compatibility with
code written for earlier versions of Python.

.. note::

This library differs from the documented Python API for
Expand Down Expand Up @@ -543,12 +551,10 @@ Latest Versions
This package will be updated after releases of the Olson timezone
database. The latest version can be downloaded from the `Python Package
Index <https://pypi.org/project/pytz/>`_. The code that is used
to generate this distribution is hosted on launchpad.net and available
to generate this distribution is hosted on Github and available
using git::

git clone https://git.launchpad.net/pytz

A mirror on github is also available at https://github.com/stub42/pytz
git clone https://github.com/stub42/pytz.git

Announcements of new releases are made on
`Launchpad <https://launchpad.net/pytz>`_, and the
Expand All @@ -559,7 +565,9 @@ hosted there.
Bugs, Feature Requests & Patches
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Bugs can be reported using `Launchpad Bugs <https://bugs.launchpad.net/pytz>`_.
Bugs should be reported on `Github <https://github.com/stub42/pytz/issues>`_.
Feature requests are unlikely to be considered, and efforts instead directed
to timezone support now built into Python or packages that work with it.


Security Issues
Expand All @@ -571,9 +579,13 @@ Reports about security issues can be made via `Tidelift <https://tidelift.com/se
Issues & Limitations
~~~~~~~~~~~~~~~~~~~~

- This project is in maintenance mode. Projects using Python 3.9 or later
are best served by using the timezone functionaly now included in core
Python and packages that work with it such as `tzdata <https://pypi.org/project/tzdata/>`_.

- Offsets from UTC are rounded to the nearest whole minute, so timezones
such as Europe/Amsterdam pre 1937 will be up to 30 seconds out. This
is a limitation of the Python datetime library.
was a limitation of the Python datetime library.

- If you think a timezone definition is incorrect, I probably can't fix
it. pytz is a direct translation of the Olson timezone database, and
Expand All @@ -594,4 +606,3 @@ Contact

Stuart Bishop <stuart@stuartbishop.net>


0 comments on commit 78dd05a

Please sign in to comment.