Adds the timezones attribute to expose available timezones

Author: sdispater

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Change Log
 
+## [Unreleased]
+
+### Added
+
+- Added a `timezones` module attribute to expose available timezones.
+
+
 ## [1.2.5] - 2017-09-04
 
 ### Fixed
@@ -394,7 +401,7 @@ Initial release
 
 
 
-[Unreleased]: https://github.com/sdispater/pendulum/compare/1.2.5...master
+[Unreleased]: https://github.com/sdispater/pendulum/compare/master...develop
 [1.2.5]: https://github.com/sdispater/pendulum/releases/tag/1.2.5
 [1.2.4]: https://github.com/sdispater/pendulum/releases/tag/1.2.4
 [1.2.3]: https://github.com/sdispater/pendulum/releases/tag/1.2.3

docs/_docs/instantiation.rst

@@ -24,6 +24,26 @@ and the timezone will be created for you.
     Supported strings for timezones are the one provided by the `IANA time zone database <https://www.iana.org/time-zones>`_.
     The special ``local`` string is also supported and will return your current timezone.
 
+    As of release 1.3.0, available timezones are exposed via the ``timezones`` attribute.
+
+    .. code-block:: python
+
+        import pendulum
+
+        pendulum.timezones
+        ('CET',
+         'CST6CDT',
+         'Cuba',
+         'EET',
+         'Egypt',
+         'Eire',
+         ...,
+         'US/Michigan',
+         'US/Mountain',
+         'US/Pacific',
+         'US/Pacific-New',
+         'US/Samoa')
+
 This is again shown in the next example which also introduces the ``now()`` function.
 
 .. code-block:: python

pendulum/__init__.py

@@ -77,4 +77,4 @@
 period = Period
 
 # Timezones
-from .tz import timezone, local_timezone, UTC
+from .tz import timezone, timezones, local_timezone, UTC

pendulum/tz/__init__.py

@@ -1,9 +1,14 @@
 # -*- coding: utf-8 -*-
 
+import pytzdata
+
 from .timezone import Timezone, FixedTimezone, UTC
 from .local_timezone import LocalTimezone
 
 
+timezones = pytzdata.timezones
+
+
 def timezone(name):
     """
     Loads a Timezone instance by name.

requirements.txt

@@ -1,3 +1,3 @@
 tzlocal
 python-dateutil
-pytzdata
+pytzdata>=2017.2.2

tests/tz_tests/test_timezones.py

@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+
+import pendulum
+
+
+def test_timezones():
+    zones = pendulum.timezones
+
+    assert 'America/Argentina/Buenos_Aires' in zones
+
+
+def test_timezones_are_loadable():
+    zones = pendulum.timezones
+
+    for zone in zones:
+        pendulum.timezone(zone)