8000 Update README for 2023 · stub42/pytz@78dd05a · GitHub
[go: up one dir, main page]

Skip to content

Commit 78dd05a

Browse files
committed
Update README for 2023
Closes #101
1 parent cadd6a9 commit 78dd05a

File tree

1 file changed

+18
-7
lines changed

1 file changed

+18
-7
lines changed

src/README.rst

Lines changed: 18 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,14 @@ Library Reference (``datetime.tzinfo``).
1414

1515
Almost all of the Olson timezones are supported.
1616

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

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

549-
git clone https://git.launchpad.net/pytz
550-
551-
A mirror on github is also available at https://github.com/stub42/pytz
557+
git clone https://github.com/stub42/pytz.git
552558

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

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

564572

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

582+
- This project is in maintenance mode. Projects using Python 3.9 or later
583+
are best served by using the timezone functionaly now included in core
584+
Python and packages that work with it such as `tzdata <https://pypi.org/project/tzdata/>`_.
585+
574586
- Offsets from UTC are rounded to the nearest whole minute, so timezones
575587
such as Europe/Amsterdam pre 1937 will be up to 30 seconds out. This
576-
is a limitation of the Python datetime library.
588+
was a limitation of the Python datetime library.
577589

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

595607
Stuart Bishop <stuart@stuartbishop.net>
596608

597-

0 commit comments

Comments
 (0)
0