Initial commit

env/lib/python3.10/site-packages/l18n-2021.3.dist-info/INSTALLER

@@ -0,0 +1 @@
+pip

env/lib/python3.10/site-packages/l18n-2021.3.dist-info/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014-2021 Thomas Khyn and contributors (see CONTRIBUTORS.rst)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

env/lib/python3.10/site-packages/l18n-2021.3.dist-info/METADATA

@@ -0,0 +1,233 @@
+Metadata-Version: 2.1
+Name: l18n
+Version: 2021.3
+Summary: Internationalization for pytz timezones and territories
+Home-page: https://github.com/tkhyn/l18n
+Author: Thomas Khyn
+Author-email: thomas@ksytek.com
+License: UNKNOWN
+Keywords: pytz,translation,i18n
+Platform: UNKNOWN
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Environment :: Other Environment
+Classifier: Topic :: Software Development :: Internationalization
+Requires-Dist: pytz (>=2020.1)
+Requires-Dist: six
+
+l18n
+====
+
+|copyright| 2014-2021 Thomas Khyn
+
+Locale internationalization package. Translations for places, timezones ...
+
+Tested with the latest minor versions of Python 2 and 3.
+
+Supported languages: English, French, German, Czech, Chinese
+(`want to add yours?`_)
+
+
+What is l18n?
+-------------
+
+As you may have noticed, ``l18n`` is a contraction of ``i18n`` and ``l10n``,
+namely 'internationalisation' and 'localization'. It basically provides
+lazy translations for names used for localization purposes (e.g. places and
+timezones).
+
+I started writing ``l18n`` when I was looking for translations for the pytz_
+library. Indeed, on a multi-lingual site where users can select the timezone
+they are in, it's much better if they can select in their language, as in some
+cases, the differences with the english name can be significant, hence the
+place to look for it when it's sorted in alphabetical order.
+
+And as I am lazy, I thought of a way to - almost - automatically fetch the
+translations from the CLDR_ (Unicode's Common Locale Data Repository) database.
+
+Integrating function to link timezone to country codes, there was no reason not
+to try and provide translations also for the latter. In the near future, I -
+or contributors - may also add currencies or measurement units fetched from
+the CLDR database ...
+
+
+How does it work?
+-----------------
+
+To use ``l18n``, you first need to install it. It works well with ``pip``::
+
+   pip install l18n
+
+Then, in your code::
+
+   >>> import l18n
+
+``l18n`` exposes several read-only dictionary-like objects:
+
+l18n.tz_cities
+
+   is a mapping between all the timezones listed in ``pytz.all_timezones``
+   and human-friendly **lazy** versions of the translated name of the city
+   in the current language (see `Selecting the language`_ below). For example,
+   if the language is English::
+
+      >>> l18n.tz_cities['Pacific/Easter']
+      L18NLazyString <Easter Island>
+      >>> str(l18n.tz_cities['Pacific/Easter'])
+      'Easter Island'
+
+   In French, it would give::
+
+      >>> str(l18n.tz_cities['Pacific/Easter'])
+      'Île de Pâques'
+
+l18n.tz_fullnames
+
+   is a mapping between all the timezones listed in ``pytz.all_timezones``
+   and **lazy** versions of the timezones' full names in the current language.
+   For example::
+
+      >>> str(l18n.tz_fullnames['Pacific/Easter'])
+      'Pacific/Easter Island'  # or 'Pacifique/Île de Pâques' in French
+
+   It is interesting to note that for 3-components timezone names where the
+   local state or territory appears in the city name, ``l18n`` cleverly strips
+   this information so that it is not repeated::
+
+      >>> str(l18n.tz_fullnames['America/North_Dakota/New_Salem'])
+      'America/North Dakota/New Salem'
+
+   indeed::
+
+      >>> str(l18n.tz_cities['America/North_Dakota/New_salem'])
+      'New Salem, North Dakota'
+
+l18n.territories
+
+   is a mapping between the territory codes as defined in the CLDR_ and their
+   localized names, lazily defined. For example::
+
+      >>> str(l18n.territories['CZ'])
+      'Czech Republic'  # or 'République Tchèque' in French
+
+
+.. note::
+
+   The values are translated each time they are evaluated, there is no caching.
+   This means that the same L18NLazyString / L18NLazyStringsList instance can
+   be used and produce 2 different outputs if you change the language between
+   the evaluations.
+
+
+.. note::
+
+   The values in the above mentionned dictionaries can be overriden by your
+   own translations. The dictionaries are not read-only and values can be
+   added or removed at your convenience.
+
+
+Lazy mappings special features (v.2016.6.3 onwards)
+---------------------------------------------------
+
+The fore-mentioned ``tz_cities``, ``tz_fullnames`` and ``territories`` are not
+simple dictionaries and provide additional features.
+
+Sorting
+.......
+
+When iterating over an ``L18NMap``, the items, keys or values are *yielded* in
+alphabetical order **in the currently selected language**. For performance, the
+results are cached by language, so the sort is only performed once per language.
+Note that the values are still lazy objects that are evaluated only when
+rendered into a string.
+
+Subsets
+.......
+
+It is possible to generate a new ``L18NMap`` from an existing one by using the
+``subset`` method and passing an iterable of ``keys`` that need to be kept in
+the new mapping. Any cached sort is also used to generate the new cache, so
+that there is nothing to re-calculate in the new subset.
+
+For example, one can generate a map of translations for
+``pytz.common_timezones``::
+
+   >>> common_cities = l18n.tz_cities.subset(pytz.common_timezones.keys())
+
+
+Selecting the language
+----------------------
+
+By default, when importing ``l18n``, the current default locale is used (via
+``locale.getdefaultlocale()``). If it is not the one you want or if you need to
+change it, it is rather easy::
+
+   >>> l18n.set_language('en')
+   >>> str(l18n.tz_cities['Pacific/Easter'])
+   'Easter Island'
+   >>> l18n.set_language('fr')
+   >>> str(l18n.tz_cities['Pacific/Easter'])
+   'Île de Pâques'
+
+And in case you want to disable translation and use raw default strings::
+
+   >>> l18n.set_language(None)
+
+
+Utilities
+---------
+
+``l18n`` also exposes a few functions that may be helpful in some cases:
+
+``l18n.utils.get_country_tzs(country_code)``
+
+   returns a list of locations for the given country code, sorted in
+   alphabetical order in the currently selected language
+
+``l18n.utils.get_country_code_from_tz(timezone)``
+
+   returns the country code from a given (untranslated) timezone
+
+
+Versionning
+-----------
+
+``l18n``'s main version number matches ``pytz``'s version number. ``l18n``
+2014.10.X will be fully compatible with ``pytz`` 2014.10 whatever the value of
+X. Indeed, the primary aim is to keep ``l18n``'s translation files consistent
+with ``pytz``'s timezone names.
+
+Before ``l18n`` 2016.6, the ``pytz`` version was pinned against the ``l18n``
+version. Now, ``l18n`` YEAR.MONTH can now be used with any subsequent ``pytz``
+version. However, note that there may be missing translations if the 2 versions
+are too different from each other. In that case, open an issue_ to request a
+new version of ``l18n`` to be published.
+
+
+.. _`want to add yours?`:
+
+Want to add a language?
+-----------------------
+
+Great idea !! Have a look at CONTRIBUTE.rst_.
+
+
+Roadmap
+-------
+
+- Add supported languages
+- Add currencies and other stuff
+
+
+.. |copyright| unicode:: 0xA9
+
+.. _pytz: https://pypi.python.org/pypi/pytz/
+.. _CLDR: http://cldr.unicode.org/
+.. _CONTRIBUTE.rst: https://github.com/tkhyn/l18n/src/tip/CONTRIBUTE.rst
+.. _issue: https://github.com/tkhyn/l18n/issues/new
+
+

env/lib/python3.10/site-packages/l18n-2021.3.dist-info/RECORD

@@ -0,0 +1,25 @@
+l18n-2021.3.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+l18n-2021.3.dist-info/LICENSE.txt,sha256=qKHxd3rxcItt4Gw9rH0O0oVRZ7u8pfGa6_QmrB-HMgo,1144
+l18n-2021.3.dist-info/METADATA,sha256=3rysukW3TumvXLXSHcqLbVAkkqH7CsZx9lcuWjhHUjk,7347
+l18n-2021.3.dist-info/RECORD,,
+l18n-2021.3.dist-info/WHEEL,sha256=D1Wh14kWDxPnrM-5t_6UCB-UuQNrEODtRa3vF4OsvQY,97
+l18n-2021.3.dist-info/top_level.txt,sha256=Sxl5S4Z0ZATIv0NwwmHeshmETOQ-JA3cjrixZz-HZpQ,5
+l18n/__init__.py,sha256=8Yy3-HiR1TDoGxs-QZClbWRVNZw75bFOzTjK2lVgb6c,149
+l18n/__maps.py,sha256=2fdd8gRwnOJIM193yEDfEm_w3u5oASWUR7Z3awt5qGU,29231
+l18n/__pycache__/__init__.cpython-310.pyc,,
+l18n/__pycache__/__maps.cpython-310.pyc,,
+l18n/__pycache__/compat.cpython-310.pyc,,
+l18n/__pycache__/maps.cpython-310.pyc,,
+l18n/__pycache__/translation.cpython-310.pyc,,
+l18n/__pycache__/utils.cpython-310.pyc,,
+l18n/__pycache__/version.cpython-310.pyc,,
+l18n/compat.py,sha256=JUDhsa46k4xsT-me5moqxeIBp7eEQP5v3CrLzPGmmE4,151
+l18n/locale/cs/LC_MESSAGES/l18n.mo,sha256=Tp6Vjaau3ift0aEeMNDkBu2Y7JYcrzNehMqlSposdqg,15995
+l18n/locale/de/LC_MESSAGES/l18n.mo,sha256=URkg_7ogktpd6hS3164swDAgyfFLrQ0EFOa1gqjnEWc,12287
+l18n/locale/en/LC_MESSAGES/l18n.mo,sha256=E_QP8TXJ3dHs9if6KuOyQHWUNKR0psir1Drtt3-FRWs,673
+l18n/locale/fr/LC_MESSAGES/l18n.mo,sha256=Zg0-wlAYZeP_BqkI_YtbMnmV4Rwj1-XzkOqGCRLvFMo,15784
+l18n/locale/zh/LC_MESSAGES/l18n.mo,sha256=GVe1PBXHbxvmJQPI4kQM7NclOlNaTEjiNG2vjfizcpw,28197
+l18n/maps.py,sha256=bUcYLUCYB0I3t7C2J7pJyVpT-rFgT3ofInfWvv1Mwg0,670
+l18n/translation.py,sha256=KR1Z55tUZsf1GLy4ZhXiL1G5lanMV59U1U1EvDU1WSE,7808
+l18n/utils.py,sha256=B-YVLQcJ9iMGx5tbPaxxqXDAGGNADlJw6gvErO7cTdE,711
+l18n/version.py,sha256=ZFnuqrKYKoPEnisRKWg2zlrR730rkBlUxVjPattmk9U,916

env/lib/python3.10/site-packages/l18n-2021.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.35.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

env/lib/python3.10/site-packages/l18n-2021.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+l18n