diff options
Diffstat (limited to '.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info')
6 files changed, 287 insertions, 0 deletions
diff --git a/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/INSTALLER b/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/INSTALLER new file mode 100644 index 00000000..a1b589e3 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/LICENSE.txt b/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/LICENSE.txt new file mode 100644 index 00000000..9be1d2fe --- /dev/null +++ b/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/LICENSE.txt @@ -0,0 +1,19 @@ +Copyright 2011-2017 Lennart Regebro + +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. diff --git a/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/METADATA b/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/METADATA new file mode 100644 index 00000000..91d4a492 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/METADATA @@ -0,0 +1,244 @@ +Metadata-Version: 2.1 +Name: tzlocal +Version: 5.3.1 +Summary: tzinfo object for the local timezone +Author-email: Lennart Regebro <regebro@gmail.com> +License: MIT +Project-URL: Source code, https://github.com/regebro/tzlocal +Project-URL: Changelog, https://github.com/regebro/tzlocal/blob/master/CHANGES.txt +Project-URL: Issue tracker, https://github.com/regebro/tzlocal/issues +Keywords: timezone +Classifier: Development Status :: 5 - Production/Stable +Classifier: License :: OSI Approved :: MIT License +Classifier: Operating System :: Microsoft :: Windows +Classifier: Operating System :: Unix +Classifier: Operating System :: MacOS :: MacOS X +Classifier: Typing :: Typed +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Requires-Python: >=3.9 +Description-Content-Type: text/x-rst +License-File: LICENSE.txt +Requires-Dist: tzdata ; platform_system == "Windows" +Provides-Extra: devenv +Requires-Dist: pytest (>=4.3) ; extra == 'devenv' +Requires-Dist: pytest-mock (>=3.3) ; extra == 'devenv' +Requires-Dist: pytest-cov ; extra == 'devenv' +Requires-Dist: check-manifest ; extra == 'devenv' +Requires-Dist: zest.releaser ; extra == 'devenv' + +tzlocal +======= + +API CHANGE! +----------- + +With version 3.0 of tzlocal, tzlocal no longer returned `pytz` objects, but +`zoneinfo` objects, which has a different API. Since 4.0, it now restored +partial compatibility for `pytz` users through Paul Ganssle's +`pytz_deprecation_shim`. + +tzlocal 4.0 also adds an official function `get_localzone_name()` to get only +the timezone name, instead of a timezone object. On unix, it can raise an +error if you don't have a timezone name configured, where `get_localzone()` +will succeed, so only use that if you need the timezone name. + +4.0 also adds way more information on what is going wrong in your +configuration when the configuration files are unclear or contradictory. + +Version 5.0 removes the `pytz_deprecation_shim`, and now only returns +`zoneinfo` objects, like verion 3.0 did. If you need `pytz` objects, you have +to stay on version 4.0. If there are bugs in version 4.0, I will release +updates, but there will be no further functional changes on the 4.x branch. + + +Info +---- + +This Python module returns the `IANA time zone name +<https://www.iana.org/time-zones>`_ for your local time zone or a ``tzinfo`` +object with the local timezone information, under Unix and Windows. + +This module attempts to fix a glaring hole in the ``pytz`` and ``zoneinfo`` +modules, that there is no way to get the local timezone information, unless +you know the zoneinfo name, and under several Linux distros that's hard or +impossible to figure out. + +With ``tzlocal`` you only need to call ``get_localzone()`` and you will get a +``tzinfo`` object with the local time zone info. On some Unices you will +still not get to know what the timezone name is, but you don't need that when +you have the tzinfo file. However, if the timezone name is readily available +it will be used. + +What it's not for +----------------- + +It's not for converting the current time between UTC and your local time. There are +other, simpler ways of doing this. This is if you need to know things like the name +of the time zone, or if you need to be able to convert between your time zone and +another time zone for times that are in the future or in the past. + +For current time conversions to and from UTC, look in the Python ``time`` module. + + +Supported systems +----------------- + +These are the systems that are in theory supported: + + * Windows 2000 and later + + * Any unix-like system with a ``/etc/localtime`` or ``/usr/local/etc/localtime`` + +If you have one of the above systems and it does not work, it's a bug. +Please report it. + +Please note that if you are getting a time zone called ``local``, this is not +a bug, it's actually the main feature of ``tzlocal``, that even if your +system does NOT have a configuration file with the zoneinfo name of your time +zone, it will still work. + +You can also use ``tzlocal`` to get the name of your local timezone, but only +if your system is configured to make that possible. ``tzlocal`` looks for the +timezone name in ``/etc/timezone``, ``/var/db/zoneinfo``, +``/etc/sysconfig/clock`` and ``/etc/conf.d/clock``. If your +``/etc/localtime`` is a symlink it can also extract the name from that +symlink. + +If you need the name of your local time zone, then please make sure your +system is properly configured to allow that. + +If your unix system doesn't have a timezone configured, tzlocal will default +to UTC. + +Notes on Docker +--------------- + +It turns out that Docker images frequently have broken timezone setups. +This usually results in a warning that the configuration is wrong, or that +the timezone offset doesn't match the found timezone. + +The easiest way to fix that is to set a TZ variable in your docker setup +to whatever timezone you want, which is usually the timezone your host +computer has. + +Usage +----- + +Load the local timezone: + + >>> from tzlocal import get_localzone + >>> tz = get_localzone() + >>> tz + zoneinfo.ZoneInfo(key='Europe/Warsaw') + +Create a local datetime: + + >>> from datetime import datetime + >>> dt = datetime(2015, 4, 10, 7, 22, tzinfo=tz) + >>> dt + datetime.datetime(2015, 4, 10, 7, 22, tzinfo=zoneinfo.ZoneInfo(key='Europe/Warsaw')) + +Lookup another timezone with ``zoneinfo``: + + >>> from zoneinfo import ZoneInfo + >>> eastern = ZoneInfo('US/Eastern') + +Convert the datetime: + + >>> dt.astimezone(eastern) + datetime.datetime(2015, 4, 10, 1, 22, tzinfo=zoneinfo.ZoneInfo(key='US/Eastern')) + +If you just want the name of the local timezone, use `get_localzone_name()`: + + >>> from tzlocal import get_localzone_name + >>> get_localzone_name() + "Europe/Warsaw" + +Please note that under Unix, `get_localzone_name()` may fail if there is no zone +configured, where `get_localzone()` would generally succeed. + +Troubleshooting +--------------- + +If you don't get the result you expect, try running it with debugging turned on. +Start a python interpreter that has tzlocal installed, and run the following code:: + + import logging + logging.basicConfig(level="DEBUG") + import tzlocal + tzlocal.get_localzone() + +The output should look something like this, and this will tell you what +configurations were found:: + + DEBUG:root:/etc/timezone found, contents: + Europe/Warsaw + + DEBUG:root:/etc/localtime found + DEBUG:root:2 found: + {'/etc/timezone': 'Europe/Warsaw', '/etc/localtime is a symlink to': 'Europe/Warsaw'} + zoneinfo.ZoneInfo(key='Europe/Warsaw') + + +Development +----------- + +For ease of development, there is a Makefile that will help you with basic tasks, +like creating a development environment with all the necessary tools (although +you need a supported Python version installed first):: + + $ make devenv + +To run tests:: + + $ make test + +Check the syntax:: + + $ make check + + +Maintainer +---------- + +* Lennart Regebro, regebro@gmail.com + +Contributors +------------ + +* Marc Van Olmen +* Benjamen Meyer +* Manuel Ebert +* Xiaokun Zhu +* Cameris +* Edward Betts +* McK KIM +* Cris Ewing +* Ayala Shachar +* Lev Maximov +* Jakub Wilk +* John Quarles +* Preston Landers +* Victor Torres +* Jean Jordaan +* Zackary Welch +* Mickaël Schoentgen +* Gabriel Corona +* Alex Grönholm +* Julin S +* Miroslav Šedivý +* revansSZ +* Sam Treweek +* Peter Di Pasquale +* Rongrong + +(Sorry if I forgot someone) + +License +------- + +* MIT https://opensource.org/licenses/MIT diff --git a/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/RECORD b/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/RECORD new file mode 100644 index 00000000..f01fc60a --- /dev/null +++ b/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/RECORD @@ -0,0 +1,17 @@ +tzlocal-5.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +tzlocal-5.3.1.dist-info/LICENSE.txt,sha256=2ZqyCa6xaq0sJckP_YPBqYHikP__dqQgoqsD4D8EG4w,1060 +tzlocal-5.3.1.dist-info/METADATA,sha256=9fSrmurX5XWWl7z9_oEtOliS9NPLr90xlDjTv8kZWeQ,7589 +tzlocal-5.3.1.dist-info/RECORD,, +tzlocal-5.3.1.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92 +tzlocal-5.3.1.dist-info/top_level.txt,sha256=QR6vZWP520waETnkotApPQPyVh9VnjoYPoAVHLK1DrE,8 +tzlocal/__init__.py,sha256=2OQDx61TZv_HmBl7JKKP4ATldlx5OdEXOjKXAt8rQwY,396 +tzlocal/__pycache__/__init__.cpython-312.pyc,, +tzlocal/__pycache__/unix.cpython-312.pyc,, +tzlocal/__pycache__/utils.cpython-312.pyc,, +tzlocal/__pycache__/win32.cpython-312.pyc,, +tzlocal/__pycache__/windows_tz.cpython-312.pyc,, +tzlocal/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +tzlocal/unix.py,sha256=SyD32zfJn3r7xDJwo4sTYebhQ25XZIssvz24Nd-9tR8,9097 +tzlocal/utils.py,sha256=ov8fPwPjyvXRqW9Wzx_skATsjiB9gAzK1CEHJ2UI91Y,3224 +tzlocal/win32.py,sha256=8lFxjUGxOmcHcVgKWjVEPnLbTswOgxqdpnaBW9wcPQE,4668 +tzlocal/windows_tz.py,sha256=fG2X3ly4i3cRoaQEd6ncJhqDgPp-qvJunnRW-fg0Jkk,35165 diff --git a/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/WHEEL b/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/WHEEL new file mode 100644 index 00000000..becc9a66 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.37.1) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/top_level.txt b/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/top_level.txt new file mode 100644 index 00000000..cd5e9b12 --- /dev/null +++ b/.venv/lib/python3.12/site-packages/tzlocal-5.3.1.dist-info/top_level.txt @@ -0,0 +1 @@ +tzlocal |