././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1658728 python-dateutil-2.8.2/0000755000175100001710000000000000000000000014215 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/.gitattributes0000644000175100001710000000050000000000000017103 0ustar00runnerdocker# Set the default behavior, in case people don't have core.autocrlf set. * text=auto # Specify what's text and should be normalized *.py text *.in text *.rst text *.cfg text *.ini text *.yml text *.json text *.bat text *.sh text RELEASING text # NEWS and Windows batch files should be crlf NEWS eol=crlf *.bat eol=crlf././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1578727 python-dateutil-2.8.2/.github/0000755000175100001710000000000000000000000015555 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/.github/pull_request_template.md0000644000175100001710000000100300000000000022510 0ustar00runnerdocker ## Summary of changes Closes ### Pull Request Checklist - [ ] Changes have tests - [ ] Authors have been added to [AUTHORS.md](https://github.com/dateutil/dateutil/blob/master/AUTHORS.md) - [ ] News fragment added in changelog.d. See [CONTRIBUTING.md](https://github.com/dateutil/dateutil/blob/master/CONTRIBUTING.md#changelog) for details ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1578727 python-dateutil-2.8.2/.github/workflows/0000755000175100001710000000000000000000000017612 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/.github/workflows/publish.yml0000644000175100001710000000336700000000000022014 0ustar00runnerdocker# This workflow is triggered three ways: # # 1. Manually triggering the workflow via the GitHub UI (Actions > Upload # package) will upload to test.pypi.org without the need to create a tag. # 2. When a tag is created, the workflow will upload the package to # test.pypi.org. # 3. When a GitHub Release is made, the workflow will upload the package to pypi.org. # # It is done this way until PyPI has draft reviews, to allow for a two-stage # upload with a chance for manual intervention before the final publication. name: Upload package on: release: types: [created] push: tags: - '*' workflow_dispatch: jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - name: Set up Python uses: actions/setup-python@v2 with: python-version: '3.9' - name: Install dependencies run: | python -m pip install --upgrade pip pip install -U tox - name: Create tox environments run: | tox -p -e py,build,release --notest - name: Run tests run: | tox -e py - name: Build package run: | tox -e build - name: Publish package env: TWINE_USERNAME: "__token__" run: | if [[ "$GITHUB_EVENT_NAME" == "push" || \ "$GITHUB_EVENT_NAME" == "workflow_dispatch" ]]; then export TWINE_REPOSITORY_URL="https://test.pypi.org/legacy/" export TWINE_PASSWORD="${{ secrets.TEST_PYPI_UPLOAD_TOKEN }}" elif [[ "$GITHUB_EVENT_NAME" == "release" ]]; then export TWINE_REPOSITORY="pypi" export TWINE_PASSWORD="${{ secrets.PYPI_UPLOAD_TOKEN }}" else echo "Unknown event name: ${GITHUB_EVENT_NAME}" exit 1 fi tox -e release ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/.github/workflows/validate.yml0000644000175100001710000000631600000000000022134 0ustar00runnerdockername: Validate on: push: branches: - master pull_request: branches: - master jobs: test: strategy: matrix: python-version: [ "2.7", "3.5", "3.6", "3.7", "3.8", "3.9", "pypy2", "pypy3", ] os: [ubuntu-latest, windows-latest, macos-latest] runs-on: ${{ matrix.os }} env: TOXENV: py steps: - uses: actions/checkout@v2 - name: Set up Python ${{ matrix.python-version }} on ${{ matrix.os }} uses: actions/setup-python@v1 with: python-version: ${{ matrix.python-version }} - name: Install dependencies run: python -m pip install -U tox - name: Install zic (Windows) run: | curl https://get.enterprisedb.com/postgresql/postgresql-9.5.21-2-windows-x64-binaries.zip --output $env:GITHUB_WORKSPACE\postgresql9.5.21.zip unzip -oq $env:GITHUB_WORKSPACE\postgresql9.5.21.zip -d .postgresql if: runner.os == 'Windows' - name: Run updatezinfo.py (Windows) run: | $env:Path += ";$env:GITHUB_WORKSPACE\.postgresql\pgsql\bin" ci_tools/retry.bat python updatezinfo.py if: runner.os == 'Windows' - name: Run updatezinfo.py (Unix) run: ./ci_tools/retry.sh python updatezinfo.py if: runner.os != 'Windows' - name: Run tox run: python -m tox - name: Generate coverage.xml run: python -m tox -e coverage - name: Report coverage to Codecov uses: codecov/codecov-action@v1 with: file: ./.tox/coverage.xml name: ${{ matrix.os }}:${{ matrix.python-version }} fail_ci_if_error: true docs: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - name: Set up Python uses: actions/setup-python@v1 with: python-version: 3.6 - name: Install tox run: python -m pip install -U tox - name: Run tox run: python -m tox -e docs latest-tz: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - name: Set up Python uses: actions/setup-python@v1 with: python-version: 3.6 - name: Install tox run: python -m pip install -U "tox<3.8.0" - name: Run updatezinfo.py run: ./ci_tools/retry.sh python updatezinfo.py - name: Run tox run: python -m tox -e tz build-dist: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - name: Set up Python uses: actions/setup-python@v2 with: python-version: "3.9" - name: Install tox run: python -m pip install -U tox - name: Run tox run: python -m tox -e build - name: Check generation run: | exactly_one() { value=$(find dist -iname $1 | wc -l) if [ $value -ne 1 ]; then echo "Found $value instances of $1, not 1" return 1 else echo "Found exactly 1 instance of $value" fi } # Check that exactly one tarball and one wheel are created exactly_one '*.tar.gz' exactly_one '*.whl' ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/.gitignore0000644000175100001710000000052100000000000016203 0ustar00runnerdocker# Byte-compiled / optimized / DLL files __pycache__/ *.py[cod] # Build detritus build/ dist/ .eggs *.egg-info/ # Test detritus .tox/ .pytest_cache/ venv/ .venv/ .hypothesis/ # Autogenerated version information dateutil/_version.py # Sphinx documentation docs/_build/ # Timezone information tzdata*.tar.gz .idea .cache .mypy_cache ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/.travis.yml0000644000175100001710000000143200000000000016326 0ustar00runnerdockerlanguage: python cache: pip python: - "3.4" - "nightly" env: TOXENV=py matrix: fast_finish: true include: - python: 3.3 # This is required to run Python 3.3 on Travis dist: trusty env: TOXENV=py33 # Needed because "py" won't invoke testenv:py33 allow_failures: - python: "nightly" install: - | if [[ $TRAVIS_PYTHON_VERSION == "3.3" ]]; then pip install -U "pip==10.0.1" PIP_ARGS="-c requirements/3.3/constraints.txt" fi - | if [[ $TRAVIS_PYTHON_VERSION == "3.4" ]]; then pip install -U setuptools fi - pip install -U "tox<3.8.0" $PIP_ARGS - if [[ $TOXENV == "py" ]]; then ./ci_tools/retry.sh python updatezinfo.py; fi script: - tox after_success: - if [[ $TOXENV == "py" ]]; then tox -e coverage,codecov; fi ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/AUTHORS.md0000644000175100001710000001453200000000000015671 0ustar00runnerdockerThis is a (possibly incomplete) list of all the contributors to python-dateutil, initially generated from the git author metadata. The details of their specific contributions can be found in the git history. Prior to 2017-12-01, the library was licensed solely under the BSD 3-clause license, all contributions on or after 2017-12-01 are dual-licensed between Apache 2.0 and BSD 3-clause. In the list below, anyone whose name is marked with **R** has agreed to re-license their previously submitted code under Apache 2.0. Anyone whose name is marked with a **D** has only made contributions since the switch, and thus all their contributions are dual-licensed. ## Contributors (alphabetical order) - Adam Chainz - Adrien Cossa - Alec Nikolas Reiter - Alec Reiter - Alex Chamberlain (gh: @alexchamberlain) **D** - Alex Verdyan - Alex Willmer (gh: @moreati) **R** - Alexander Brugh (gh: @abrugh) - Alexander Shadchin (gh: @shadchin) **D** - Alistair McMaster (gh: @alimcmaster1 ) **D** - Allison Quinlan (gh: @aquinlan) **D** - Andrew Bennett (gh: @andrewcbennett) **D** - Andrew Murray - Arclight (gh: @arclightslavik) - Aritro Nandi (gh: @gurgenz221) **D** - Bernat Gabor (gh: @gaborbernat) **D** - Bradlee Speice (gh: @bspeice) **D** - Brandon W Maister - Brock Mendel (gh: @jbrockmendel) **R** - Brook Li (gh: @absreim) **D** - Carlos - Cheuk Ting Ho (gh: @cheukting) **D** - Chris van den Berg (gh: bergvca) **D** - Christopher Cordero (gh: cs-cordero) **D** - Christopher Corley - Claudio Canepa - Corey Girard (gh: @coreygirard) **D** - Cosimo Lupo (gh: @anthrotype) **D** - Daniel Lemm (gh: @ffe4) **D** - Daniel Lepage - David Lehrian - Dean Allsopp (gh: @daplantagenet) **D** - Dominik Kozaczko - Elliot Hughes (gh: @ElliotJH) **D** - Elvis Pranskevichus - Fan Huang (gh: @fhuang5) **D** - Florian Rathgeber (gh: @kynan) **D** - Gabriel Bianconi (gh: @GabrielBianconi) **D** - Gabriel Poesia - Gökçen Nurlu (gh: @gokcennurlu) **D** - Grant Garrett-Grossman (gh: @FakeNameSE) **D** - Gustavo Niemeyer (gh: @niemeyer) - Holger Joukl (gh: @hjoukl) - Hugo van Kemenade (gh: @hugovk) **D** - Igor - Ionuț Ciocîrlan - Jacqueline Chen (gh: @jachen20) **D** - Jake Chorley (gh: @jakec-github) **D** - Jan Studený - Jay Weisskopf (gh: @jayschwa) **D** - Jitesh - John Purviance (gh @jpurviance) **D** - Jon Dufresne (gh: @jdufresne) **R** - Jonas Neubert (gh: @jonemo) **R** - Kevin Nguyen **D** - Kirit Thadaka (gh: @kirit93) **D** - Kubilay Kocak - Laszlo Kiss Kollar (gh: @lkollar) **D** - Lauren Oldja (gh: @loldja) **D** - Luca Ferocino (gh: @lucaferocino) **D** - Mario Corchero (gh: @mariocj89) **R** - Mark Bailey **D** - Mateusz Dziedzic (gh: @m-dz) **D** - Matt Cooper (gh: @vtbassmatt) **D** - Matthew Schinckel - Max Shenfield - Maxime Lorant - Michael Aquilina (gh: @MichaelAquilina) - Michael J. Schultz - Michael Käufl (gh: @michael-k) - Mike Gilbert - Nicholas Herrriot **D** - Nicolas Évrard (gh: @nicoe) **D** - Nick Smith - Orson Adams (gh: @parsethis) **D** - Paul Brown (gh: @pawl) **D** - Paul Dickson (gh @prdickson) **D** - Paul Ganssle (gh: @pganssle) **R** - Pascal van Kooten (gh: @kootenpv) **R** - Pavel Ponomarev - Peter Bieringer - Pierre Gergondet (gh: @gergondet) **D** - Quentin Pradet - Raymond Cha (gh: @weatherpattern) **D** - Ridhi Mahajan **D** - Robin Henriksson Törnström **D** - Roy Williams - Rustem Saiargaliev (gh: @amureki) **D** - Satyabrat Bhol (gh: @Satyabrat35) **D** - Savraj - Sergey Vishnikin - Sherry Zhou (gh: @cssherry) **D** - Siping Meng (gh: @smeng10) **D** - Stefan Bonchev **D** - Thierry Bastian - Thomas A Caswell (gh: @tacaswell) **R** - Thomas Achtemichuk - Thomas Kluyver (gh: @takluyver) - Tim Gates (gh: timgates42) - Tomasz Kluczkowski (gh: @Tomasz-Kluczkowski) **D** - Tomi Pieviläinen - Unrud (gh: @unrud) - Xavier Lapointe (gh: @lapointexavier) **D** - X O - Yaron de Leeuw (gh: @jarondl) - Yoney **D** - Yuan Huang (gh: @huangy22) **D** - Zbigniew Jędrzejewski-Szmek - bachmann - bjv (@bjamesvERT) - gl - gfyoung **D** - Labrys (gh: @labrys) **R** - ms-boom - ryanss (gh: @ryanss) **R** Unless someone has deliberately given permission to publish their e-mail, I have masked the domain names. If you are not on this list and believe you should be, or you *are* on this list and your information is inaccurate, please e-mail the current maintainer or the mailing list (dateutil@python.org) with your name, e-mail (if desired) and GitHub (if desired / applicable), as you would like them displayed. Additionally, please indicate if you are willing to dual license your old contributions under Apache 2.0. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/CONTRIBUTING.md0000644000175100001710000001473300000000000016456 0ustar00runnerdocker# Contributing This document outlines the ways to contribute to `python-dateutil`. This is a fairly small, low-traffic project, so most of the contribution norms (coding style, acceptance criteria) have been developed ad hoc and this document will not be exhaustive. If you are interested in contributing code or documentation, please take a moment to at least review the license section to understand how your code will be licensed. ## Types of contribution ### Bug reports Bug reports are an important type of contribution - it's important to get feedback about how the library is failing, and there's no better way to do that than to hear about real-life failure cases. A good bug report will include: 1. A minimal, reproducible example - a small, self-contained script that can reproduce the behavior is the best way to get your bug fixed. For more information and tips on how to structure these, read [Stack Overflow's guide to creating a minimal, complete, verified example](https://stackoverflow.com/help/mcve). 2. The platform and versions of everything involved, at a minimum please include operating system, `python` version and `dateutil` version. Instructions on getting your versions: - `dateutil`: `python -c 'import dateutil; print(dateutil.__version__)'` - `Python`: `python --version` 3. A description of the problem - what *is* happening and what *should* happen. While pull requests fixing bugs are accepted, they are *not* required - the bug report in itself is a great contribution. ### Feature requests If you would like to see a new feature in `dateutil`, it is probably best to start an issue for discussion rather than taking the time to implement a feature which may or may not be appropriate for `dateutil`'s API. For minor features (ones where you don't have to put a lot of effort into the PR), a pull request is fine but still not necessary. ### Pull requests If you would like to fix something in `dateutil` - improvements to documentation, bug fixes, feature implementations, fixes to the build system, etc - pull requests are welcome! Where possible, try to keep your coding to [PEP 8 style](https://www.python.org/dev/peps/pep-0008/), with the minor modification that the existing `dateutil` class naming style does not use the CapWords convention, or where the existing style does not follow PEP 8. The most important thing to include in your pull request are *tests* - please write one or more tests to cover the behavior you intend your patch to improve. Ideally, tests would use only the public interface - try to get 100% difference coverage using only supported behavior of the API. #### Changelog To keep users abreast of the changes to the module and to give proper credit, `dateutil` maintains a changelog, which is managed by [towncrier](https://github.com/hawkowl/towncrier). To add a changelog entry, make a new file called `..rst` in the `changelog.d` directory, where `` is the number of the PR you've just made (it's easiest to add the changelog *after* you've created the PR so you'll have this number), and `` is one of the following types: - `feature`: A new feature, (e.g. a new function, method, attribute, etc) - `bugfix`: A fix to a bug - `doc`: A change to the documentation - `deprecation`: Used if deprecating a feature or dropping support for a Python version. - `misc`: A change that has no interesting effect for end users, such as fixes to the test suite or CI. PRs that include a feature or bugfix *and* a deprecation should create a separate entry for the deprecation. > {description of changes}. Reported by @{reporter} (gh issue #{issue\_no}). Fixed by @{patch submitter} (gh pr #{pr\_no}) An example changelog entry might be: **581.bugfix.rst** ``` Fixed issue where the tz.tzstr constructor would erroneously succeed if passed an invalid value for tzstr. Reported by @pganssle (gh issue #259). Fixed by @pablogsal (gh pr #581) ``` For bugs reported and fixed by the same person use "Reported and fixed by @{patch submitter}". It is not necessary to create a GitHub issue just for the purpose of mentioning it in the changelog, if the PR *is* the report, mentioning the PR is enough. ## License Starting December 1, 2017, all contributions will be assumed to be released under a dual license - the [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0) and the [3-Clause BSD License](https://opensource.org/licenses/BSD-3-Clause) unless otherwise specified in the pull request. All contributions before December 1, 2017 except those explicitly relicensed, are only under the 3-clause BSD license. ## Development Setup ### Using a virtual environment It is advisable to work in a virtual environment for development of `dateutil`. This can be done using [virtualenv](https://virtualenv.pypa.io): ```bash python -m virtualenv .venv # Create virtual environment in .venv directory source .venv/bin/activate # Activate the virtual environment ``` Alternatively you can create a [conda environment](https://conda.io/docs/user-guide/tasks/manage-environments.html): ```bash conda create -n dateutil # Create a conda environment # conda create -n dateutil python=3.6 # Or specify a version source activate dateutil # Activate the conda environment ``` Once your virtual environment is created, install the library in development mode: ```bash pip install -e . ``` This will allow scripts run in your virtual environment to use the version of `dateutil` in your local directory. If you also want to run the tests in your local directory, install the test dependencies: ```bash pip install -r requirements-dev.txt ``` ## Testing The best way to test `dateutil` is to run `tox`. By default, `tox` will test against all supported versions of Python installed on your system. To limit the number of tests, run a specific subset of environments. For example, to run only on Python 2.7 and Python 3.6: ```bash tox -e py27,py36 ``` You can also pass arguments to `pytest` through `tox` by placing them after `--`: ```bash tox -e py36 -- -m tzstr ``` This will pass the `-m tzstr` parameter to `pytest`, running only the tests with the `tzstr` mark. The tests can also be run directly by running `pytest` or `python -m pytest` in the root directory. This will be likely be less thorough but is often faster and is a good first pass to check your changes. All GitHub pull requests are automatically tested using [Travis](https://travis-ci.org/dateutil/dateutil/) and [Appveyor](https://ci.appveyor.com/project/dateutil/dateutil). ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/LICENSE0000644000175100001710000000551100000000000015224 0ustar00runnerdockerCopyright 2017- Paul Ganssle Copyright 2017- dateutil contributors (see AUTHORS file) Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. The above license applies to all contributions after 2017-12-01, as well as all contributions that have been re-licensed (see AUTHORS file for the list of contributors who have re-licensed their code). -------------------------------------------------------------------------------- dateutil - Extensions to the standard Python datetime module. Copyright (c) 2003-2011 - Gustavo Niemeyer Copyright (c) 2012-2014 - Tomi Pieviläinen Copyright (c) 2014-2016 - Yaron de Leeuw Copyright (c) 2015- - Paul Ganssle Copyright (c) 2015- - dateutil contributors (see AUTHORS file) All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. The above BSD License Applies to all code, even that also covered by Apache 2.0.././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/MANIFEST.in0000644000175100001710000000023700000000000015755 0ustar00runnerdockerinclude LICENSE NEWS zonefile_metadata.json updatezinfo.py pyproject.toml recursive-include dateutil/test * global-exclude __pycache__ global-exclude *.py[co] ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/NEWS0000644000175100001710000012464400000000000014727 0ustar00runnerdockerVersion 2.8.2 (2021-07-08) ========================== Data updates ------------ - Updated tzdata version to 2021a. (gh pr #1128) Bugfixes -------- - Fixed a bug in the parser where non-``ValueError`` exceptions would be raised during exception handling; this would happen, for example, if an ``IllegalMonthError`` was raised in ``dateutil`` code. Fixed by Mark Bailey. (gh issue #981, pr #987). - Fixed the custom ``repr`` for ``dateutil.parser.ParserError``, which was not defined due to an indentation error. (gh issue #991, gh pr #993) - Fixed a bug that caused ``b'`` prefixes to appear in parse_isodate exception messages. Reported and fixed by Paul Brown (@pawl) (gh pr #1122) - Make ``isoparse`` raise when trying to parse times with inconsistent use of `:` separator. Reported and fixed by @mariocj89 (gh pr #1125). - Fixed ``tz.gettz()`` not returning local time when passed an empty string. Reported by @labrys (gh issues #925, #926). Fixed by @ffe4 (gh pr #1024) Documentation changes --------------------- - Rearranged parser documentation into "Functions", "Classes" and "Warnings and Exceptions" categories. (gh issue #992, pr #994). - Updated ``parser.parse`` documentation to reflect the switch from ``ValueError`` to ``ParserError``. (gh issue #992, pr #994). - Fixed methods in the ``rrule`` module not being displayed in the docs. (gh pr #1025) - Changed some relative links in the exercise documentation to refer to the document locations in the input tree, rather than the generated HTML files in the HTML output tree (which presumably will not exist in non-HTML output formats). (gh pr #1078). Misc ---- - Moved ``test_imports.py``, ``test_internals.py`` and ``test_utils.py`` to pytest. Reported and fixed by @jpurviance (gh pr #978) - Added project_urls for documentation and source. Patch by @andriyor (gh pr #975). - Simplified handling of bytes and bytearray in ``_parser._timelex``. Reported and fixed by @frenzymadness (gh issue #1060). - Changed the tests against the upstream tz database to always generate fat binaries, since until GH-590 and GH-1059 are resolved, "slim" zic binaries will cause problems in many zones, causing the tests to fail. This also updates ``zoneinfo.rebuild`` to always generate fat binaries. (gh pr #1076). - Moved sdist and wheel generation to use `python-build`. Reported and fixed by @mariocj89 (gh pr #1133). Version 2.8.1 (2019-11-03) ========================== Data updates ------------ - Updated tzdata version to 2019c. Bugfixes -------- - Fixed a race condition in the ``tzoffset`` and ``tzstr`` "strong" caches on Python 2.7. Reported by @kainjow (gh issue #901). - Parsing errors will now raise ``ParserError``, a subclass of ``ValueError``, which has a nicer string representation. Patch by @gfyoung (gh pr #881). - ``parser.parse`` will now raise ``TypeError`` when ``tzinfos`` is passed a type that cannot be interpreted as a time zone. Prior to this change, it would raise an ``UnboundLocalError`` instead. Patch by @jbrockmendel (gh pr #891). - Changed error message raised when when passing a ``bytes`` object as the time zone name to gettz in Python 3. Reported and fixed by @labrys () (gh issue #927, gh pr #935). - Changed compatibility logic to support a potential Python 4.0 release. Patch by Hugo van Kemenade (gh pr #950). - Updated many modules to use ``tz.UTC`` in favor of ``tz.tzutc()`` internally, to avoid an unnecessary function call. (gh pr #910). - Fixed issue where ``dateutil.tz`` was using a backported version of ``contextlib.nullcontext`` even in Python 3.7 due to a malformed import statement. (gh pr #963). Tests ----- - Switched from using assertWarns to using pytest.warns in the test suite. (gh pr #969). - Fix typo in setup.cfg causing PendingDeprecationWarning to not be explicitly specified as an error in the warnings filter. (gh pr #966) - Fixed issue where ``test_tzlocal_offset_equal`` would fail in certain environments (such as FreeBSD) due to an invalid assumption about what time zone names are provided. Reported and fixed by Kubilay Kocak (gh issue #918, pr #928). - Fixed a minor bug in ``test_isoparser`` related to ``bytes``/``str`` handling. Fixed by @fhuang5 (gh issue #776, gh pr #879). - Explicitly listed all markers used in the pytest configuration. (gh pr #915) - Extensive improvements to the parser test suite, including the adoption of ``pytest``-style tests and the addition of parametrization of several test cases. Patches by @jbrockmendel (gh prs #735, #890, #892, #894). - Added tests for tzinfos input types. Patch by @jbrockmendel (gh pr #891). - Fixed failure of test suite when changing the TZ variable is forbidden. Patch by @shadchin (gh pr #893). - Pinned all test dependencies on Python 3.3. (gh prs #934, #962) Documentation changes --------------------- - Fixed many misspellings, typos and styling errors in the comments and documentation. Patch by Hugo van Kemenade (gh pr #952). Misc ---- - Added Python 3.8 to the trove classifiers. (gh pr #970) - Moved as many keys from ``setup.py`` to ``setup.cfg`` as possible. Fixed by @FakeNameSE, @aquinlan82, @jachen20, and @gurgenz221 (gh issue #871, gh pr #880). - Reorganized ``parser`` methods by functionality. Patch by @jbrockmendel (gh pr #882). - Switched ``release.py`` over to using ``pep517.build`` for creating releases, rather than direct invocations of ``setup.py``. Fixed by @smeng10 (gh issue #869, gh pr #875). - Added a "build" environment into the tox configuration, to handle dependency management when making releases. Fixed by @smeng10 (gh issue #870,r gh pr #876). - GH #916, GH #971 Version 2.8.0 (2019-02-04) ========================== Data updates ------------ - Updated tzdata version to to 2018i. Features -------- - Added support for ``EXDATE`` parameters when parsing ``rrule`` strings. Reported by @mlorant (gh issue #410), fixed by @nicoe (gh pr #859). - Added support for sub-minute time zone offsets in Python 3.6+. Fixed by @cssherry (gh issue #582, pr #763) - Switched the ``tzoffset``, ``tzstr`` and ``gettz`` caches over to using weak references, so that the cache expires when no other references to the original ``tzinfo`` objects exist. This cache-expiry behavior is not guaranteed in the public interface and may change in the future. To improve performance in the case where transient references to the same time zones are repeatedly created but no strong reference is continuously held, a smaller "strong value" cache was also added. Weak value cache implemented by @cs-cordero (gh pr #672, #801), strong cache added by Gökçen Nurlu (gh issue #691, gh pr #761) Bugfixes -------- - Add support for ISO 8601 times with comma as the decimal separator in the ``dateutil.parser.isoparse`` function. (gh pr #721) - Changed handling of ``T24:00`` to be compliant with the standard. ``T24:00`` now represents midnight on the *following* day. Fixed by @cheukting (gh issue #658, gh pr #751) - Fixed an issue where ``isoparser.parse_isotime`` was unable to handle the ``24:00`` variant representation of midnight. (gh pr #773) - Added support for more than 6 fractional digits in `isoparse`. Reported and fixed by @jayschwa (gh issue #786, gh pr #787). - Added 'z' (lower case Z) as valid UTC time zone in isoparser. Reported by @cjgibson (gh issue #820). Fixed by @Cheukting (gh pr #822) - Fixed a bug with base offset changes during DST in ``tzfile``, and refactored the way base offset changes are detected. Originally reported on Stack Overflow by @MartinThoma. (gh issue #812, gh pr #810) - Fixed error condition in ``tz.gettz`` when a non-ASCII timezone is passed on Windows in Python 2.7. (gh issue #802, pr #861) - Improved performance and inspection properties of ``tzname`` methods. (gh pr #811) - Removed unnecessary binary_type compatibility shims. Added by @jdufresne (gh pr #817) - Changed ``python setup.py test`` to print an error to ``stderr`` and exit with 1 instead of 0. Reported and fixed by @hroncok (gh pr #814) - Added a ``pyproject.toml`` file with build requirements and an explicitly specified build backend. (gh issue #736, gh prs #746, #863) Documentation changes --------------------- - Added documentation for the ``rrule.rrulestr`` function. Fixed by @prdickson (gh issue #623, gh pr #762) - Add documentation for the ``dateutil.tz.win`` module and mocked out certain Windows-specific modules so that autodoc can still be run on non-Windows systems. (gh issue #442, pr #715) - Added changelog to documentation. (gh issue #692, gh pr #707) - Improved documentation on the use of ``until`` and ``count`` parameters in ``rrule``. Fixed by @lucaferocino (gh pr #755). - Added an example of how to use a custom ``parserinfo`` subclass to parse non-standard datetime formats in the examples documentation for ``parser``. Added by @prdickson (gh #753) - Expanded the description and examples in the ``relativedelta`` class. Contributed by @andrewcbennett (gh pr #759) - Improved the contributing documentation to clarify where to put new changelog files. Contributed by @andrewcbennett (gh pr #757) - Fixed a broken doctest in the ``relativedelta`` module. Fixed by @nherriot (gh pr #758). - Reorganized ``dateutil.tz`` documentation and fixed issue with the ``dateutil.tz`` docstring. (gh pr #714) Misc ---- - GH #720, GH #723, GH #726, GH #727, GH #740, GH #750, GH #760, GH #767, GH #772, GH #773, GH #780, GH #784, GH #785, GH #791, GH #799, GH #813, GH #836, GH #839, GH #857 Version 2.7.5 (2018-10-27) ========================== Data updates ------------ - Update tzdata to 2018g Version 2.7.4 (2018-10-24) ========================== Data updates ------------ - Updated tzdata version to 2018f. Version 2.7.3 (2018-05-09) ========================== Data updates ------------ - Update tzdata to 2018e. (gh pr #710) Bugfixes -------- - Fixed an issue where ``parser.parse`` would raise ``Decimal``-specific errors instead of a standard ``ValueError`` if certain malformed values were parsed (e.g. ``NaN`` or infinite values). Reported and fixed by @amureki (gh issue #662, gh pr #679). - Fixed issue in ``parser`` where a ``tzinfos`` call explicitly returning ``None`` would throw a ``ValueError``. Fixed by @parsethis (gh issue #661, gh pr #681) - Fixed incorrect parsing of certain dates earlier than 100 AD when represented in the form "%B.%Y.%d", e.g. "December.0031.30". (gh issue #687, pr #700) - Added time zone inference when initializing an ``rrule`` with a specified ``UNTIL`` but without an explicitly specified ``DTSTART``; the time zone of the generated ``DTSTART`` will now be taken from the ``UNTIL`` rule. Reported by @href (gh issue #652). Fixed by @absreim (gh pr #693). Documentation changes --------------------- - Corrected link syntax and updated URL to https for ISO year week number notation in relativedelta examples. (gh issue #670, pr #711) - Add doctest examples to tzfile documentation. Done by @weatherpattern and @pganssle (gh pr #671) - Updated the documentation for relativedelta. Removed references to tuple arguments for weekday, explained effect of weekday(_, 1) and better explained the order of operations that relativedelta applies. Fixed by @kvn219 @huangy22 and @ElliotJH (gh pr #673) - Added changelog to documentation. (gh issue #692, gh pr #707) - Changed order of keywords in rrule docstring. Reported and fixed by @rmahajan14 (gh issue #686, gh pr #695). - Added documentation for ``dateutil.tz.gettz``. Reported by @pganssle (gh issue #647). Fixed by @weatherpattern (gh pr #704) - Cleaned up malformed RST in the ``tz`` documentation. (gh issue #702, gh pr #706) - Changed the default theme to ``sphinx_rtd_theme``, and changed the sphinx configuration accordingly. (gh pr #707) - Reorganized ``dateutil.tz`` documentation and fixed issue with the ``dateutil.tz`` docstring. (gh pr #714) Misc ---- - GH #674, GH #688, GH #699 Version 2.7.2 (2018-03-26) ========================== Bugfixes -------- - Fixed an issue with the setup script running in non-UTF-8 environment. Reported and fixed by @gergondet (gh pr #651) Misc ---- - GH #655 Version 2.7.1 (2018-03-24) =========================== Data updates ------------ - Updated tzdata version to 2018d. Bugfixes -------- - Fixed issue where parser.parse would occasionally raise decimal.Decimal-specific error types rather than ValueError. Reported by @amureki (gh issue #632). Fixed by @pganssle (gh pr #636). - Improve error message when rrule's dtstart and until are not both naive or both aware. Reported and fixed by @ryanpetrello (gh issue #633, gh pr #634) Misc ---- - GH #644, GH #648 Version 2.7.0 ============= - Dropped support for Python 2.6 (gh pr #362 by @jdufresne) - Dropped support for Python 3.2 (gh pr #626) - Updated zoneinfo file to 2018c (gh pr #616) - Changed licensing scheme so all new contributions are dual licensed under Apache 2.0 and BSD. (gh pr #542, issue #496) - Added __all__ variable to the root package. Reported by @tebriel (gh issue #406), fixed by @mariocj89 (gh pr #494) - Added python_requires to setup.py so that pip will distribute the right version of dateutil. Fixed by @jakec-github (gh issue #537, pr #552) - Added the utils submodule, for miscellaneous utilities. - Added within_delta function to utils - added by @justanr (gh issue #432, gh pr #437) - Added today function to utils (gh pr #474) - Added default_tzinfo function to utils (gh pr #475), solving an issue reported by @nealmcb (gh issue #94) - Added dedicated ISO 8601 parsing function isoparse (gh issue #424). Initial implementation by @pganssle in gh pr #489 and #622, with a pre-release fix by @kirit93 (gh issue #546, gh pr #573). - Moved parser module into parser/_parser.py and officially deprecated the use of several private functions and classes from that module. (gh pr #501, #515) - Tweaked parser error message to include rejected string format, added by @pbiering (gh pr #300) - Add support for parsing bytesarray, reported by @uckelman (gh issue #417) and fixed by @uckelman and @pganssle (gh pr #514) - Started raising a warning when the parser finds a timezone string that it cannot construct a tzinfo instance for (rather than succeeding with no indication of an error). Reported and fixed by @jbrockmendel (gh pr #540) - Dropped the use of assert in the parser. Fixed by @jbrockmendel (gh pr #502) - Fixed to assertion logic in parser to support dates like '2015-15-May', reported and fixed by @jbrockmendel (gh pr #409) - Fixed IndexError in parser on dates with trailing colons, reported and fixed by @jbrockmendel (gh pr #420) - Fixed bug where hours were not validated, leading to improper parse. Reported by @heappro (gh pr #353), fixed by @jbrockmendel (gh pr #482) - Fixed problem parsing strings in %b-%Y-%d format. Reported and fixed by @jbrockmendel (gh pr #481) - Fixed problem parsing strings in the %d%B%y format. Reported by @asishm (gh issue #360), fixed by @jbrockmendel (gh pr #483) - Fixed problem parsing certain unambiguous strings when year <99 (gh pr #510). Reported by @alexwlchan (gh issue #293). - Fixed issue with parsing an unambiguous string representation of an ambiguous datetime such that if possible the correct value for fold is set. Fixes issue reported by @JordonPhillips and @pganssle (gh issue #318, #320, gh pr #517) - Fixed issue with improper rounding of fractional components. Reported by @dddmello (gh issue #427), fixed by @m-dz (gh pr #570) - Performance improvement to parser from removing certain min() calls. Reported and fixed by @jbrockmendel (gh pr #589) - Significantly refactored parser code by @jbrockmendel (gh prs #419, #436, #490, #498, #539) and @pganssle (gh prs #435, #468) - Implemented of __hash__ for relativedelta and weekday, reported and fixed by @mrigor (gh pr #389) - Implemented __abs__ for relativedelta. Reported by @binnisb and @pferreir (gh issue #350, pr #472) - Fixed relativedelta.weeks property getter and setter to work for both negative and positive values. Reported and fixed by @souliane (gh issue #459, pr #460) - Fixed issue where passing whole number floats to the months or years arguments of the relativedelta constructor would lead to errors during addition. Reported by @arouanet (gh pr #411), fixed by @lkollar (gh pr #553) - Added a pre-built tz.UTC object representing UTC (gh pr #497) - Added a cache to tz.gettz so that by default it will return the same object for identical inputs. This will change the semantics of certain operations between datetimes constructed with tzinfo=tz.gettz(...). (gh pr #628) - Changed the behavior of tz.tzutc to return a singleton (gh pr #497, #504) - Changed the behavior of tz.tzoffset to return the same object when passed the same inputs, with a corresponding performance improvement (gh pr #504) - Changed the behavior of tz.tzstr to return the same object when passed the same inputs. (gh pr #628) - Added .instance alternate constructors for tz.tzoffset and tz.tzstr, to allow the construction of a new instance if desired. (gh pr #628) - Added the tz.gettz.nocache function to allow explicit retrieval of a new instance of the relevant tzinfo. (gh pr #628) - Expand definition of tz.tzlocal equality so that the local zone is allow equality with tzoffset and tzutc. (gh pr #598) - Deprecated the idiosyncratic tzstr format mentioned in several examples but evidently designed exclusively for dateutil, and very likely not used by any current users. (gh issue #595, gh pr #606) - Added the tz.resolve_imaginary function, which generates a real date from an imaginary one, if necessary. Implemented by @Cheukting (gh issue #339, gh pr #607) - Fixed issue where the tz.tzstr constructor would erroneously succeed if passed an invalid value for tzstr. Fixed by @pablogsal (gh issue #259, gh pr #581) - Fixed issue with tz.gettz for TZ variables that start with a colon. Reported and fixed by @lapointexavier (gh pr #601) - Added a lock to tz.tzical's cache. Reported and fixed by @Unrud (gh pr #430) - Fixed an issue with fold support on certain Python 3 implementations that used the pre-3.6 pure Python implementation of datetime.replace, most notably pypy3 (gh pr #446). - Added support for VALUE=DATE-TIME for DTSTART in rrulestr. Reported by @potuz (gh issue #401) and fixed by @Unrud (gh pr #429) - Started enforcing that within VTIMEZONE, the VALUE parameter can only be omitted or DATE-TIME, per RFC 5545. Reported by @Unrud (gh pr #439) - Added support for TZID parameter for DTSTART in rrulestr. Reported and fixed by @ryanpetrello (gh issue #614, gh pr #624) - Added 'RRULE:' prefix to rrule strings generated by rrule.__str__, in compliance with the RFC. Reported by @AndrewPashkin (gh issue #86), fixed by @jarondl and @mlorant (gh pr #450) - Switched to setuptools_scm for version management, automatically calculating a version number from the git metadata. Reported by @jreback (gh issue #511), implemented by @Sulley38 (gh pr #564) - Switched setup.py to use find_packages, and started testing against pip installed versions of dateutil in CI. Fixed issue with parser import discovered by @jreback in pandas-dev/pandas#18141. (gh issue #507, pr #509) - Switched test suite to using pytest (gh pr #495) - Switched CI over to use tox. Fixed by @gaborbernat (gh pr #549) - Added a test-only dependency on freezegun. (gh pr #474) - Reduced number of CI builds on Appveyor. Fixed by @kirit93 (gh issue #529, gh pr #579) - Made xfails strict by default, so that an xpass is a failure. (gh pr #567) - Added a documentation generation stage to tox and CI. (gh pr #568) - Added an explicit warning when running python setup.py explaining how to run the test suites with pytest. Fixed by @lkollar. (gh issue #544, gh pr #548) - Added requirements-dev.txt for test dependency management (gh pr #499, #516) - Fixed code coverage metrics to account for Windows builds (gh pr #526) - Fixed code coverage metrics to NOT count xfails. Fixed by @gaborbernat (gh issue #519, gh pr #563) - Style improvement to zoneinfo.tzfile that was confusing to static type checkers. Reported and fixed by @quodlibetor (gh pr #485) - Several unused imports were removed by @jdufresne. (gh pr #486) - Switched ``isinstance(*, collections.Callable)`` to callable, which is available on all supported Python versions. Implemented by @jdufresne (gh pr #612) - Added CONTRIBUTING.md (gh pr #533) - Added AUTHORS.md (gh pr #542) - Corrected setup.py metadata to reflect author vs. maintainer, (gh issue #477, gh pr #538) - Corrected README to reflect that tests are now run in pytest. Reported and fixed by @m-dz (gh issue #556, gh pr #557) - Updated all references to RFC 2445 (iCalendar) to point to RFC 5545. Fixed by @mariocj89 (gh issue #543, gh pr #555) - Corrected parse documentation to reflect proper integer offset units, reported and fixed by @abrugh (gh pr #458) - Fixed dangling parenthesis in tzoffset documentation (gh pr #461) - Started including the license file in wheels. Reported and fixed by @jdufresne (gh pr #476) - Indentation fixes to parser docstring by @jbrockmendel (gh pr #492) - Moved many examples from the "examples" documentation into their appropriate module documentation pages. Fixed by @Tomasz-Kluczkowski and @jakec-github (gh pr #558, #561) - Fixed documentation so that the parser.isoparse documentation displays. Fixed by @alexchamberlain (gh issue #545, gh pr #560) - Refactored build and release sections and added setup instructions to CONTRIBUTING. Reported and fixed by @kynan (gh pr #562) - Cleaned up various dead links in the documentation. (gh pr #602, #608, #618) Version 2.6.1 ============= - Updated zoneinfo file to 2017b. (gh pr #395) - Added Python 3.6 to CI testing (gh pr #365) - Removed duplicate test name that was preventing a test from being run. Reported and fixed by @jdufresne (gh pr #371) - Fixed testing of folds and gaps, particularly on Windows (gh pr #392) - Fixed deprecated escape characters in regular expressions. Reported by @nascheme and @thierryba (gh issue #361), fixed by @thierryba (gh pr #358) - Many PEP8 style violations and other code smells were fixed by @jdufresne (gh prs #358, #363, #364, #366, #367, #368, #372, #374, #379, #380, #398) - Improved performance of tzutc and tzoffset objects. (gh pr #391) - Fixed issue with several time zone classes around DST transitions in any zones with +0 standard offset (e.g. Europe/London) (gh issue #321, pr #390) - Fixed issue with fuzzy parsing where tokens similar to AM/PM that are in the end skipped were dropped in the fuzzy_with_tokens list. Reported and fixed by @jbrockmendel (gh pr #332). - Fixed issue with parsing dates of the form X m YY. Reported by @jbrockmendel. (gh issue #333, pr #393) - Added support for parser weekdays with less than 3 characters. Reported by @arcadefoam (gh issue #343), fixed by @jonemo (gh pr #382) - Fixed issue with the addition and subtraction of certain relativedeltas. Reported and fixed by @kootenpv (gh issue #346, pr #347) - Fixed issue where the COUNT parameter of rrules was ignored if 0. Fixed by @mshenfield (gh pr #330), reported by @vaultah (gh issue #329). - Updated documentation to include the new tz methods. (gh pr #324) - Update documentation to reflect that the parser can raise TypeError, reported and fixed by @tomchuk (gh issue #336, pr #337) - Fixed an incorrect year in a parser doctest. Fixed by @xlotlu (gh pr #357) - Moved version information into _version.py and set up the versions more granularly. Version 2.6.0 ============= - Added PEP-495-compatible methods to address ambiguous and imaginary dates in time zones in a backwards-compatible way. Ambiguous dates and times can now be safely represented by all dateutil time zones. Many thanks to Alexander Belopolski (@abalkin) and Tim Peters @tim-one for their inputs on how to address this. Original issues reported by Yupeng and @zed (lP: 1390262, gh issues #57, #112, #249, #284, #286, prs #127, #225, #248, #264, #302). - Added new methods for working with ambiguous and imaginary dates to the tz module. datetime_ambiguous() determines if a datetime is ambiguous for a given zone and datetime_exists() determines if a datetime exists in a given zone. This works for all fold-aware datetimes, not just those provided by dateutil. (gh issue #253, gh pr #302) - Fixed an issue where dst() in Portugal in 1996 was returning the wrong value in tz.tzfile objects. Reported by @abalkin (gh issue #128, pr #225) - Fixed an issue where zoneinfo.ZoneInfoFile errors were not being properly deep-copied. (gh issue #226, pr #225) - Refactored tzwin and tzrange as a subclass of a common class, tzrangebase, as there was substantial overlapping functionality. As part of this change, tzrange and tzstr now expose a transitions() function, which returns the DST on and off transitions for a given year. (gh issue #260, pr #302) - Deprecated zoneinfo.gettz() due to confusion with tz.gettz(), in favor of get() method of zoneinfo.ZoneInfoFile objects. (gh issue #11, pr #310) - For non-character, non-stream arguments, parser.parse now raises TypeError instead of AttributeError. (gh issues #171, #269, pr #247) - Fixed an issue where tzfile objects were not properly handling dst() and tzname() when attached to datetime.time objects. Reported by @ovacephaloid. (gh issue #292, pr #309) - /usr/share/lib/zoneinfo was added to TZPATHS for compatibility with Solaris systems. Reported by @dhduvall (gh issue #276, pr #307) - tzoffset and tzrange objects now accept either a number of seconds or a datetime.timedelta() object wherever previously only a number of seconds was allowed. (gh pr #264, #277) - datetime.timedelta objects can now be added to relativedelta objects. Reported and added by Alec Nikolas Reiter (@justanr) (gh issue #282, pr #283 - Refactored relativedelta.weekday and rrule.weekday into a common base class to reduce code duplication. (gh issue #140, pr #311) - An issue where the WKST parameter was improperly rendering in str(rrule) was reported and fixed by Daniel LePage (@dplepage). (gh issue #262, pr #263) - A replace() method has been added to rrule objects by @jendas1, which creates new rrule with modified attributes, analogous to datetime.replace (gh pr #167) - Made some significant performance improvements to rrule objects in Python 2.x (gh pr #245) - All classes defining equality functions now return NotImplemented when compared to unsupported classes, rather than raising TypeError, to allow other classes to provide fallback support. (gh pr #236) - Several classes have been marked as explicitly unhashable to maintain identical behavior between Python 2 and 3. Submitted by Roy Williams (@rowillia) (gh pr #296) - Trailing whitespace in easter.py has been removed. Submitted by @OmgImAlexis (gh pr #299) - Windows-only batch files in build scripts had line endings switched to CRLF. (gh pr #237) - @adamchainz updated the documentation links to reflect that the canonical location for readthedocs links is now at .io, not .org. (gh pr #272) - Made some changes to the CI and codecov to test against newer versions of Python and pypy, and to adjust the code coverage requirements. For the moment, full pypy3 compatibility is not supported until a new release is available, due to upstream bugs in the old version affecting PEP-495 support. (gh prs #265, #266, #304, #308) - The full PGP signing key fingerprint was added to the README.md in favor of the previously used long-id. Reported by @valholl (gh issue #287, pr #304) - Updated zoneinfo to 2016i. (gh issue #298, gh pr #306) Version 2.5.3 ============= - Updated zoneinfo to 2016d - Fixed parser bug where unambiguous datetimes fail to parse when dayfirst is set to true. (gh issue #233, pr #234) - Bug in zoneinfo file on platforms such as Google App Engine which do not do not allow importing of subprocess.check_call was reported and fixed by @savraj (gh issue #239, gh pr #240) - Fixed incorrect version in documentation (gh issue #235, pr #243) Version 2.5.2 ============= - Updated zoneinfo to 2016c - Fixed parser bug where yearfirst and dayfirst parameters were not being respected when no separator was present. (gh issue #81 and #217, pr #229) Version 2.5.1 ============= - Updated zoneinfo to 2016b - Changed MANIFEST.in to explicitly include test suite in source distributions, with help from @koobs (gh issue #193, pr #194, #201, #221) - Explicitly set all line-endings to LF, except for the NEWS file, on a per-repository basis (gh pr #218) - Fixed an issue with improper caching behavior in rruleset objects (gh issue #104, pr #207) - Changed to an explicit error when rrulestr strings contain a missing BYDAY (gh issue #162, pr #211) - tzfile now correctly handles files containing leapcnt (although the leapcnt information is not actually used). Contributed by @hjoukl (gh issue #146, pr #147) - Fixed recursive import issue with tz module (gh pr #204) - Added compatibility between tzwin objects and datetime.time objects (gh issue #216, gh pr #219) - Refactored monolithic test suite by module (gh issue #61, pr #200 and #206) - Improved test coverage in the relativedelta module (gh pr #215) - Adjusted documentation to reflect possibly counter-intuitive properties of RFC-5545-compliant rrules, and other documentation improvements in the rrule module (gh issue #105, gh issue #149 - pointer to the solution by @phep, pr #213). Version 2.5.0 ============= - Updated zoneinfo to 2016a - zoneinfo_metadata file version increased to 2.0 - the updated updatezinfo.py script will work with older zoneinfo_metadata.json files, but new metadata files will not work with older updatezinfo.py versions. Additionally, we have started hosting our own mirror of the Olson databases on a GitHub pages site (https://dateutil.github.io/tzdata/) (gh pr #183) - dateutil zoneinfo tarballs now contain the full zoneinfo_metadata file used to generate them. (gh issue #27, gh pr #85) - relativedelta can now be safely subclassed without derived objects reverting to base relativedelta objects as a result of arithmetic operations. (lp:1010199, gh issue #44, pr #49) - relativedelta 'weeks' parameter can now be set and retrieved as a property of relativedelta instances. (lp: 727525, gh issue #45, pr #49) - relativedelta now explicitly supports fractional relative weeks, days, hours, minutes and seconds. Fractional values in absolute parameters (year, day, etc) are now deprecated. (gh issue #40, pr #190) - relativedelta objects previously did not use microseconds to determine of two relativedelta objects were equal. This oversight has been corrected. Contributed by @elprans (gh pr #113) - rrule now has an xafter() method for retrieving multiple recurrences after a specified date. (gh pr #38) - str(rrule) now returns an RFC2445-compliant rrule string, contributed by @schinckel and @armicron (lp:1406305, gh issue #47, prs #50, #62 and #160) - rrule performance under certain conditions has been significantly improved thanks to a patch contributed by @dekoza, based on an article by Brian Beck (@exogen) (gh pr #136) - The use of both the 'until' and 'count' parameters is now deprecated as inconsistent with RFC2445 (gh pr #62, #185) - Parsing an empty string will now raise a ValueError, rather than returning the datetime passed to the 'default' parameter. (gh issue #78, pr #187) - tzwinlocal objects now have a meaningful repr() and str() implementation (gh issue #148, prs #184 and #186) - Added equality logic for tzwin and tzwinlocal objects. (gh issue #151, pr #180, #184) - Added some flexibility in subclassing timelex, and switched the default behavior over to using string methods rather than comparing against a fixed list. (gh pr #122, #139) - An issue causing tzstr() to crash on Python 2.x was fixed. (lp: 1331576, gh issue #51, pr #55) - An issue with string encoding causing exceptions under certain circumstances when tzname() is called was fixed. (gh issue #60, #74, pr #75) - Parser issue where calling parse() on dates with no day specified when the day of the month in the default datetime (which is "today" if unspecified) is greater than the number of days in the parsed month was fixed (this issue tended to crop up between the 29th and 31st of the month, for obvious reasons) (canonical gh issue #25, pr #30, #191) - Fixed parser issue causing fuzzy_with_tokens to raise an unexpected exception in certain circumstances. Contributed by @MichaelAquilina (gh pr #91) - Fixed parser issue where years > 100 AD were incorrectly parsed. Contributed by @Bachmann1234 (gh pr #130) - Fixed parser issue where commas were not a valid separator between seconds and microseconds, preventing parsing of ISO 8601 dates. Contributed by @ryanss (gh issue #28, pr #106) - Fixed issue with tzwin encoding in locales with non-Latin alphabets (gh issue #92, pr #98) - Fixed an issue where tzwin was not being properly imported on Windows. Contributed by @labrys. (gh pr #134) - Fixed a problem causing issues importing zoneinfo in certain circumstances. Issue and solution contributed by @alexxv (gh issue #97, pr #99) - Fixed an issue where dateutil timezones were not compatible with basic time objects. One of many, many timezone related issues contributed and tested by @labrys. (gh issue #132, pr #181) - Fixed issue where tzwinlocal had an invalid utcoffset. (gh issue #135, pr #141, #142) - Fixed issue with tzwin and tzwinlocal where DST transitions were incorrectly parsed from the registry. (gh issue #143, pr #178) - updatezinfo.py no longer suppresses certain OSErrors. Contributed by @bjamesv (gh pr #164) - An issue that arose when timezone locale changes during runtime has been fixed by @carlosxl and @mjschultz (gh issue #100, prs #107, #109) - Python 3.5 was added to the supported platforms in the metadata (@tacaswell gh pr #159) and the test suites (@moreati gh pr #117). - An issue with tox failing without unittest2 installed in Python 2.6 was fixed by @moreati (gh pr #115) - Several deprecated functions were replaced in the tests by @moreati (gh pr #116) - Improved the logic in Travis and Appveyor to alleviate issues where builds were failing due to connection issues when downloading the IANA timezone files. In addition to adding our own mirror for the files (gh pr #183), the download is now retried a number of times (with a delay) (gh pr #177) - Many failing doctests were fixed by @moreati. (gh pr #120) - Many fixes to the documentation (gh pr #103, gh pr #87 from @radarhere, gh pr #154 from @gpoesia, gh pr #156 from @awsum, gh pr #168 from @ja8zyjits) - Added a code coverage tool to the CI to help improve the library. (gh pr #182) - We now have a mailing list - dateutil@python.org, graciously hosted by Python.org. Version 2.4.2 ============= - Updated zoneinfo to 2015b. - Fixed issue with parsing of tzstr on Python 2.7.x; tzstr will now be decoded if not a unicode type. gh #51 (lp:1331576), gh pr #55. - Fix a parser issue where AM and PM tokens were showing up in fuzzy date stamps, triggering inappropriate errors. gh #56 (lp: 1428895), gh pr #63. - Missing function "setcachesize" removed from zoneinfo __all__ list by @ryanss, fixing an issue with wildcard imports of dateutil.zoneinfo. (gh pr #66). - (PyPI only) Fix an issue with source distributions not including the test suite. Version 2.4.1 ============= - Added explicit check for valid hours if AM/PM is specified in parser. (gh pr #22, issue #21) - Fix bug in rrule introduced in 2.4.0 where byweekday parameter was not handled properly. (gh pr #35, issue #34) - Fix error where parser allowed some invalid dates, overwriting existing hours with the last 2-digit number in the string. (gh pr #32, issue #31) - Fix and add test for Python 2.x compatibility with boolean checking of relativedelta objects. Implemented by @nimasmi (gh pr #43) and Cédric Krier (lp: 1035038) - Replaced parse() calls with explicit datetime objects in unit tests unrelated to parser. (gh pr #36) - Changed private _byxxx from sets to sorted tuples and fixed one currently unreachable bug in _construct_byset. (gh pr #54) - Additional documentation for parser (gh pr #29, #33, #41) and rrule. - Formatting fixes to documentation of rrule and README.rst. - Updated zoneinfo to 2015a. Version 2.4.0 ============= - Fix an issue with relativedelta and freezegun (lp:1374022) - Fix tzinfo in windows for timezones without dst (lp:1010050, gh #2) - Ignore missing timezones in windows like in POSIX - Fix minimal version requirement for six (gh #6) - Many rrule changes and fixes by @pganssle (gh pull requests #13 #14 #17), including defusing some infinite loops (gh #4) Version 2.3 =========== - Cleanup directory structure, moved test.py to dateutil/tests/test.py - Changed many aspects of dealing with the zone info file. Instead of a cache, all the zones are loaded to memory, but symbolic links are loaded only once, so not much memory is used. - The package is now zip-safe, and universal-wheelable, thanks to changes in the handling of the zoneinfo file. - Fixed tzwin silently not imported on windows python2 - New maintainer, together with new hosting: GitHub, Travis, Read-The-Docs Version 2.2 =========== - Updated zoneinfo to 2013h - fuzzy_with_tokens parse addon from Christopher Corley - Bug with LANG=C fixed by Mike Gilbert Version 2.1 =========== - New maintainer - Dateutil now works on Python 2.6, 2.7 and 3.2 from same codebase (with six) - #704047: Ismael Carnales' patch for a new time format - Small bug fixes, thanks for reporters! Version 2.0 =========== - Ported to Python 3, by Brian Jones. If you need dateutil for Python 2.X, please continue using the 1.X series. - There's no such thing as a "PSF License". This source code is now made available under the Simplified BSD license. See LICENSE for details. Version 1.5 =========== - As reported by Mathieu Bridon, rrules were matching the bysecond rules incorrectly against byminute in some circumstances when the SECONDLY frequency was in use, due to a copy & paste bug. The problem has been unittested and corrected. - Adam Ryan reported a problem in the relativedelta implementation which affected the yearday parameter in the month of January specifically. This has been unittested and fixed. - Updated timezone information. Version 1.4.1 ============= - Updated timezone information. Version 1.4 =========== - Fixed another parser precision problem on conversion of decimal seconds to microseconds, as reported by Erik Brown. Now these issues are gone for real since it's not using floating point arithmetic anymore. - Fixed case where tzrange.utcoffset and tzrange.dst() might fail due to a date being used where a datetime was expected (reported and fixed by Lennart Regebro). - Prevent tzstr from introducing daylight timings in strings that didn't specify them (reported by Lennart Regebro). - Calls like gettz("GMT+3") and gettz("UTC-2") will now return the expected values, instead of the TZ variable behavior. - Fixed DST signal handling in zoneinfo files. Reported by Nicholas F. Fabry and John-Mark Gurney. Version 1.3 =========== - Fixed precision problem on conversion of decimal seconds to microseconds, as reported by Skip Montanaro. - Fixed bug in constructor of parser, and converted parser classes to new-style classes. Original report and patch by Michael Elsdörfer. - Initialize tzid and comps in tz.py, to prevent the code from ever raising a NameError (even with broken files). Johan Dahlin suggested the fix after a pyflakes run. - Version is now published in dateutil.__version__, as requested by Darren Dale. - All code is compatible with new-style division. Version 1.2 =========== - Now tzfile will round timezones to full-minutes if necessary, since Python's datetime doesn't support sub-minute offsets. Thanks to Ilpo Nyyssönen for reporting the issue. - Removed bare string exceptions, as reported and fixed by Wilfredo Sánchez Vega. - Fix bug in leap count parsing (reported and fixed by Eugene Oden). Version 1.1 =========== - Fixed rrule byyearday handling. Abramo Bagnara pointed out that RFC2445 allows negative numbers. - Fixed --prefix handling in setup.py (by Sidnei da Silva). - Now tz.gettz() returns a tzlocal instance when not given any arguments and no other timezone information is found. - Updating timezone information to version 2005q. Version 1.0 =========== - Fixed parsing of XXhXXm formatted time after day/month/year has been parsed. - Added patch by Jeffrey Harris optimizing rrule.__contains__. Version 0.9 =========== - Fixed pickling of timezone types, as reported by Andreas Köhler. - Implemented internal timezone information with binary timezone files. datautil.tz.gettz() function will now try to use the system timezone files, and fallback to the internal versions. It's also possible to ask for the internal versions directly by using dateutil.zoneinfo.gettz(). - New tzwin timezone type, allowing access to Windows internal timezones (contributed by Jeffrey Harris). - Fixed parsing of unicode date strings. - Accept parserinfo instances as the parser constructor parameter, besides parserinfo (sub)classes. - Changed weekday to spell the not-set n value as None instead of 0. - Fixed other reported bugs. Version 0.5 =========== - Removed ``FREQ_`` prefix from rrule frequency constants WARNING: this breaks compatibility with previous versions. - Fixed rrule.between() for cases where "after" is achieved before even starting, as reported by Andreas Köhler. - Fixed two digit zero-year parsing (such as 31-Dec-00), as reported by Jim Abramson, and included test case for this. - Sort exdate and rdate before iterating over them, so that it's not necessary to sort them before adding to the rruleset, as reported by Nicholas Piper. ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1658728 python-dateutil-2.8.2/PKG-INFO0000644000175100001710000001777700000000000015335 0ustar00runnerdockerMetadata-Version: 2.1 Name: python-dateutil Version: 2.8.2 Summary: Extensions to the standard Python datetime module Home-page: https://github.com/dateutil/dateutil Author: Gustavo Niemeyer Author-email: gustavo@niemeyer.net Maintainer: Paul Ganssle Maintainer-email: dateutil@python.org License: Dual License Project-URL: Documentation, https://dateutil.readthedocs.io/en/stable/ Project-URL: Source, https://github.com/dateutil/dateutil Platform: UNKNOWN Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: BSD License Classifier: License :: OSI Approved :: Apache Software License Classifier: Programming Language :: Python Classifier: Programming Language :: Python :: 2 Classifier: Programming Language :: Python :: 2.7 Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.3 Classifier: Programming Language :: Python :: 3.4 Classifier: Programming Language :: Python :: 3.5 Classifier: Programming Language :: Python :: 3.6 Classifier: Programming Language :: Python :: 3.7 Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Topic :: Software Development :: Libraries Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,>=2.7 Description-Content-Type: text/x-rst License-File: LICENSE dateutil - powerful extensions to datetime ========================================== |pypi| |support| |licence| |gitter| |readthedocs| |travis| |appveyor| |pipelines| |coverage| .. |pypi| image:: https://img.shields.io/pypi/v/python-dateutil.svg?style=flat-square :target: https://pypi.org/project/python-dateutil/ :alt: pypi version .. |support| image:: https://img.shields.io/pypi/pyversions/python-dateutil.svg?style=flat-square :target: https://pypi.org/project/python-dateutil/ :alt: supported Python version .. |travis| image:: https://img.shields.io/travis/dateutil/dateutil/master.svg?style=flat-square&label=Travis%20Build :target: https://travis-ci.org/dateutil/dateutil :alt: travis build status .. |appveyor| image:: https://img.shields.io/appveyor/ci/dateutil/dateutil/master.svg?style=flat-square&logo=appveyor :target: https://ci.appveyor.com/project/dateutil/dateutil :alt: appveyor build status .. |pipelines| image:: https://dev.azure.com/pythondateutilazure/dateutil/_apis/build/status/dateutil.dateutil?branchName=master :target: https://dev.azure.com/pythondateutilazure/dateutil/_build/latest?definitionId=1&branchName=master :alt: azure pipelines build status .. |coverage| image:: https://codecov.io/gh/dateutil/dateutil/branch/master/graphs/badge.svg?branch=master :target: https://codecov.io/gh/dateutil/dateutil?branch=master :alt: Code coverage .. |gitter| image:: https://badges.gitter.im/dateutil/dateutil.svg :alt: Join the chat at https://gitter.im/dateutil/dateutil :target: https://gitter.im/dateutil/dateutil .. |licence| image:: https://img.shields.io/pypi/l/python-dateutil.svg?style=flat-square :target: https://pypi.org/project/python-dateutil/ :alt: licence .. |readthedocs| image:: https://img.shields.io/readthedocs/dateutil/latest.svg?style=flat-square&label=Read%20the%20Docs :alt: Read the documentation at https://dateutil.readthedocs.io/en/latest/ :target: https://dateutil.readthedocs.io/en/latest/ The `dateutil` module provides powerful extensions to the standard `datetime` module, available in Python. Installation ============ `dateutil` can be installed from PyPI using `pip` (note that the package name is different from the importable name):: pip install python-dateutil Download ======== dateutil is available on PyPI https://pypi.org/project/python-dateutil/ The documentation is hosted at: https://dateutil.readthedocs.io/en/stable/ Code ==== The code and issue tracker are hosted on GitHub: https://github.com/dateutil/dateutil/ Features ======== * Computing of relative deltas (next month, next year, next Monday, last week of month, etc); * Computing of relative deltas between two given date and/or datetime objects; * Computing of dates based on very flexible recurrence rules, using a superset of the `iCalendar `_ specification. Parsing of RFC strings is supported as well. * Generic parsing of dates in almost any string format; * Timezone (tzinfo) implementations for tzfile(5) format files (/etc/localtime, /usr/share/zoneinfo, etc), TZ environment string (in all known formats), iCalendar format files, given ranges (with help from relative deltas), local machine timezone, fixed offset timezone, UTC timezone, and Windows registry-based time zones. * Internal up-to-date world timezone information based on Olson's database. * Computing of Easter Sunday dates for any given year, using Western, Orthodox or Julian algorithms; * A comprehensive test suite. Quick example ============= Here's a snapshot, just to give an idea about the power of the package. For more examples, look at the documentation. Suppose you want to know how much time is left, in years/months/days/etc, before the next easter happening on a year with a Friday 13th in August, and you want to get today's date out of the "date" unix system command. Here is the code: .. code-block:: python3 >>> from dateutil.relativedelta import * >>> from dateutil.easter import * >>> from dateutil.rrule import * >>> from dateutil.parser import * >>> from datetime import * >>> now = parse("Sat Oct 11 17:13:46 UTC 2003") >>> today = now.date() >>> year = rrule(YEARLY,dtstart=now,bymonth=8,bymonthday=13,byweekday=FR)[0].year >>> rdelta = relativedelta(easter(year), today) >>> print("Today is: %s" % today) Today is: 2003-10-11 >>> print("Year with next Aug 13th on a Friday is: %s" % year) Year with next Aug 13th on a Friday is: 2004 >>> print("How far is the Easter of that year: %s" % rdelta) How far is the Easter of that year: relativedelta(months=+6) >>> print("And the Easter of that year is: %s" % (today+rdelta)) And the Easter of that year is: 2004-04-11 Being exactly 6 months ahead was **really** a coincidence :) Contributing ============ We welcome many types of contributions - bug reports, pull requests (code, infrastructure or documentation fixes). For more information about how to contribute to the project, see the ``CONTRIBUTING.md`` file in the repository. Author ====== The dateutil module was written by Gustavo Niemeyer in 2003. It is maintained by: * Gustavo Niemeyer 2003-2011 * Tomi Pieviläinen 2012-2014 * Yaron de Leeuw 2014-2016 * Paul Ganssle 2015- Starting with version 2.4.1 and running until 2.8.2, all source and binary distributions will be signed by a PGP key that has, at the very least, been signed by the key which made the previous release. A table of release signing keys can be found below: =========== ============================ Releases Signing key fingerprint =========== ============================ 2.4.1-2.8.2 `6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB`_ =========== ============================ New releases *may* have signed tags, but binary and source distributions uploaded to PyPI will no longer have GPG signatures attached. Contact ======= Our mailing list is available at `dateutil@python.org `_. As it is hosted by the PSF, it is subject to the `PSF code of conduct `_. License ======= All contributions after December 1, 2017 released under dual license - either `Apache 2.0 License `_ or the `BSD 3-Clause License `_. Contributions before December 1, 2017 - except those those explicitly relicensed - are released only under the BSD 3-Clause License. .. _6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB: https://pgp.mit.edu/pks/lookup?op=vindex&search=0xCD54FCE3D964BEFB ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/README.rst0000644000175100001710000001524300000000000015711 0ustar00runnerdockerdateutil - powerful extensions to datetime ========================================== |pypi| |support| |licence| |gitter| |readthedocs| |travis| |appveyor| |pipelines| |coverage| .. |pypi| image:: https://img.shields.io/pypi/v/python-dateutil.svg?style=flat-square :target: https://pypi.org/project/python-dateutil/ :alt: pypi version .. |support| image:: https://img.shields.io/pypi/pyversions/python-dateutil.svg?style=flat-square :target: https://pypi.org/project/python-dateutil/ :alt: supported Python version .. |travis| image:: https://img.shields.io/travis/dateutil/dateutil/master.svg?style=flat-square&label=Travis%20Build :target: https://travis-ci.org/dateutil/dateutil :alt: travis build status .. |appveyor| image:: https://img.shields.io/appveyor/ci/dateutil/dateutil/master.svg?style=flat-square&logo=appveyor :target: https://ci.appveyor.com/project/dateutil/dateutil :alt: appveyor build status .. |pipelines| image:: https://dev.azure.com/pythondateutilazure/dateutil/_apis/build/status/dateutil.dateutil?branchName=master :target: https://dev.azure.com/pythondateutilazure/dateutil/_build/latest?definitionId=1&branchName=master :alt: azure pipelines build status .. |coverage| image:: https://codecov.io/gh/dateutil/dateutil/branch/master/graphs/badge.svg?branch=master :target: https://codecov.io/gh/dateutil/dateutil?branch=master :alt: Code coverage .. |gitter| image:: https://badges.gitter.im/dateutil/dateutil.svg :alt: Join the chat at https://gitter.im/dateutil/dateutil :target: https://gitter.im/dateutil/dateutil .. |licence| image:: https://img.shields.io/pypi/l/python-dateutil.svg?style=flat-square :target: https://pypi.org/project/python-dateutil/ :alt: licence .. |readthedocs| image:: https://img.shields.io/readthedocs/dateutil/latest.svg?style=flat-square&label=Read%20the%20Docs :alt: Read the documentation at https://dateutil.readthedocs.io/en/latest/ :target: https://dateutil.readthedocs.io/en/latest/ The `dateutil` module provides powerful extensions to the standard `datetime` module, available in Python. Installation ============ `dateutil` can be installed from PyPI using `pip` (note that the package name is different from the importable name):: pip install python-dateutil Download ======== dateutil is available on PyPI https://pypi.org/project/python-dateutil/ The documentation is hosted at: https://dateutil.readthedocs.io/en/stable/ Code ==== The code and issue tracker are hosted on GitHub: https://github.com/dateutil/dateutil/ Features ======== * Computing of relative deltas (next month, next year, next Monday, last week of month, etc); * Computing of relative deltas between two given date and/or datetime objects; * Computing of dates based on very flexible recurrence rules, using a superset of the `iCalendar `_ specification. Parsing of RFC strings is supported as well. * Generic parsing of dates in almost any string format; * Timezone (tzinfo) implementations for tzfile(5) format files (/etc/localtime, /usr/share/zoneinfo, etc), TZ environment string (in all known formats), iCalendar format files, given ranges (with help from relative deltas), local machine timezone, fixed offset timezone, UTC timezone, and Windows registry-based time zones. * Internal up-to-date world timezone information based on Olson's database. * Computing of Easter Sunday dates for any given year, using Western, Orthodox or Julian algorithms; * A comprehensive test suite. Quick example ============= Here's a snapshot, just to give an idea about the power of the package. For more examples, look at the documentation. Suppose you want to know how much time is left, in years/months/days/etc, before the next easter happening on a year with a Friday 13th in August, and you want to get today's date out of the "date" unix system command. Here is the code: .. doctest:: readmeexample >>> from dateutil.relativedelta import * >>> from dateutil.easter import * >>> from dateutil.rrule import * >>> from dateutil.parser import * >>> from datetime import * >>> now = parse("Sat Oct 11 17:13:46 UTC 2003") >>> today = now.date() >>> year = rrule(YEARLY,dtstart=now,bymonth=8,bymonthday=13,byweekday=FR)[0].year >>> rdelta = relativedelta(easter(year), today) >>> print("Today is: %s" % today) Today is: 2003-10-11 >>> print("Year with next Aug 13th on a Friday is: %s" % year) Year with next Aug 13th on a Friday is: 2004 >>> print("How far is the Easter of that year: %s" % rdelta) How far is the Easter of that year: relativedelta(months=+6) >>> print("And the Easter of that year is: %s" % (today+rdelta)) And the Easter of that year is: 2004-04-11 Being exactly 6 months ahead was **really** a coincidence :) Contributing ============ We welcome many types of contributions - bug reports, pull requests (code, infrastructure or documentation fixes). For more information about how to contribute to the project, see the ``CONTRIBUTING.md`` file in the repository. Author ====== The dateutil module was written by Gustavo Niemeyer in 2003. It is maintained by: * Gustavo Niemeyer 2003-2011 * Tomi Pieviläinen 2012-2014 * Yaron de Leeuw 2014-2016 * Paul Ganssle 2015- Starting with version 2.4.1 and running until 2.8.2, all source and binary distributions will be signed by a PGP key that has, at the very least, been signed by the key which made the previous release. A table of release signing keys can be found below: =========== ============================ Releases Signing key fingerprint =========== ============================ 2.4.1-2.8.2 `6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB`_ =========== ============================ New releases *may* have signed tags, but binary and source distributions uploaded to PyPI will no longer have GPG signatures attached. Contact ======= Our mailing list is available at `dateutil@python.org `_. As it is hosted by the PSF, it is subject to the `PSF code of conduct `_. License ======= All contributions after December 1, 2017 released under dual license - either `Apache 2.0 License `_ or the `BSD 3-Clause License `_. Contributions before December 1, 2017 - except those those explicitly relicensed - are released only under the BSD 3-Clause License. .. _6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB: https://pgp.mit.edu/pks/lookup?op=vindex&search=0xCD54FCE3D964BEFB ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/RELEASING0000644000175100001710000000673000000000000015457 0ustar00runnerdockerRelease Checklist ----------------------------------------- [ ] Update classifiers in setup.cfg to include the latest supported Python versions. [ ] Update the metadata in zonefile_metadata.json to include the latest tzdata release from https://www.iana.org/time-zones. [ ] If necessary, update the tzdata mirror at https://github.com/dateutil/tzdata [ ] Update NEWS with list of changes: [ ] Invoke `tox -e news -- --version ` [ ] Make sure that only `template.rst` remains in changelog.d/ [ ] Manually clean up the new NEWS file. [ ] Replace entries in the "Misc" section that are not likely to be interesting to anyone consuming the package (e.g. changes to CI) with a reference to the Github PR. [ ] Commit the changes in git and make a pull request. [ ] Follow the "Releasing" steps below Optional: ---------- [ ] Check that README.rst is up-to-date. [ ] Check that the documentation builds correctly (cd docs, make html) Versioning ---------- Try and keep to a semantic versioning scheme (http://semver.org/). The versions are managed with `setuptools_scm`, so to update the version, simply tag the relevant commit with the new version number. Instructions ----------------------------------------- See the instructions at https://packaging.python.org/en/latest/distributing/ for more details. Building and Releasing ---------------------- Releasing is automated via the `publish.yml` GitHub Actions workflow. When a new tag is pushed to the repository, the project is automatically built and uploaded to Test PyPI. When the publish action is triggered manually (see https://docs.github.com/en/actions/managing-workflow-runs/manually-running-a-workflow for more details), the result is uploaded to PyPI. To make a release: 1. After having made a PR with all the relevant changes, trigger the "Upload package" to trigger an upload to Test PyPI. If desired, you can push a `.dev0` or `.rc0` tag first, so that all uploads will have a prefix for the *next* version rather than the previous version (e.g. if you are releasing `3.1.2`, without making a new tag releases will have a version like `3.1.1+gff8893e.d20220603`; if you push a `3.1.2.dev0` tag first, the version number will be `3.1.2.dev0`, and subsequent commits will be things like `3.1.2.dev0+fe9dacc4.d20220603`). 2. Check the Test PyPI page for `python-dateutil` to ensure that the dev release worked correctly: https://test.pypi.org/project/python-dateutil/ Dev releases may not appear as the default page, so click "Release history" and navigate to the release you are trying to check. Make sure that the metadata looks right and in particular that the `Requires` metadata is present. 4. If the release failed or was unsatisfactory in some way, make the required changes and got back to step 1. Pushing a new tag is not necessary. 5. When everything looks good, merge the release PR, pull the result to your local branch and create a new tag with a non-dev version number, e.g. `3.1.2`. Push this to the repository, wait for the Test PyPI run to trigger, and ensure that the upload worked. 6. Create a new GitHub release with the new entries from `NEWS` in the description. This will trigger the workflow to build and release the final version to PyPI.org. Check https://pypi.org/project/python-dateutil to ensure that everything worked correctly. 7. Delete any dev tags created during the testing process from your upstream and local branches. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/appveyor.yml0000644000175100001710000000223600000000000016610 0ustar00runnerdockerbuild: false environment: matrix: - PYTHON_VERSION: 34 platform: - x64 - x86 matrix: fast_finish: true exclude: - platform: x86 PYTHON_VERSION: 34 install: # set env variables - set TOXENV=py%PYTHON_VERSION% - if %PLATFORM% == "X64" (set PYTHON_PATH=C:\Python%PYTHON_VERSION%-x64) ELSE (set PYTHON_PATH=C:\Python%PYTHON_VERSION%) # Add PostgreSQL (zic), Python and scripts directory to current path - set PATH=%PYTHON_PATH%;c:\Program Files\PostgreSQL\9.3\bin\;%PATH% - set PYTHON=%PYTHON_PATH%/python.exe - "%PYTHON% -c \"import sys; print(sys.executable, sys.version)\"" # This frequently fails with network errors, so we'll retry it up to 5 times # with a 1 minute rate limit. - "%PYTHON% -m pip install six" - "ci_tools/retry.bat %PYTHON% updatezinfo.py" # This environment variable tells the test suite it's OK to mess with the time zone. - set DATEUTIL_MAY_CHANGE_TZ=1 - C:\Python36\python -m pip install -U tox test_script: - C:\Python36\scripts\tox after_test: # Uploading coverage on Python 3.4 on Windows is not worth the effort. - if NOT %PYTHON_VERSION% == 34 (C:\Python36\scripts\tox -e coverage,codecov) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/azure-pipelines.yml0000644000175100001710000000413600000000000020060 0ustar00runnerdockerpool: vmImage: $[ variables.POOL_IMAGE ] strategy: matrix: Python27: python.version: '2.7' Python34: python.version: '3.4' Python35: python.version: '3.5' Python36: python.version: '3.6' Python37: python.version: '3.7' Docs: python.version: '3.6' TOXENV: docs TZ: python.version: '3.6' TOXENV: tz macOS: python.version: '3.6' POOL_IMAGE: macos-10.13 Windows36: python.version: '3.6' POOL_IMAGE: vs2017-win2016 installzic: 'windows' PyPy: python.version: 'pypy2' PyPy3: python.version: 'pypy3' WindowsPyPy2: python.version: 'pypy2' POOL_IMAGE: vs2017-win2016 installzic: 'windows' WindowsPyPy3: python.version: 'pypy3' POOL_IMAGE: vs2017-win2016 installzic: 'windows' variables: TOXENV: py POOL_IMAGE: ubuntu-16.04 steps: - task: UsePythonVersion@0 inputs: versionSpec: $(python.version) - bash: | python -m pip install -U six && python -m pip install -U 'tox < 3.8.0' if [[ $PYTHON_VERSION == "3.3" ]]; then pip install 'virtualenv<16.0'; fi if [[ $PYTHON_VERSION == "3.3" ]]; then pip install 'setuptools<40.0'; fi displayName: Ensure prereqs - bash: | curl https://get.enterprisedb.com/postgresql/postgresql-9.4.20-1-windows-x64-binaries.zip --output postgresql.zip unzip -oq postgresql.zip -d postgresql echo $PATH echo "##vso[task.prependpath]$(System.DefaultWorkingDirectory)\postgresql\pgsql\bin" displayName: Install zic on Windows condition: eq(variables.installzic, 'windows') - bash: | if [[ $TOXENV == "py" ]]; then ./ci_tools/retry.sh python updatezinfo.py python -m tox -- dateutil/test --cov-config=tox.ini --cov=dateutil --junitxml=unittests/TEST-$(Agent.JobName).xml python -m tox -e coverage,codecov || true else python -m tox fi displayName: Run tox - task: PublishTestResults@2 inputs: testResultsFiles: '**/TEST-*.xml' testRunTitle: '$(Agent.JobName)' condition: and(succeededOrFailed(), not(eq(variables['Agent.JobName'], 'Docs'))) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1578727 python-dateutil-2.8.2/changelog.d/0000755000175100001710000000000000000000000016366 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/changelog.d/.gitignore0000644000175100001710000000000000000000000020344 0ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/changelog.d/template.rst0000644000175100001710000000120600000000000020732 0ustar00runnerdocker{% for section, _ in sections.items() %} {% set underline = underlines[0] %}{% if section %}{{section}} {{ underline * section|length }}{% set underline = underlines[1] %} {% endif %} {% if sections[section] %} {% for category, val in definitions.items() if category in sections[section]%} {{ definitions[category]['name'] }} {{ underline * definitions[category]['name']|length }} {% for text, values in sections[section][category].items() %} - {{ text }} {% endfor %} {% if sections[section][category]|length == 0 %} No significant changes. {% else %} {% endif %} {% endfor %} {% else %} No significant changes. {% endif %} {% endfor %} ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1578727 python-dateutil-2.8.2/ci_tools/0000755000175100001710000000000000000000000016030 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/ci_tools/make_zonefile_metadata.py0000755000175100001710000000276400000000000023066 0ustar00runnerdocker#!/usr/bin/env python3 import hashlib ZONEFILE_METADATA_TEMPLATE = """{{ "metadata_version": 2.0, "releases_url": [], "tzdata_file": "{tzdata_file}", "tzdata_file_sha512": "{tzdata_sha512}", "tzversion": "{tzdata_version}", "zonegroups": [ "africa", "antarctica", "asia", "australasia", "europe", "northamerica", "southamerica", "etcetera", "factory", "backzone", "backward" ] }} """ def calculate_sha512(fpath): with open(fpath, 'rb') as f: sha_hasher = hashlib.sha512() sha_hasher.update(f.read()) return sha_hasher.hexdigest() if __name__ == "__main__": import argparse parser = argparse.ArgumentParser() parser.add_argument('tzdata', metavar='TZDATA', help='The name tzdata tarball file') parser.add_argument('version', metavar='VERSION', help='The version of the tzdata tarball') parser.add_argument('out', metavar='OUT', nargs='?', default='zonefile_metadata.json', help='Where to write the file') args = parser.parse_args() tzdata = args.tzdata version = args.version sha512 = calculate_sha512(tzdata) metadata_file_text = ZONEFILE_METADATA_TEMPLATE.format( tzdata_file=tzdata, tzdata_version=version, tzdata_sha512=sha512, ) with open(args.out, 'w') as f: f.write(metadata_file_text) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/ci_tools/retry.bat0000644000175100001710000000073000000000000017665 0ustar00runnerdocker@echo off REM This script takes a command and retries it a few times if it fails, with a REM timeout between each retry. setlocal EnableDelayedExpansion REM Loop at most n_retries times, waiting sleep_time times between set sleep_time=60 set n_retries=5 for /l %%x in (1, 1, %n_retries%) do ( call %* if not ERRORLEVEL 1 EXIT /B 0 timeout /t %sleep_time% /nobreak > nul ) REM If it failed all n_retries times, we can give up at last. EXIT /B 1 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/ci_tools/retry.sh0000755000175100001710000000020500000000000017531 0ustar00runnerdocker#!/usr/bin/env bash sleep_time=60 n_retries=5 for i in `seq 1 $n_retries`; do "$@" && exit 0 sleep $sleep_time done exit 1 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/ci_tools/run_tz_master_env.sh0000755000175100001710000000412600000000000022136 0ustar00runnerdocker#!/usr/bin/env bash ### # Runs the 'tz' tox test environment, which builds the repo against the master # branch of the upstream tz database project. set -e TMP_DIR=${1} REPO_DIR=${2} ORIG_DIR=$(pwd) CITOOLS_DIR=$REPO_DIR/ci_tools REPO_TARBALL=${REPO_DIR}/dateutil/zoneinfo/dateutil-zoneinfo.tar.gz TMP_TARBALL=${TMP_DIR}/dateutil-zoneinfo.tar.gz UPSTREAM_URL="https://github.com/eggert/tz.git" if [ -n "$TF_BUILD" ]; then EXTRA_TEST_ARGS=--junitxml=../unittests/TEST-tz.xml fi function cleanup { # Since this script modifies the original repo, whether or not # it fails we need to restore the original file so as to not # overwrite the user's local changes. echo "Cleaning up." if [ -f $TMP_TARBALL ]; then cp -p $TMP_TARBALL $REPO_TARBALL fi } trap cleanup EXIT # Work in a temporary directory cd $TMP_DIR # Clone or update the repo DIR_EXISTS=false if [ -d tz ]; then cd tz if [[ $(git remote get-url origin) == ${UPSTREAM_URL} ]]; then git fetch origin master git reset --hard origin/master DIR_EXISTS=true else cd .. rm -rf tz fi fi if [ "$DIR_EXISTS" = false ]; then git clone ${UPSTREAM_URL} cd tz fi # Get the version make version VERSION=$(cat version) TARBALL_NAME=tzdata${VERSION}.tar.gz # Make the tzdata tarball - deactivate errors because # I don't know how to make just the .tar.gz and I don't # care if the others fail set +e make traditional_tarballs set -e mv $TARBALL_NAME $ORIG_DIR # Install everything else make ZFLAGS='-b fat' TOPDIR="$TMP_DIR/tzdir" install # # Make the zoneinfo tarball # cd $ORIG_DIR # Put the latest version of zic on the path PATH=$TMP_DIR/tzdir/usr/sbin:${PATH} # Stash the old zoneinfo file in the temporary directory mv $REPO_TARBALL $TMP_TARBALL # Make the metadata file ZONEFILE_METADATA_NAME=zonefile_metadata_master.json ${CITOOLS_DIR}/make_zonefile_metadata.py \ $TARBALL_NAME \ $VERSION \ $ZONEFILE_METADATA_NAME python ${REPO_DIR}/updatezinfo.py $ZONEFILE_METADATA_NAME # Run the tests python -m pytest ${REPO_DIR}/dateutil/test $EXTRA_TEST_ARGS ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/codecov.yml0000644000175100001710000000017000000000000016360 0ustar00runnerdockercoverage: status: patch: false changes: false project: default: target: '80' comment: false././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1618729 python-dateutil-2.8.2/dateutil/0000755000175100001710000000000000000000000016030 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/__init__.py0000644000175100001710000000033600000000000020143 0ustar00runnerdocker# -*- coding: utf-8 -*- try: from ._version import version as __version__ except ImportError: __version__ = 'unknown' __all__ = ['easter', 'parser', 'relativedelta', 'rrule', 'tz', 'utils', 'zoneinfo'] ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/_common.py0000644000175100001710000000164400000000000020036 0ustar00runnerdocker""" Common code used in multiple modules. """ class weekday(object): __slots__ = ["weekday", "n"] def __init__(self, weekday, n=None): self.weekday = weekday self.n = n def __call__(self, n): if n == self.n: return self else: return self.__class__(self.weekday, n) def __eq__(self, other): try: if self.weekday != other.weekday or self.n != other.n: return False except AttributeError: return False return True def __hash__(self): return hash(( self.weekday, self.n, )) def __ne__(self, other): return not (self == other) def __repr__(self): s = ("MO", "TU", "WE", "TH", "FR", "SA", "SU")[self.weekday] if not self.n: return s else: return "%s(%+d)" % (s, self.n) # vim:ts=4:sw=4:et ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250753.0 python-dateutil-2.8.2/dateutil/_version.py0000644000175100001710000000021600000000000020225 0ustar00runnerdocker# coding: utf-8 # file generated by setuptools_scm # don't change, don't track in version control version = '2.8.2' version_tuple = (2, 8, 2) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/easter.py0000644000175100001710000000516600000000000017675 0ustar00runnerdocker# -*- coding: utf-8 -*- """ This module offers a generic Easter computing method for any given year, using Western, Orthodox or Julian algorithms. """ import datetime __all__ = ["easter", "EASTER_JULIAN", "EASTER_ORTHODOX", "EASTER_WESTERN"] EASTER_JULIAN = 1 EASTER_ORTHODOX = 2 EASTER_WESTERN = 3 def easter(year, method=EASTER_WESTERN): """ This method was ported from the work done by GM Arts, on top of the algorithm by Claus Tondering, which was based in part on the algorithm of Ouding (1940), as quoted in "Explanatory Supplement to the Astronomical Almanac", P. Kenneth Seidelmann, editor. This algorithm implements three different Easter calculation methods: 1. Original calculation in Julian calendar, valid in dates after 326 AD 2. Original method, with date converted to Gregorian calendar, valid in years 1583 to 4099 3. Revised method, in Gregorian calendar, valid in years 1583 to 4099 as well These methods are represented by the constants: * ``EASTER_JULIAN = 1`` * ``EASTER_ORTHODOX = 2`` * ``EASTER_WESTERN = 3`` The default method is method 3. More about the algorithm may be found at: `GM Arts: Easter Algorithms `_ and `The Calendar FAQ: Easter `_ """ if not (1 <= method <= 3): raise ValueError("invalid method") # g - Golden year - 1 # c - Century # h - (23 - Epact) mod 30 # i - Number of days from March 21 to Paschal Full Moon # j - Weekday for PFM (0=Sunday, etc) # p - Number of days from March 21 to Sunday on or before PFM # (-6 to 28 methods 1 & 3, to 56 for method 2) # e - Extra days to add for method 2 (converting Julian # date to Gregorian date) y = year g = y % 19 e = 0 if method < 3: # Old method i = (19*g + 15) % 30 j = (y + y//4 + i) % 7 if method == 2: # Extra dates to convert Julian to Gregorian date e = 10 if y > 1600: e = e + y//100 - 16 - (y//100 - 16)//4 else: # New method c = y//100 h = (c - c//4 - (8*c + 13)//25 + 19*g + 15) % 30 i = h - (h//28)*(1 - (h//28)*(29//(h + 1))*((21 - g)//11)) j = (y + y//4 + i + 2 - c + c//4) % 7 # p can be from -6 to 56 corresponding to dates 22 March to 23 May # (later dates apply to method 2, although 23 May never actually occurs) p = i - j + e d = 1 + (p + 27 + (p + 6)//40) % 31 m = 3 + (p + 26)//30 return datetime.date(int(y), int(m), int(d)) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1618729 python-dateutil-2.8.2/dateutil/parser/0000755000175100001710000000000000000000000017324 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/parser/__init__.py0000644000175100001710000000334600000000000021443 0ustar00runnerdocker# -*- coding: utf-8 -*- from ._parser import parse, parser, parserinfo, ParserError from ._parser import DEFAULTPARSER, DEFAULTTZPARSER from ._parser import UnknownTimezoneWarning from ._parser import __doc__ from .isoparser import isoparser, isoparse __all__ = ['parse', 'parser', 'parserinfo', 'isoparse', 'isoparser', 'ParserError', 'UnknownTimezoneWarning'] ### # Deprecate portions of the private interface so that downstream code that # is improperly relying on it is given *some* notice. def __deprecated_private_func(f): from functools import wraps import warnings msg = ('{name} is a private function and may break without warning, ' 'it will be moved and or renamed in future versions.') msg = msg.format(name=f.__name__) @wraps(f) def deprecated_func(*args, **kwargs): warnings.warn(msg, DeprecationWarning) return f(*args, **kwargs) return deprecated_func def __deprecate_private_class(c): import warnings msg = ('{name} is a private class and may break without warning, ' 'it will be moved and or renamed in future versions.') msg = msg.format(name=c.__name__) class private_class(c): __doc__ = c.__doc__ def __init__(self, *args, **kwargs): warnings.warn(msg, DeprecationWarning) super(private_class, self).__init__(*args, **kwargs) private_class.__name__ = c.__name__ return private_class from ._parser import _timelex, _resultbase from ._parser import _tzparser, _parsetz _timelex = __deprecate_private_class(_timelex) _tzparser = __deprecate_private_class(_tzparser) _resultbase = __deprecate_private_class(_resultbase) _parsetz = __deprecated_private_func(_parsetz) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/parser/_parser.py0000644000175100001710000016265400000000000021347 0ustar00runnerdocker# -*- coding: utf-8 -*- """ This module offers a generic date/time string parser which is able to parse most known formats to represent a date and/or time. This module attempts to be forgiving with regards to unlikely input formats, returning a datetime object even for dates which are ambiguous. If an element of a date/time stamp is omitted, the following rules are applied: - If AM or PM is left unspecified, a 24-hour clock is assumed, however, an hour on a 12-hour clock (``0 <= hour <= 12``) *must* be specified if AM or PM is specified. - If a time zone is omitted, a timezone-naive datetime is returned. If any other elements are missing, they are taken from the :class:`datetime.datetime` object passed to the parameter ``default``. If this results in a day number exceeding the valid number of days per month, the value falls back to the end of the month. Additional resources about date/time string formats can be found below: - `A summary of the international standard date and time notation `_ - `W3C Date and Time Formats `_ - `Time Formats (Planetary Rings Node) `_ - `CPAN ParseDate module `_ - `Java SimpleDateFormat Class `_ """ from __future__ import unicode_literals import datetime import re import string import time import warnings from calendar import monthrange from io import StringIO import six from six import integer_types, text_type from decimal import Decimal from warnings import warn from .. import relativedelta from .. import tz __all__ = ["parse", "parserinfo", "ParserError"] # TODO: pandas.core.tools.datetimes imports this explicitly. Might be worth # making public and/or figuring out if there is something we can # take off their plate. class _timelex(object): # Fractional seconds are sometimes split by a comma _split_decimal = re.compile("([.,])") def __init__(self, instream): if isinstance(instream, (bytes, bytearray)): instream = instream.decode() if isinstance(instream, text_type): instream = StringIO(instream) elif getattr(instream, 'read', None) is None: raise TypeError('Parser must be a string or character stream, not ' '{itype}'.format(itype=instream.__class__.__name__)) self.instream = instream self.charstack = [] self.tokenstack = [] self.eof = False def get_token(self): """ This function breaks the time string into lexical units (tokens), which can be parsed by the parser. Lexical units are demarcated by changes in the character set, so any continuous string of letters is considered one unit, any continuous string of numbers is considered one unit. The main complication arises from the fact that dots ('.') can be used both as separators (e.g. "Sep.20.2009") or decimal points (e.g. "4:30:21.447"). As such, it is necessary to read the full context of any dot-separated strings before breaking it into tokens; as such, this function maintains a "token stack", for when the ambiguous context demands that multiple tokens be parsed at once. """ if self.tokenstack: return self.tokenstack.pop(0) seenletters = False token = None state = None while not self.eof: # We only realize that we've reached the end of a token when we # find a character that's not part of the current token - since # that character may be part of the next token, it's stored in the # charstack. if self.charstack: nextchar = self.charstack.pop(0) else: nextchar = self.instream.read(1) while nextchar == '\x00': nextchar = self.instream.read(1) if not nextchar: self.eof = True break elif not state: # First character of the token - determines if we're starting # to parse a word, a number or something else. token = nextchar if self.isword(nextchar): state = 'a' elif self.isnum(nextchar): state = '0' elif self.isspace(nextchar): token = ' ' break # emit token else: break # emit token elif state == 'a': # If we've already started reading a word, we keep reading # letters until we find something that's not part of a word. seenletters = True if self.isword(nextchar): token += nextchar elif nextchar == '.': token += nextchar state = 'a.' else: self.charstack.append(nextchar) break # emit token elif state == '0': # If we've already started reading a number, we keep reading # numbers until we find something that doesn't fit. if self.isnum(nextchar): token += nextchar elif nextchar == '.' or (nextchar == ',' and len(token) >= 2): token += nextchar state = '0.' else: self.charstack.append(nextchar) break # emit token elif state == 'a.': # If we've seen some letters and a dot separator, continue # parsing, and the tokens will be broken up later. seenletters = True if nextchar == '.' or self.isword(nextchar): token += nextchar elif self.isnum(nextchar) and token[-1] == '.': token += nextchar state = '0.' else: self.charstack.append(nextchar) break # emit token elif state == '0.': # If we've seen at least one dot separator, keep going, we'll # break up the tokens later. if nextchar == '.' or self.isnum(nextchar): token += nextchar elif self.isword(nextchar) and token[-1] == '.': token += nextchar state = 'a.' else: self.charstack.append(nextchar) break # emit token if (state in ('a.', '0.') and (seenletters or token.count('.') > 1 or token[-1] in '.,')): l = self._split_decimal.split(token) token = l[0] for tok in l[1:]: if tok: self.tokenstack.append(tok) if state == '0.' and token.count('.') == 0: token = token.replace(',', '.') return token def __iter__(self): return self def __next__(self): token = self.get_token() if token is None: raise StopIteration return token def next(self): return self.__next__() # Python 2.x support @classmethod def split(cls, s): return list(cls(s)) @classmethod def isword(cls, nextchar): """ Whether or not the next character is part of a word """ return nextchar.isalpha() @classmethod def isnum(cls, nextchar): """ Whether the next character is part of a number """ return nextchar.isdigit() @classmethod def isspace(cls, nextchar): """ Whether the next character is whitespace """ return nextchar.isspace() class _resultbase(object): def __init__(self): for attr in self.__slots__: setattr(self, attr, None) def _repr(self, classname): l = [] for attr in self.__slots__: value = getattr(self, attr) if value is not None: l.append("%s=%s" % (attr, repr(value))) return "%s(%s)" % (classname, ", ".join(l)) def __len__(self): return (sum(getattr(self, attr) is not None for attr in self.__slots__)) def __repr__(self): return self._repr(self.__class__.__name__) class parserinfo(object): """ Class which handles what inputs are accepted. Subclass this to customize the language and acceptable values for each parameter. :param dayfirst: Whether to interpret the first value in an ambiguous 3-integer date (e.g. 01/05/09) as the day (``True``) or month (``False``). If ``yearfirst`` is set to ``True``, this distinguishes between YDM and YMD. Default is ``False``. :param yearfirst: Whether to interpret the first value in an ambiguous 3-integer date (e.g. 01/05/09) as the year. If ``True``, the first number is taken to be the year, otherwise the last number is taken to be the year. Default is ``False``. """ # m from a.m/p.m, t from ISO T separator JUMP = [" ", ".", ",", ";", "-", "/", "'", "at", "on", "and", "ad", "m", "t", "of", "st", "nd", "rd", "th"] WEEKDAYS = [("Mon", "Monday"), ("Tue", "Tuesday"), # TODO: "Tues" ("Wed", "Wednesday"), ("Thu", "Thursday"), # TODO: "Thurs" ("Fri", "Friday"), ("Sat", "Saturday"), ("Sun", "Sunday")] MONTHS = [("Jan", "January"), ("Feb", "February"), # TODO: "Febr" ("Mar", "March"), ("Apr", "April"), ("May", "May"), ("Jun", "June"), ("Jul", "July"), ("Aug", "August"), ("Sep", "Sept", "September"), ("Oct", "October"), ("Nov", "November"), ("Dec", "December")] HMS = [("h", "hour", "hours"), ("m", "minute", "minutes"), ("s", "second", "seconds")] AMPM = [("am", "a"), ("pm", "p")] UTCZONE = ["UTC", "GMT", "Z", "z"] PERTAIN = ["of"] TZOFFSET = {} # TODO: ERA = ["AD", "BC", "CE", "BCE", "Stardate", # "Anno Domini", "Year of Our Lord"] def __init__(self, dayfirst=False, yearfirst=False): self._jump = self._convert(self.JUMP) self._weekdays = self._convert(self.WEEKDAYS) self._months = self._convert(self.MONTHS) self._hms = self._convert(self.HMS) self._ampm = self._convert(self.AMPM) self._utczone = self._convert(self.UTCZONE) self._pertain = self._convert(self.PERTAIN) self.dayfirst = dayfirst self.yearfirst = yearfirst self._year = time.localtime().tm_year self._century = self._year // 100 * 100 def _convert(self, lst): dct = {} for i, v in enumerate(lst): if isinstance(v, tuple): for v in v: dct[v.lower()] = i else: dct[v.lower()] = i return dct def jump(self, name): return name.lower() in self._jump def weekday(self, name): try: return self._weekdays[name.lower()] except KeyError: pass return None def month(self, name): try: return self._months[name.lower()] + 1 except KeyError: pass return None def hms(self, name): try: return self._hms[name.lower()] except KeyError: return None def ampm(self, name): try: return self._ampm[name.lower()] except KeyError: return None def pertain(self, name): return name.lower() in self._pertain def utczone(self, name): return name.lower() in self._utczone def tzoffset(self, name): if name in self._utczone: return 0 return self.TZOFFSET.get(name) def convertyear(self, year, century_specified=False): """ Converts two-digit years to year within [-50, 49] range of self._year (current local time) """ # Function contract is that the year is always positive assert year >= 0 if year < 100 and not century_specified: # assume current century to start year += self._century if year >= self._year + 50: # if too far in future year -= 100 elif year < self._year - 50: # if too far in past year += 100 return year def validate(self, res): # move to info if res.year is not None: res.year = self.convertyear(res.year, res.century_specified) if ((res.tzoffset == 0 and not res.tzname) or (res.tzname == 'Z' or res.tzname == 'z')): res.tzname = "UTC" res.tzoffset = 0 elif res.tzoffset != 0 and res.tzname and self.utczone(res.tzname): res.tzoffset = 0 return True class _ymd(list): def __init__(self, *args, **kwargs): super(self.__class__, self).__init__(*args, **kwargs) self.century_specified = False self.dstridx = None self.mstridx = None self.ystridx = None @property def has_year(self): return self.ystridx is not None @property def has_month(self): return self.mstridx is not None @property def has_day(self): return self.dstridx is not None def could_be_day(self, value): if self.has_day: return False elif not self.has_month: return 1 <= value <= 31 elif not self.has_year: # Be permissive, assume leap year month = self[self.mstridx] return 1 <= value <= monthrange(2000, month)[1] else: month = self[self.mstridx] year = self[self.ystridx] return 1 <= value <= monthrange(year, month)[1] def append(self, val, label=None): if hasattr(val, '__len__'): if val.isdigit() and len(val) > 2: self.century_specified = True if label not in [None, 'Y']: # pragma: no cover raise ValueError(label) label = 'Y' elif val > 100: self.century_specified = True if label not in [None, 'Y']: # pragma: no cover raise ValueError(label) label = 'Y' super(self.__class__, self).append(int(val)) if label == 'M': if self.has_month: raise ValueError('Month is already set') self.mstridx = len(self) - 1 elif label == 'D': if self.has_day: raise ValueError('Day is already set') self.dstridx = len(self) - 1 elif label == 'Y': if self.has_year: raise ValueError('Year is already set') self.ystridx = len(self) - 1 def _resolve_from_stridxs(self, strids): """ Try to resolve the identities of year/month/day elements using ystridx, mstridx, and dstridx, if enough of these are specified. """ if len(self) == 3 and len(strids) == 2: # we can back out the remaining stridx value missing = [x for x in range(3) if x not in strids.values()] key = [x for x in ['y', 'm', 'd'] if x not in strids] assert len(missing) == len(key) == 1 key = key[0] val = missing[0] strids[key] = val assert len(self) == len(strids) # otherwise this should not be called out = {key: self[strids[key]] for key in strids} return (out.get('y'), out.get('m'), out.get('d')) def resolve_ymd(self, yearfirst, dayfirst): len_ymd = len(self) year, month, day = (None, None, None) strids = (('y', self.ystridx), ('m', self.mstridx), ('d', self.dstridx)) strids = {key: val for key, val in strids if val is not None} if (len(self) == len(strids) > 0 or (len(self) == 3 and len(strids) == 2)): return self._resolve_from_stridxs(strids) mstridx = self.mstridx if len_ymd > 3: raise ValueError("More than three YMD values") elif len_ymd == 1 or (mstridx is not None and len_ymd == 2): # One member, or two members with a month string if mstridx is not None: month = self[mstridx] # since mstridx is 0 or 1, self[mstridx-1] always # looks up the other element other = self[mstridx - 1] else: other = self[0] if len_ymd > 1 or mstridx is None: if other > 31: year = other else: day = other elif len_ymd == 2: # Two members with numbers if self[0] > 31: # 99-01 year, month = self elif self[1] > 31: # 01-99 month, year = self elif dayfirst and self[1] <= 12: # 13-01 day, month = self else: # 01-13 month, day = self elif len_ymd == 3: # Three members if mstridx == 0: if self[1] > 31: # Apr-2003-25 month, year, day = self else: month, day, year = self elif mstridx == 1: if self[0] > 31 or (yearfirst and self[2] <= 31): # 99-Jan-01 year, month, day = self else: # 01-Jan-01 # Give precedence to day-first, since # two-digit years is usually hand-written. day, month, year = self elif mstridx == 2: # WTF!? if self[1] > 31: # 01-99-Jan day, year, month = self else: # 99-01-Jan year, day, month = self else: if (self[0] > 31 or self.ystridx == 0 or (yearfirst and self[1] <= 12 and self[2] <= 31)): # 99-01-01 if dayfirst and self[2] <= 12: year, day, month = self else: year, month, day = self elif self[0] > 12 or (dayfirst and self[1] <= 12): # 13-01-01 day, month, year = self else: # 01-13-01 month, day, year = self return year, month, day class parser(object): def __init__(self, info=None): self.info = info or parserinfo() def parse(self, timestr, default=None, ignoretz=False, tzinfos=None, **kwargs): """ Parse the date/time string into a :class:`datetime.datetime` object. :param timestr: Any date/time string using the supported formats. :param default: The default datetime object, if this is a datetime object and not ``None``, elements specified in ``timestr`` replace elements in the default object. :param ignoretz: If set ``True``, time zones in parsed strings are ignored and a naive :class:`datetime.datetime` object is returned. :param tzinfos: Additional time zone names / aliases which may be present in the string. This argument maps time zone names (and optionally offsets from those time zones) to time zones. This parameter can be a dictionary with timezone aliases mapping time zone names to time zones or a function taking two parameters (``tzname`` and ``tzoffset``) and returning a time zone. The timezones to which the names are mapped can be an integer offset from UTC in seconds or a :class:`tzinfo` object. .. doctest:: :options: +NORMALIZE_WHITESPACE >>> from dateutil.parser import parse >>> from dateutil.tz import gettz >>> tzinfos = {"BRST": -7200, "CST": gettz("America/Chicago")} >>> parse("2012-01-19 17:21:00 BRST", tzinfos=tzinfos) datetime.datetime(2012, 1, 19, 17, 21, tzinfo=tzoffset(u'BRST', -7200)) >>> parse("2012-01-19 17:21:00 CST", tzinfos=tzinfos) datetime.datetime(2012, 1, 19, 17, 21, tzinfo=tzfile('/usr/share/zoneinfo/America/Chicago')) This parameter is ignored if ``ignoretz`` is set. :param \\*\\*kwargs: Keyword arguments as passed to ``_parse()``. :return: Returns a :class:`datetime.datetime` object or, if the ``fuzzy_with_tokens`` option is ``True``, returns a tuple, the first element being a :class:`datetime.datetime` object, the second a tuple containing the fuzzy tokens. :raises ParserError: Raised for invalid or unknown string format, if the provided :class:`tzinfo` is not in a valid format, or if an invalid date would be created. :raises TypeError: Raised for non-string or character stream input. :raises OverflowError: Raised if the parsed date exceeds the largest valid C integer on your system. """ if default is None: default = datetime.datetime.now().replace(hour=0, minute=0, second=0, microsecond=0) res, skipped_tokens = self._parse(timestr, **kwargs) if res is None: raise ParserError("Unknown string format: %s", timestr) if len(res) == 0: raise ParserError("String does not contain a date: %s", timestr) try: ret = self._build_naive(res, default) except ValueError as e: six.raise_from(ParserError(str(e) + ": %s", timestr), e) if not ignoretz: ret = self._build_tzaware(ret, res, tzinfos) if kwargs.get('fuzzy_with_tokens', False): return ret, skipped_tokens else: return ret class _result(_resultbase): __slots__ = ["year", "month", "day", "weekday", "hour", "minute", "second", "microsecond", "tzname", "tzoffset", "ampm","any_unused_tokens"] def _parse(self, timestr, dayfirst=None, yearfirst=None, fuzzy=False, fuzzy_with_tokens=False): """ Private method which performs the heavy lifting of parsing, called from ``parse()``, which passes on its ``kwargs`` to this function. :param timestr: The string to parse. :param dayfirst: Whether to interpret the first value in an ambiguous 3-integer date (e.g. 01/05/09) as the day (``True``) or month (``False``). If ``yearfirst`` is set to ``True``, this distinguishes between YDM and YMD. If set to ``None``, this value is retrieved from the current :class:`parserinfo` object (which itself defaults to ``False``). :param yearfirst: Whether to interpret the first value in an ambiguous 3-integer date (e.g. 01/05/09) as the year. If ``True``, the first number is taken to be the year, otherwise the last number is taken to be the year. If this is set to ``None``, the value is retrieved from the current :class:`parserinfo` object (which itself defaults to ``False``). :param fuzzy: Whether to allow fuzzy parsing, allowing for string like "Today is January 1, 2047 at 8:21:00AM". :param fuzzy_with_tokens: If ``True``, ``fuzzy`` is automatically set to True, and the parser will return a tuple where the first element is the parsed :class:`datetime.datetime` datetimestamp and the second element is a tuple containing the portions of the string which were ignored: .. doctest:: >>> from dateutil.parser import parse >>> parse("Today is January 1, 2047 at 8:21:00AM", fuzzy_with_tokens=True) (datetime.datetime(2047, 1, 1, 8, 21), (u'Today is ', u' ', u'at ')) """ if fuzzy_with_tokens: fuzzy = True info = self.info if dayfirst is None: dayfirst = info.dayfirst if yearfirst is None: yearfirst = info.yearfirst res = self._result() l = _timelex.split(timestr) # Splits the timestr into tokens skipped_idxs = [] # year/month/day list ymd = _ymd() len_l = len(l) i = 0 try: while i < len_l: # Check if it's a number value_repr = l[i] try: value = float(value_repr) except ValueError: value = None if value is not None: # Numeric token i = self._parse_numeric_token(l, i, info, ymd, res, fuzzy) # Check weekday elif info.weekday(l[i]) is not None: value = info.weekday(l[i]) res.weekday = value # Check month name elif info.month(l[i]) is not None: value = info.month(l[i]) ymd.append(value, 'M') if i + 1 < len_l: if l[i + 1] in ('-', '/'): # Jan-01[-99] sep = l[i + 1] ymd.append(l[i + 2]) if i + 3 < len_l and l[i + 3] == sep: # Jan-01-99 ymd.append(l[i + 4]) i += 2 i += 2 elif (i + 4 < len_l and l[i + 1] == l[i + 3] == ' ' and info.pertain(l[i + 2])): # Jan of 01 # In this case, 01 is clearly year if l[i + 4].isdigit(): # Convert it here to become unambiguous value = int(l[i + 4]) year = str(info.convertyear(value)) ymd.append(year, 'Y') else: # Wrong guess pass # TODO: not hit in tests i += 4 # Check am/pm elif info.ampm(l[i]) is not None: value = info.ampm(l[i]) val_is_ampm = self._ampm_valid(res.hour, res.ampm, fuzzy) if val_is_ampm: res.hour = self._adjust_ampm(res.hour, value) res.ampm = value elif fuzzy: skipped_idxs.append(i) # Check for a timezone name elif self._could_be_tzname(res.hour, res.tzname, res.tzoffset, l[i]): res.tzname = l[i] res.tzoffset = info.tzoffset(res.tzname) # Check for something like GMT+3, or BRST+3. Notice # that it doesn't mean "I am 3 hours after GMT", but # "my time +3 is GMT". If found, we reverse the # logic so that timezone parsing code will get it # right. if i + 1 < len_l and l[i + 1] in ('+', '-'): l[i + 1] = ('+', '-')[l[i + 1] == '+'] res.tzoffset = None if info.utczone(res.tzname): # With something like GMT+3, the timezone # is *not* GMT. res.tzname = None # Check for a numbered timezone elif res.hour is not None and l[i] in ('+', '-'): signal = (-1, 1)[l[i] == '+'] len_li = len(l[i + 1]) # TODO: check that l[i + 1] is integer? if len_li == 4: # -0300 hour_offset = int(l[i + 1][:2]) min_offset = int(l[i + 1][2:]) elif i + 2 < len_l and l[i + 2] == ':': # -03:00 hour_offset = int(l[i + 1]) min_offset = int(l[i + 3]) # TODO: Check that l[i+3] is minute-like? i += 2 elif len_li <= 2: # -[0]3 hour_offset = int(l[i + 1][:2]) min_offset = 0 else: raise ValueError(timestr) res.tzoffset = signal * (hour_offset * 3600 + min_offset * 60) # Look for a timezone name between parenthesis if (i + 5 < len_l and info.jump(l[i + 2]) and l[i + 3] == '(' and l[i + 5] == ')' and 3 <= len(l[i + 4]) and self._could_be_tzname(res.hour, res.tzname, None, l[i + 4])): # -0300 (BRST) res.tzname = l[i + 4] i += 4 i += 1 # Check jumps elif not (info.jump(l[i]) or fuzzy): raise ValueError(timestr) else: skipped_idxs.append(i) i += 1 # Process year/month/day year, month, day = ymd.resolve_ymd(yearfirst, dayfirst) res.century_specified = ymd.century_specified res.year = year res.month = month res.day = day except (IndexError, ValueError): return None, None if not info.validate(res): return None, None if fuzzy_with_tokens: skipped_tokens = self._recombine_skipped(l, skipped_idxs) return res, tuple(skipped_tokens) else: return res, None def _parse_numeric_token(self, tokens, idx, info, ymd, res, fuzzy): # Token is a number value_repr = tokens[idx] try: value = self._to_decimal(value_repr) except Exception as e: six.raise_from(ValueError('Unknown numeric token'), e) len_li = len(value_repr) len_l = len(tokens) if (len(ymd) == 3 and len_li in (2, 4) and res.hour is None and (idx + 1 >= len_l or (tokens[idx + 1] != ':' and info.hms(tokens[idx + 1]) is None))): # 19990101T23[59] s = tokens[idx] res.hour = int(s[:2]) if len_li == 4: res.minute = int(s[2:]) elif len_li == 6 or (len_li > 6 and tokens[idx].find('.') == 6): # YYMMDD or HHMMSS[.ss] s = tokens[idx] if not ymd and '.' not in tokens[idx]: ymd.append(s[:2]) ymd.append(s[2:4]) ymd.append(s[4:]) else: # 19990101T235959[.59] # TODO: Check if res attributes already set. res.hour = int(s[:2]) res.minute = int(s[2:4]) res.second, res.microsecond = self._parsems(s[4:]) elif len_li in (8, 12, 14): # YYYYMMDD s = tokens[idx] ymd.append(s[:4], 'Y') ymd.append(s[4:6]) ymd.append(s[6:8]) if len_li > 8: res.hour = int(s[8:10]) res.minute = int(s[10:12]) if len_li > 12: res.second = int(s[12:]) elif self._find_hms_idx(idx, tokens, info, allow_jump=True) is not None: # HH[ ]h or MM[ ]m or SS[.ss][ ]s hms_idx = self._find_hms_idx(idx, tokens, info, allow_jump=True) (idx, hms) = self._parse_hms(idx, tokens, info, hms_idx) if hms is not None: # TODO: checking that hour/minute/second are not # already set? self._assign_hms(res, value_repr, hms) elif idx + 2 < len_l and tokens[idx + 1] == ':': # HH:MM[:SS[.ss]] res.hour = int(value) value = self._to_decimal(tokens[idx + 2]) # TODO: try/except for this? (res.minute, res.second) = self._parse_min_sec(value) if idx + 4 < len_l and tokens[idx + 3] == ':': res.second, res.microsecond = self._parsems(tokens[idx + 4]) idx += 2 idx += 2 elif idx + 1 < len_l and tokens[idx + 1] in ('-', '/', '.'): sep = tokens[idx + 1] ymd.append(value_repr) if idx + 2 < len_l and not info.jump(tokens[idx + 2]): if tokens[idx + 2].isdigit(): # 01-01[-01] ymd.append(tokens[idx + 2]) else: # 01-Jan[-01] value = info.month(tokens[idx + 2]) if value is not None: ymd.append(value, 'M') else: raise ValueError() if idx + 3 < len_l and tokens[idx + 3] == sep: # We have three members value = info.month(tokens[idx + 4]) if value is not None: ymd.append(value, 'M') else: ymd.append(tokens[idx + 4]) idx += 2 idx += 1 idx += 1 elif idx + 1 >= len_l or info.jump(tokens[idx + 1]): if idx + 2 < len_l and info.ampm(tokens[idx + 2]) is not None: # 12 am hour = int(value) res.hour = self._adjust_ampm(hour, info.ampm(tokens[idx + 2])) idx += 1 else: # Year, month or day ymd.append(value) idx += 1 elif info.ampm(tokens[idx + 1]) is not None and (0 <= value < 24): # 12am hour = int(value) res.hour = self._adjust_ampm(hour, info.ampm(tokens[idx + 1])) idx += 1 elif ymd.could_be_day(value): ymd.append(value) elif not fuzzy: raise ValueError() return idx def _find_hms_idx(self, idx, tokens, info, allow_jump): len_l = len(tokens) if idx+1 < len_l and info.hms(tokens[idx+1]) is not None: # There is an "h", "m", or "s" label following this token. We take # assign the upcoming label to the current token. # e.g. the "12" in 12h" hms_idx = idx + 1 elif (allow_jump and idx+2 < len_l and tokens[idx+1] == ' ' and info.hms(tokens[idx+2]) is not None): # There is a space and then an "h", "m", or "s" label. # e.g. the "12" in "12 h" hms_idx = idx + 2 elif idx > 0 and info.hms(tokens[idx-1]) is not None: # There is a "h", "m", or "s" preceding this token. Since neither # of the previous cases was hit, there is no label following this # token, so we use the previous label. # e.g. the "04" in "12h04" hms_idx = idx-1 elif (1 < idx == len_l-1 and tokens[idx-1] == ' ' and info.hms(tokens[idx-2]) is not None): # If we are looking at the final token, we allow for a # backward-looking check to skip over a space. # TODO: Are we sure this is the right condition here? hms_idx = idx - 2 else: hms_idx = None return hms_idx def _assign_hms(self, res, value_repr, hms): # See GH issue #427, fixing float rounding value = self._to_decimal(value_repr) if hms == 0: # Hour res.hour = int(value) if value % 1: res.minute = int(60*(value % 1)) elif hms == 1: (res.minute, res.second) = self._parse_min_sec(value) elif hms == 2: (res.second, res.microsecond) = self._parsems(value_repr) def _could_be_tzname(self, hour, tzname, tzoffset, token): return (hour is not None and tzname is None and tzoffset is None and len(token) <= 5 and (all(x in string.ascii_uppercase for x in token) or token in self.info.UTCZONE)) def _ampm_valid(self, hour, ampm, fuzzy): """ For fuzzy parsing, 'a' or 'am' (both valid English words) may erroneously trigger the AM/PM flag. Deal with that here. """ val_is_ampm = True # If there's already an AM/PM flag, this one isn't one. if fuzzy and ampm is not None: val_is_ampm = False # If AM/PM is found and hour is not, raise a ValueError if hour is None: if fuzzy: val_is_ampm = False else: raise ValueError('No hour specified with AM or PM flag.') elif not 0 <= hour <= 12: # If AM/PM is found, it's a 12 hour clock, so raise # an error for invalid range if fuzzy: val_is_ampm = False else: raise ValueError('Invalid hour specified for 12-hour clock.') return val_is_ampm def _adjust_ampm(self, hour, ampm): if hour < 12 and ampm == 1: hour += 12 elif hour == 12 and ampm == 0: hour = 0 return hour def _parse_min_sec(self, value): # TODO: Every usage of this function sets res.second to the return # value. Are there any cases where second will be returned as None and # we *don't* want to set res.second = None? minute = int(value) second = None sec_remainder = value % 1 if sec_remainder: second = int(60 * sec_remainder) return (minute, second) def _parse_hms(self, idx, tokens, info, hms_idx): # TODO: Is this going to admit a lot of false-positives for when we # just happen to have digits and "h", "m" or "s" characters in non-date # text? I guess hex hashes won't have that problem, but there's plenty # of random junk out there. if hms_idx is None: hms = None new_idx = idx elif hms_idx > idx: hms = info.hms(tokens[hms_idx]) new_idx = hms_idx else: # Looking backwards, increment one. hms = info.hms(tokens[hms_idx]) + 1 new_idx = idx return (new_idx, hms) # ------------------------------------------------------------------ # Handling for individual tokens. These are kept as methods instead # of functions for the sake of customizability via subclassing. def _parsems(self, value): """Parse a I[.F] seconds value into (seconds, microseconds).""" if "." not in value: return int(value), 0 else: i, f = value.split(".") return int(i), int(f.ljust(6, "0")[:6]) def _to_decimal(self, val): try: decimal_value = Decimal(val) # See GH 662, edge case, infinite value should not be converted # via `_to_decimal` if not decimal_value.is_finite(): raise ValueError("Converted decimal value is infinite or NaN") except Exception as e: msg = "Could not convert %s to decimal" % val six.raise_from(ValueError(msg), e) else: return decimal_value # ------------------------------------------------------------------ # Post-Parsing construction of datetime output. These are kept as # methods instead of functions for the sake of customizability via # subclassing. def _build_tzinfo(self, tzinfos, tzname, tzoffset): if callable(tzinfos): tzdata = tzinfos(tzname, tzoffset) else: tzdata = tzinfos.get(tzname) # handle case where tzinfo is paased an options that returns None # eg tzinfos = {'BRST' : None} if isinstance(tzdata, datetime.tzinfo) or tzdata is None: tzinfo = tzdata elif isinstance(tzdata, text_type): tzinfo = tz.tzstr(tzdata) elif isinstance(tzdata, integer_types): tzinfo = tz.tzoffset(tzname, tzdata) else: raise TypeError("Offset must be tzinfo subclass, tz string, " "or int offset.") return tzinfo def _build_tzaware(self, naive, res, tzinfos): if (callable(tzinfos) or (tzinfos and res.tzname in tzinfos)): tzinfo = self._build_tzinfo(tzinfos, res.tzname, res.tzoffset) aware = naive.replace(tzinfo=tzinfo) aware = self._assign_tzname(aware, res.tzname) elif res.tzname and res.tzname in time.tzname: aware = naive.replace(tzinfo=tz.tzlocal()) # Handle ambiguous local datetime aware = self._assign_tzname(aware, res.tzname) # This is mostly relevant for winter GMT zones parsed in the UK if (aware.tzname() != res.tzname and res.tzname in self.info.UTCZONE): aware = aware.replace(tzinfo=tz.UTC) elif res.tzoffset == 0: aware = naive.replace(tzinfo=tz.UTC) elif res.tzoffset: aware = naive.replace(tzinfo=tz.tzoffset(res.tzname, res.tzoffset)) elif not res.tzname and not res.tzoffset: # i.e. no timezone information was found. aware = naive elif res.tzname: # tz-like string was parsed but we don't know what to do # with it warnings.warn("tzname {tzname} identified but not understood. " "Pass `tzinfos` argument in order to correctly " "return a timezone-aware datetime. In a future " "version, this will raise an " "exception.".format(tzname=res.tzname), category=UnknownTimezoneWarning) aware = naive return aware def _build_naive(self, res, default): repl = {} for attr in ("year", "month", "day", "hour", "minute", "second", "microsecond"): value = getattr(res, attr) if value is not None: repl[attr] = value if 'day' not in repl: # If the default day exceeds the last day of the month, fall back # to the end of the month. cyear = default.year if res.year is None else res.year cmonth = default.month if res.month is None else res.month cday = default.day if res.day is None else res.day if cday > monthrange(cyear, cmonth)[1]: repl['day'] = monthrange(cyear, cmonth)[1] naive = default.replace(**repl) if res.weekday is not None and not res.day: naive = naive + relativedelta.relativedelta(weekday=res.weekday) return naive def _assign_tzname(self, dt, tzname): if dt.tzname() != tzname: new_dt = tz.enfold(dt, fold=1) if new_dt.tzname() == tzname: return new_dt return dt def _recombine_skipped(self, tokens, skipped_idxs): """ >>> tokens = ["foo", " ", "bar", " ", "19June2000", "baz"] >>> skipped_idxs = [0, 1, 2, 5] >>> _recombine_skipped(tokens, skipped_idxs) ["foo bar", "baz"] """ skipped_tokens = [] for i, idx in enumerate(sorted(skipped_idxs)): if i > 0 and idx - 1 == skipped_idxs[i - 1]: skipped_tokens[-1] = skipped_tokens[-1] + tokens[idx] else: skipped_tokens.append(tokens[idx]) return skipped_tokens DEFAULTPARSER = parser() def parse(timestr, parserinfo=None, **kwargs): """ Parse a string in one of the supported formats, using the ``parserinfo`` parameters. :param timestr: A string containing a date/time stamp. :param parserinfo: A :class:`parserinfo` object containing parameters for the parser. If ``None``, the default arguments to the :class:`parserinfo` constructor are used. The ``**kwargs`` parameter takes the following keyword arguments: :param default: The default datetime object, if this is a datetime object and not ``None``, elements specified in ``timestr`` replace elements in the default object. :param ignoretz: If set ``True``, time zones in parsed strings are ignored and a naive :class:`datetime` object is returned. :param tzinfos: Additional time zone names / aliases which may be present in the string. This argument maps time zone names (and optionally offsets from those time zones) to time zones. This parameter can be a dictionary with timezone aliases mapping time zone names to time zones or a function taking two parameters (``tzname`` and ``tzoffset``) and returning a time zone. The timezones to which the names are mapped can be an integer offset from UTC in seconds or a :class:`tzinfo` object. .. doctest:: :options: +NORMALIZE_WHITESPACE >>> from dateutil.parser import parse >>> from dateutil.tz import gettz >>> tzinfos = {"BRST": -7200, "CST": gettz("America/Chicago")} >>> parse("2012-01-19 17:21:00 BRST", tzinfos=tzinfos) datetime.datetime(2012, 1, 19, 17, 21, tzinfo=tzoffset(u'BRST', -7200)) >>> parse("2012-01-19 17:21:00 CST", tzinfos=tzinfos) datetime.datetime(2012, 1, 19, 17, 21, tzinfo=tzfile('/usr/share/zoneinfo/America/Chicago')) This parameter is ignored if ``ignoretz`` is set. :param dayfirst: Whether to interpret the first value in an ambiguous 3-integer date (e.g. 01/05/09) as the day (``True``) or month (``False``). If ``yearfirst`` is set to ``True``, this distinguishes between YDM and YMD. If set to ``None``, this value is retrieved from the current :class:`parserinfo` object (which itself defaults to ``False``). :param yearfirst: Whether to interpret the first value in an ambiguous 3-integer date (e.g. 01/05/09) as the year. If ``True``, the first number is taken to be the year, otherwise the last number is taken to be the year. If this is set to ``None``, the value is retrieved from the current :class:`parserinfo` object (which itself defaults to ``False``). :param fuzzy: Whether to allow fuzzy parsing, allowing for string like "Today is January 1, 2047 at 8:21:00AM". :param fuzzy_with_tokens: If ``True``, ``fuzzy`` is automatically set to True, and the parser will return a tuple where the first element is the parsed :class:`datetime.datetime` datetimestamp and the second element is a tuple containing the portions of the string which were ignored: .. doctest:: >>> from dateutil.parser import parse >>> parse("Today is January 1, 2047 at 8:21:00AM", fuzzy_with_tokens=True) (datetime.datetime(2047, 1, 1, 8, 21), (u'Today is ', u' ', u'at ')) :return: Returns a :class:`datetime.datetime` object or, if the ``fuzzy_with_tokens`` option is ``True``, returns a tuple, the first element being a :class:`datetime.datetime` object, the second a tuple containing the fuzzy tokens. :raises ParserError: Raised for invalid or unknown string formats, if the provided :class:`tzinfo` is not in a valid format, or if an invalid date would be created. :raises OverflowError: Raised if the parsed date exceeds the largest valid C integer on your system. """ if parserinfo: return parser(parserinfo).parse(timestr, **kwargs) else: return DEFAULTPARSER.parse(timestr, **kwargs) class _tzparser(object): class _result(_resultbase): __slots__ = ["stdabbr", "stdoffset", "dstabbr", "dstoffset", "start", "end"] class _attr(_resultbase): __slots__ = ["month", "week", "weekday", "yday", "jyday", "day", "time"] def __repr__(self): return self._repr("") def __init__(self): _resultbase.__init__(self) self.start = self._attr() self.end = self._attr() def parse(self, tzstr): res = self._result() l = [x for x in re.split(r'([,:.]|[a-zA-Z]+|[0-9]+)',tzstr) if x] used_idxs = list() try: len_l = len(l) i = 0 while i < len_l: # BRST+3[BRDT[+2]] j = i while j < len_l and not [x for x in l[j] if x in "0123456789:,-+"]: j += 1 if j != i: if not res.stdabbr: offattr = "stdoffset" res.stdabbr = "".join(l[i:j]) else: offattr = "dstoffset" res.dstabbr = "".join(l[i:j]) for ii in range(j): used_idxs.append(ii) i = j if (i < len_l and (l[i] in ('+', '-') or l[i][0] in "0123456789")): if l[i] in ('+', '-'): # Yes, that's right. See the TZ variable # documentation. signal = (1, -1)[l[i] == '+'] used_idxs.append(i) i += 1 else: signal = -1 len_li = len(l[i]) if len_li == 4: # -0300 setattr(res, offattr, (int(l[i][:2]) * 3600 + int(l[i][2:]) * 60) * signal) elif i + 1 < len_l and l[i + 1] == ':': # -03:00 setattr(res, offattr, (int(l[i]) * 3600 + int(l[i + 2]) * 60) * signal) used_idxs.append(i) i += 2 elif len_li <= 2: # -[0]3 setattr(res, offattr, int(l[i][:2]) * 3600 * signal) else: return None used_idxs.append(i) i += 1 if res.dstabbr: break else: break if i < len_l: for j in range(i, len_l): if l[j] == ';': l[j] = ',' assert l[i] == ',' i += 1 if i >= len_l: pass elif (8 <= l.count(',') <= 9 and not [y for x in l[i:] if x != ',' for y in x if y not in "0123456789+-"]): # GMT0BST,3,0,30,3600,10,0,26,7200[,3600] for x in (res.start, res.end): x.month = int(l[i]) used_idxs.append(i) i += 2 if l[i] == '-': value = int(l[i + 1]) * -1 used_idxs.append(i) i += 1 else: value = int(l[i]) used_idxs.append(i) i += 2 if value: x.week = value x.weekday = (int(l[i]) - 1) % 7 else: x.day = int(l[i]) used_idxs.append(i) i += 2 x.time = int(l[i]) used_idxs.append(i) i += 2 if i < len_l: if l[i] in ('-', '+'): signal = (-1, 1)[l[i] == "+"] used_idxs.append(i) i += 1 else: signal = 1 used_idxs.append(i) res.dstoffset = (res.stdoffset + int(l[i]) * signal) # This was a made-up format that is not in normal use warn(('Parsed time zone "%s"' % tzstr) + 'is in a non-standard dateutil-specific format, which ' + 'is now deprecated; support for parsing this format ' + 'will be removed in future versions. It is recommended ' + 'that you switch to a standard format like the GNU ' + 'TZ variable format.', tz.DeprecatedTzFormatWarning) elif (l.count(',') == 2 and l[i:].count('/') <= 2 and not [y for x in l[i:] if x not in (',', '/', 'J', 'M', '.', '-', ':') for y in x if y not in "0123456789"]): for x in (res.start, res.end): if l[i] == 'J': # non-leap year day (1 based) used_idxs.append(i) i += 1 x.jyday = int(l[i]) elif l[i] == 'M': # month[-.]week[-.]weekday used_idxs.append(i) i += 1 x.month = int(l[i]) used_idxs.append(i) i += 1 assert l[i] in ('-', '.') used_idxs.append(i) i += 1 x.week = int(l[i]) if x.week == 5: x.week = -1 used_idxs.append(i) i += 1 assert l[i] in ('-', '.') used_idxs.append(i) i += 1 x.weekday = (int(l[i]) - 1) % 7 else: # year day (zero based) x.yday = int(l[i]) + 1 used_idxs.append(i) i += 1 if i < len_l and l[i] == '/': used_idxs.append(i) i += 1 # start time len_li = len(l[i]) if len_li == 4: # -0300 x.time = (int(l[i][:2]) * 3600 + int(l[i][2:]) * 60) elif i + 1 < len_l and l[i + 1] == ':': # -03:00 x.time = int(l[i]) * 3600 + int(l[i + 2]) * 60 used_idxs.append(i) i += 2 if i + 1 < len_l and l[i + 1] == ':': used_idxs.append(i) i += 2 x.time += int(l[i]) elif len_li <= 2: # -[0]3 x.time = (int(l[i][:2]) * 3600) else: return None used_idxs.append(i) i += 1 assert i == len_l or l[i] == ',' i += 1 assert i >= len_l except (IndexError, ValueError, AssertionError): return None unused_idxs = set(range(len_l)).difference(used_idxs) res.any_unused_tokens = not {l[n] for n in unused_idxs}.issubset({",",":"}) return res DEFAULTTZPARSER = _tzparser() def _parsetz(tzstr): return DEFAULTTZPARSER.parse(tzstr) class ParserError(ValueError): """Exception subclass used for any failure to parse a datetime string. This is a subclass of :py:exc:`ValueError`, and should be raised any time earlier versions of ``dateutil`` would have raised ``ValueError``. .. versionadded:: 2.8.1 """ def __str__(self): try: return self.args[0] % self.args[1:] except (TypeError, IndexError): return super(ParserError, self).__str__() def __repr__(self): args = ", ".join("'%s'" % arg for arg in self.args) return "%s(%s)" % (self.__class__.__name__, args) class UnknownTimezoneWarning(RuntimeWarning): """Raised when the parser finds a timezone it cannot parse into a tzinfo. .. versionadded:: 2.7.0 """ # vim:ts=4:sw=4:et ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/parser/isoparser.py0000644000175100001710000003167700000000000021723 0ustar00runnerdocker# -*- coding: utf-8 -*- """ This module offers a parser for ISO-8601 strings It is intended to support all valid date, time and datetime formats per the ISO-8601 specification. ..versionadded:: 2.7.0 """ from datetime import datetime, timedelta, time, date import calendar from dateutil import tz from functools import wraps import re import six __all__ = ["isoparse", "isoparser"] def _takes_ascii(f): @wraps(f) def func(self, str_in, *args, **kwargs): # If it's a stream, read the whole thing str_in = getattr(str_in, 'read', lambda: str_in)() # If it's unicode, turn it into bytes, since ISO-8601 only covers ASCII if isinstance(str_in, six.text_type): # ASCII is the same in UTF-8 try: str_in = str_in.encode('ascii') except UnicodeEncodeError as e: msg = 'ISO-8601 strings should contain only ASCII characters' six.raise_from(ValueError(msg), e) return f(self, str_in, *args, **kwargs) return func class isoparser(object): def __init__(self, sep=None): """ :param sep: A single character that separates date and time portions. If ``None``, the parser will accept any single character. For strict ISO-8601 adherence, pass ``'T'``. """ if sep is not None: if (len(sep) != 1 or ord(sep) >= 128 or sep in '0123456789'): raise ValueError('Separator must be a single, non-numeric ' + 'ASCII character') sep = sep.encode('ascii') self._sep = sep @_takes_ascii def isoparse(self, dt_str): """ Parse an ISO-8601 datetime string into a :class:`datetime.datetime`. An ISO-8601 datetime string consists of a date portion, followed optionally by a time portion - the date and time portions are separated by a single character separator, which is ``T`` in the official standard. Incomplete date formats (such as ``YYYY-MM``) may *not* be combined with a time portion. Supported date formats are: Common: - ``YYYY`` - ``YYYY-MM`` or ``YYYYMM`` - ``YYYY-MM-DD`` or ``YYYYMMDD`` Uncommon: - ``YYYY-Www`` or ``YYYYWww`` - ISO week (day defaults to 0) - ``YYYY-Www-D`` or ``YYYYWwwD`` - ISO week and day The ISO week and day numbering follows the same logic as :func:`datetime.date.isocalendar`. Supported time formats are: - ``hh`` - ``hh:mm`` or ``hhmm`` - ``hh:mm:ss`` or ``hhmmss`` - ``hh:mm:ss.ssssss`` (Up to 6 sub-second digits) Midnight is a special case for `hh`, as the standard supports both 00:00 and 24:00 as a representation. The decimal separator can be either a dot or a comma. .. caution:: Support for fractional components other than seconds is part of the ISO-8601 standard, but is not currently implemented in this parser. Supported time zone offset formats are: - `Z` (UTC) - `±HH:MM` - `±HHMM` - `±HH` Offsets will be represented as :class:`dateutil.tz.tzoffset` objects, with the exception of UTC, which will be represented as :class:`dateutil.tz.tzutc`. Time zone offsets equivalent to UTC (such as `+00:00`) will also be represented as :class:`dateutil.tz.tzutc`. :param dt_str: A string or stream containing only an ISO-8601 datetime string :return: Returns a :class:`datetime.datetime` representing the string. Unspecified components default to their lowest value. .. warning:: As of version 2.7.0, the strictness of the parser should not be considered a stable part of the contract. Any valid ISO-8601 string that parses correctly with the default settings will continue to parse correctly in future versions, but invalid strings that currently fail (e.g. ``2017-01-01T00:00+00:00:00``) are not guaranteed to continue failing in future versions if they encode a valid date. .. versionadded:: 2.7.0 """ components, pos = self._parse_isodate(dt_str) if len(dt_str) > pos: if self._sep is None or dt_str[pos:pos + 1] == self._sep: components += self._parse_isotime(dt_str[pos + 1:]) else: raise ValueError('String contains unknown ISO components') if len(components) > 3 and components[3] == 24: components[3] = 0 return datetime(*components) + timedelta(days=1) return datetime(*components) @_takes_ascii def parse_isodate(self, datestr): """ Parse the date portion of an ISO string. :param datestr: The string portion of an ISO string, without a separator :return: Returns a :class:`datetime.date` object """ components, pos = self._parse_isodate(datestr) if pos < len(datestr): raise ValueError('String contains unknown ISO ' + 'components: {!r}'.format(datestr.decode('ascii'))) return date(*components) @_takes_ascii def parse_isotime(self, timestr): """ Parse the time portion of an ISO string. :param timestr: The time portion of an ISO string, without a separator :return: Returns a :class:`datetime.time` object """ components = self._parse_isotime(timestr) if components[0] == 24: components[0] = 0 return time(*components) @_takes_ascii def parse_tzstr(self, tzstr, zero_as_utc=True): """ Parse a valid ISO time zone string. See :func:`isoparser.isoparse` for details on supported formats. :param tzstr: A string representing an ISO time zone offset :param zero_as_utc: Whether to return :class:`dateutil.tz.tzutc` for zero-offset zones :return: Returns :class:`dateutil.tz.tzoffset` for offsets and :class:`dateutil.tz.tzutc` for ``Z`` and (if ``zero_as_utc`` is specified) offsets equivalent to UTC. """ return self._parse_tzstr(tzstr, zero_as_utc=zero_as_utc) # Constants _DATE_SEP = b'-' _TIME_SEP = b':' _FRACTION_REGEX = re.compile(b'[\\.,]([0-9]+)') def _parse_isodate(self, dt_str): try: return self._parse_isodate_common(dt_str) except ValueError: return self._parse_isodate_uncommon(dt_str) def _parse_isodate_common(self, dt_str): len_str = len(dt_str) components = [1, 1, 1] if len_str < 4: raise ValueError('ISO string too short') # Year components[0] = int(dt_str[0:4]) pos = 4 if pos >= len_str: return components, pos has_sep = dt_str[pos:pos + 1] == self._DATE_SEP if has_sep: pos += 1 # Month if len_str - pos < 2: raise ValueError('Invalid common month') components[1] = int(dt_str[pos:pos + 2]) pos += 2 if pos >= len_str: if has_sep: return components, pos else: raise ValueError('Invalid ISO format') if has_sep: if dt_str[pos:pos + 1] != self._DATE_SEP: raise ValueError('Invalid separator in ISO string') pos += 1 # Day if len_str - pos < 2: raise ValueError('Invalid common day') components[2] = int(dt_str[pos:pos + 2]) return components, pos + 2 def _parse_isodate_uncommon(self, dt_str): if len(dt_str) < 4: raise ValueError('ISO string too short') # All ISO formats start with the year year = int(dt_str[0:4]) has_sep = dt_str[4:5] == self._DATE_SEP pos = 4 + has_sep # Skip '-' if it's there if dt_str[pos:pos + 1] == b'W': # YYYY-?Www-?D? pos += 1 weekno = int(dt_str[pos:pos + 2]) pos += 2 dayno = 1 if len(dt_str) > pos: if (dt_str[pos:pos + 1] == self._DATE_SEP) != has_sep: raise ValueError('Inconsistent use of dash separator') pos += has_sep dayno = int(dt_str[pos:pos + 1]) pos += 1 base_date = self._calculate_weekdate(year, weekno, dayno) else: # YYYYDDD or YYYY-DDD if len(dt_str) - pos < 3: raise ValueError('Invalid ordinal day') ordinal_day = int(dt_str[pos:pos + 3]) pos += 3 if ordinal_day < 1 or ordinal_day > (365 + calendar.isleap(year)): raise ValueError('Invalid ordinal day' + ' {} for year {}'.format(ordinal_day, year)) base_date = date(year, 1, 1) + timedelta(days=ordinal_day - 1) components = [base_date.year, base_date.month, base_date.day] return components, pos def _calculate_weekdate(self, year, week, day): """ Calculate the day of corresponding to the ISO year-week-day calendar. This function is effectively the inverse of :func:`datetime.date.isocalendar`. :param year: The year in the ISO calendar :param week: The week in the ISO calendar - range is [1, 53] :param day: The day in the ISO calendar - range is [1 (MON), 7 (SUN)] :return: Returns a :class:`datetime.date` """ if not 0 < week < 54: raise ValueError('Invalid week: {}'.format(week)) if not 0 < day < 8: # Range is 1-7 raise ValueError('Invalid weekday: {}'.format(day)) # Get week 1 for the specific year: jan_4 = date(year, 1, 4) # Week 1 always has January 4th in it week_1 = jan_4 - timedelta(days=jan_4.isocalendar()[2] - 1) # Now add the specific number of weeks and days to get what we want week_offset = (week - 1) * 7 + (day - 1) return week_1 + timedelta(days=week_offset) def _parse_isotime(self, timestr): len_str = len(timestr) components = [0, 0, 0, 0, None] pos = 0 comp = -1 if len_str < 2: raise ValueError('ISO time too short') has_sep = False while pos < len_str and comp < 5: comp += 1 if timestr[pos:pos + 1] in b'-+Zz': # Detect time zone boundary components[-1] = self._parse_tzstr(timestr[pos:]) pos = len_str break if comp == 1 and timestr[pos:pos+1] == self._TIME_SEP: has_sep = True pos += 1 elif comp == 2 and has_sep: if timestr[pos:pos+1] != self._TIME_SEP: raise ValueError('Inconsistent use of colon separator') pos += 1 if comp < 3: # Hour, minute, second components[comp] = int(timestr[pos:pos + 2]) pos += 2 if comp == 3: # Fraction of a second frac = self._FRACTION_REGEX.match(timestr[pos:]) if not frac: continue us_str = frac.group(1)[:6] # Truncate to microseconds components[comp] = int(us_str) * 10**(6 - len(us_str)) pos += len(frac.group()) if pos < len_str: raise ValueError('Unused components in ISO string') if components[0] == 24: # Standard supports 00:00 and 24:00 as representations of midnight if any(component != 0 for component in components[1:4]): raise ValueError('Hour may only be 24 at 24:00:00.000') return components def _parse_tzstr(self, tzstr, zero_as_utc=True): if tzstr == b'Z' or tzstr == b'z': return tz.UTC if len(tzstr) not in {3, 5, 6}: raise ValueError('Time zone offset must be 1, 3, 5 or 6 characters') if tzstr[0:1] == b'-': mult = -1 elif tzstr[0:1] == b'+': mult = 1 else: raise ValueError('Time zone offset requires sign') hours = int(tzstr[1:3]) if len(tzstr) == 3: minutes = 0 else: minutes = int(tzstr[(4 if tzstr[3:4] == self._TIME_SEP else 3):]) if zero_as_utc and hours == 0 and minutes == 0: return tz.UTC else: if minutes > 59: raise ValueError('Invalid minutes in time zone offset') if hours > 23: raise ValueError('Invalid hours in time zone offset') return tz.tzoffset(None, mult * (hours * 60 + minutes) * 60) DEFAULT_ISOPARSER = isoparser() isoparse = DEFAULT_ISOPARSER.isoparse ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/relativedelta.py0000644000175100001710000006051000000000000021231 0ustar00runnerdocker# -*- coding: utf-8 -*- import datetime import calendar import operator from math import copysign from six import integer_types from warnings import warn from ._common import weekday MO, TU, WE, TH, FR, SA, SU = weekdays = tuple(weekday(x) for x in range(7)) __all__ = ["relativedelta", "MO", "TU", "WE", "TH", "FR", "SA", "SU"] class relativedelta(object): """ The relativedelta type is designed to be applied to an existing datetime and can replace specific components of that datetime, or represents an interval of time. It is based on the specification of the excellent work done by M.-A. Lemburg in his `mx.DateTime `_ extension. However, notice that this type does *NOT* implement the same algorithm as his work. Do *NOT* expect it to behave like mx.DateTime's counterpart. There are two different ways to build a relativedelta instance. The first one is passing it two date/datetime classes:: relativedelta(datetime1, datetime2) The second one is passing it any number of the following keyword arguments:: relativedelta(arg1=x,arg2=y,arg3=z...) year, month, day, hour, minute, second, microsecond: Absolute information (argument is singular); adding or subtracting a relativedelta with absolute information does not perform an arithmetic operation, but rather REPLACES the corresponding value in the original datetime with the value(s) in relativedelta. years, months, weeks, days, hours, minutes, seconds, microseconds: Relative information, may be negative (argument is plural); adding or subtracting a relativedelta with relative information performs the corresponding arithmetic operation on the original datetime value with the information in the relativedelta. weekday: One of the weekday instances (MO, TU, etc) available in the relativedelta module. These instances may receive a parameter N, specifying the Nth weekday, which could be positive or negative (like MO(+1) or MO(-2)). Not specifying it is the same as specifying +1. You can also use an integer, where 0=MO. This argument is always relative e.g. if the calculated date is already Monday, using MO(1) or MO(-1) won't change the day. To effectively make it absolute, use it in combination with the day argument (e.g. day=1, MO(1) for first Monday of the month). leapdays: Will add given days to the date found, if year is a leap year, and the date found is post 28 of february. yearday, nlyearday: Set the yearday or the non-leap year day (jump leap days). These are converted to day/month/leapdays information. There are relative and absolute forms of the keyword arguments. The plural is relative, and the singular is absolute. For each argument in the order below, the absolute form is applied first (by setting each attribute to that value) and then the relative form (by adding the value to the attribute). The order of attributes considered when this relativedelta is added to a datetime is: 1. Year 2. Month 3. Day 4. Hours 5. Minutes 6. Seconds 7. Microseconds Finally, weekday is applied, using the rule described above. For example >>> from datetime import datetime >>> from dateutil.relativedelta import relativedelta, MO >>> dt = datetime(2018, 4, 9, 13, 37, 0) >>> delta = relativedelta(hours=25, day=1, weekday=MO(1)) >>> dt + delta datetime.datetime(2018, 4, 2, 14, 37) First, the day is set to 1 (the first of the month), then 25 hours are added, to get to the 2nd day and 14th hour, finally the weekday is applied, but since the 2nd is already a Monday there is no effect. """ def __init__(self, dt1=None, dt2=None, years=0, months=0, days=0, leapdays=0, weeks=0, hours=0, minutes=0, seconds=0, microseconds=0, year=None, month=None, day=None, weekday=None, yearday=None, nlyearday=None, hour=None, minute=None, second=None, microsecond=None): if dt1 and dt2: # datetime is a subclass of date. So both must be date if not (isinstance(dt1, datetime.date) and isinstance(dt2, datetime.date)): raise TypeError("relativedelta only diffs datetime/date") # We allow two dates, or two datetimes, so we coerce them to be # of the same type if (isinstance(dt1, datetime.datetime) != isinstance(dt2, datetime.datetime)): if not isinstance(dt1, datetime.datetime): dt1 = datetime.datetime.fromordinal(dt1.toordinal()) elif not isinstance(dt2, datetime.datetime): dt2 = datetime.datetime.fromordinal(dt2.toordinal()) self.years = 0 self.months = 0 self.days = 0 self.leapdays = 0 self.hours = 0 self.minutes = 0 self.seconds = 0 self.microseconds = 0 self.year = None self.month = None self.day = None self.weekday = None self.hour = None self.minute = None self.second = None self.microsecond = None self._has_time = 0 # Get year / month delta between the two months = (dt1.year - dt2.year) * 12 + (dt1.month - dt2.month) self._set_months(months) # Remove the year/month delta so the timedelta is just well-defined # time units (seconds, days and microseconds) dtm = self.__radd__(dt2) # If we've overshot our target, make an adjustment if dt1 < dt2: compare = operator.gt increment = 1 else: compare = operator.lt increment = -1 while compare(dt1, dtm): months += increment self._set_months(months) dtm = self.__radd__(dt2) # Get the timedelta between the "months-adjusted" date and dt1 delta = dt1 - dtm self.seconds = delta.seconds + delta.days * 86400 self.microseconds = delta.microseconds else: # Check for non-integer values in integer-only quantities if any(x is not None and x != int(x) for x in (years, months)): raise ValueError("Non-integer years and months are " "ambiguous and not currently supported.") # Relative information self.years = int(years) self.months = int(months) self.days = days + weeks * 7 self.leapdays = leapdays self.hours = hours self.minutes = minutes self.seconds = seconds self.microseconds = microseconds # Absolute information self.year = year self.month = month self.day = day self.hour = hour self.minute = minute self.second = second self.microsecond = microsecond if any(x is not None and int(x) != x for x in (year, month, day, hour, minute, second, microsecond)): # For now we'll deprecate floats - later it'll be an error. warn("Non-integer value passed as absolute information. " + "This is not a well-defined condition and will raise " + "errors in future versions.", DeprecationWarning) if isinstance(weekday, integer_types): self.weekday = weekdays[weekday] else: self.weekday = weekday yday = 0 if nlyearday: yday = nlyearday elif yearday: yday = yearday if yearday > 59: self.leapdays = -1 if yday: ydayidx = [31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 366] for idx, ydays in enumerate(ydayidx): if yday <= ydays: self.month = idx+1 if idx == 0: self.day = yday else: self.day = yday-ydayidx[idx-1] break else: raise ValueError("invalid year day (%d)" % yday) self._fix() def _fix(self): if abs(self.microseconds) > 999999: s = _sign(self.microseconds) div, mod = divmod(self.microseconds * s, 1000000) self.microseconds = mod * s self.seconds += div * s if abs(self.seconds) > 59: s = _sign(self.seconds) div, mod = divmod(self.seconds * s, 60) self.seconds = mod * s self.minutes += div * s if abs(self.minutes) > 59: s = _sign(self.minutes) div, mod = divmod(self.minutes * s, 60) self.minutes = mod * s self.hours += div * s if abs(self.hours) > 23: s = _sign(self.hours) div, mod = divmod(self.hours * s, 24) self.hours = mod * s self.days += div * s if abs(self.months) > 11: s = _sign(self.months) div, mod = divmod(self.months * s, 12) self.months = mod * s self.years += div * s if (self.hours or self.minutes or self.seconds or self.microseconds or self.hour is not None or self.minute is not None or self.second is not None or self.microsecond is not None): self._has_time = 1 else: self._has_time = 0 @property def weeks(self): return int(self.days / 7.0) @weeks.setter def weeks(self, value): self.days = self.days - (self.weeks * 7) + value * 7 def _set_months(self, months): self.months = months if abs(self.months) > 11: s = _sign(self.months) div, mod = divmod(self.months * s, 12) self.months = mod * s self.years = div * s else: self.years = 0 def normalized(self): """ Return a version of this object represented entirely using integer values for the relative attributes. >>> relativedelta(days=1.5, hours=2).normalized() relativedelta(days=+1, hours=+14) :return: Returns a :class:`dateutil.relativedelta.relativedelta` object. """ # Cascade remainders down (rounding each to roughly nearest microsecond) days = int(self.days) hours_f = round(self.hours + 24 * (self.days - days), 11) hours = int(hours_f) minutes_f = round(self.minutes + 60 * (hours_f - hours), 10) minutes = int(minutes_f) seconds_f = round(self.seconds + 60 * (minutes_f - minutes), 8) seconds = int(seconds_f) microseconds = round(self.microseconds + 1e6 * (seconds_f - seconds)) # Constructor carries overflow back up with call to _fix() return self.__class__(years=self.years, months=self.months, days=days, hours=hours, minutes=minutes, seconds=seconds, microseconds=microseconds, leapdays=self.leapdays, year=self.year, month=self.month, day=self.day, weekday=self.weekday, hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond) def __add__(self, other): if isinstance(other, relativedelta): return self.__class__(years=other.years + self.years, months=other.months + self.months, days=other.days + self.days, hours=other.hours + self.hours, minutes=other.minutes + self.minutes, seconds=other.seconds + self.seconds, microseconds=(other.microseconds + self.microseconds), leapdays=other.leapdays or self.leapdays, year=(other.year if other.year is not None else self.year), month=(other.month if other.month is not None else self.month), day=(other.day if other.day is not None else self.day), weekday=(other.weekday if other.weekday is not None else self.weekday), hour=(other.hour if other.hour is not None else self.hour), minute=(other.minute if other.minute is not None else self.minute), second=(other.second if other.second is not None else self.second), microsecond=(other.microsecond if other.microsecond is not None else self.microsecond)) if isinstance(other, datetime.timedelta): return self.__class__(years=self.years, months=self.months, days=self.days + other.days, hours=self.hours, minutes=self.minutes, seconds=self.seconds + other.seconds, microseconds=self.microseconds + other.microseconds, leapdays=self.leapdays, year=self.year, month=self.month, day=self.day, weekday=self.weekday, hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond) if not isinstance(other, datetime.date): return NotImplemented elif self._has_time and not isinstance(other, datetime.datetime): other = datetime.datetime.fromordinal(other.toordinal()) year = (self.year or other.year)+self.years month = self.month or other.month if self.months: assert 1 <= abs(self.months) <= 12 month += self.months if month > 12: year += 1 month -= 12 elif month < 1: year -= 1 month += 12 day = min(calendar.monthrange(year, month)[1], self.day or other.day) repl = {"year": year, "month": month, "day": day} for attr in ["hour", "minute", "second", "microsecond"]: value = getattr(self, attr) if value is not None: repl[attr] = value days = self.days if self.leapdays and month > 2 and calendar.isleap(year): days += self.leapdays ret = (other.replace(**repl) + datetime.timedelta(days=days, hours=self.hours, minutes=self.minutes, seconds=self.seconds, microseconds=self.microseconds)) if self.weekday: weekday, nth = self.weekday.weekday, self.weekday.n or 1 jumpdays = (abs(nth) - 1) * 7 if nth > 0: jumpdays += (7 - ret.weekday() + weekday) % 7 else: jumpdays += (ret.weekday() - weekday) % 7 jumpdays *= -1 ret += datetime.timedelta(days=jumpdays) return ret def __radd__(self, other): return self.__add__(other) def __rsub__(self, other): return self.__neg__().__radd__(other) def __sub__(self, other): if not isinstance(other, relativedelta): return NotImplemented # In case the other object defines __rsub__ return self.__class__(years=self.years - other.years, months=self.months - other.months, days=self.days - other.days, hours=self.hours - other.hours, minutes=self.minutes - other.minutes, seconds=self.seconds - other.seconds, microseconds=self.microseconds - other.microseconds, leapdays=self.leapdays or other.leapdays, year=(self.year if self.year is not None else other.year), month=(self.month if self.month is not None else other.month), day=(self.day if self.day is not None else other.day), weekday=(self.weekday if self.weekday is not None else other.weekday), hour=(self.hour if self.hour is not None else other.hour), minute=(self.minute if self.minute is not None else other.minute), second=(self.second if self.second is not None else other.second), microsecond=(self.microsecond if self.microsecond is not None else other.microsecond)) def __abs__(self): return self.__class__(years=abs(self.years), months=abs(self.months), days=abs(self.days), hours=abs(self.hours), minutes=abs(self.minutes), seconds=abs(self.seconds), microseconds=abs(self.microseconds), leapdays=self.leapdays, year=self.year, month=self.month, day=self.day, weekday=self.weekday, hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond) def __neg__(self): return self.__class__(years=-self.years, months=-self.months, days=-self.days, hours=-self.hours, minutes=-self.minutes, seconds=-self.seconds, microseconds=-self.microseconds, leapdays=self.leapdays, year=self.year, month=self.month, day=self.day, weekday=self.weekday, hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond) def __bool__(self): return not (not self.years and not self.months and not self.days and not self.hours and not self.minutes and not self.seconds and not self.microseconds and not self.leapdays and self.year is None and self.month is None and self.day is None and self.weekday is None and self.hour is None and self.minute is None and self.second is None and self.microsecond is None) # Compatibility with Python 2.x __nonzero__ = __bool__ def __mul__(self, other): try: f = float(other) except TypeError: return NotImplemented return self.__class__(years=int(self.years * f), months=int(self.months * f), days=int(self.days * f), hours=int(self.hours * f), minutes=int(self.minutes * f), seconds=int(self.seconds * f), microseconds=int(self.microseconds * f), leapdays=self.leapdays, year=self.year, month=self.month, day=self.day, weekday=self.weekday, hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond) __rmul__ = __mul__ def __eq__(self, other): if not isinstance(other, relativedelta): return NotImplemented if self.weekday or other.weekday: if not self.weekday or not other.weekday: return False if self.weekday.weekday != other.weekday.weekday: return False n1, n2 = self.weekday.n, other.weekday.n if n1 != n2 and not ((not n1 or n1 == 1) and (not n2 or n2 == 1)): return False return (self.years == other.years and self.months == other.months and self.days == other.days and self.hours == other.hours and self.minutes == other.minutes and self.seconds == other.seconds and self.microseconds == other.microseconds and self.leapdays == other.leapdays and self.year == other.year and self.month == other.month and self.day == other.day and self.hour == other.hour and self.minute == other.minute and self.second == other.second and self.microsecond == other.microsecond) def __hash__(self): return hash(( self.weekday, self.years, self.months, self.days, self.hours, self.minutes, self.seconds, self.microseconds, self.leapdays, self.year, self.month, self.day, self.hour, self.minute, self.second, self.microsecond, )) def __ne__(self, other): return not self.__eq__(other) def __div__(self, other): try: reciprocal = 1 / float(other) except TypeError: return NotImplemented return self.__mul__(reciprocal) __truediv__ = __div__ def __repr__(self): l = [] for attr in ["years", "months", "days", "leapdays", "hours", "minutes", "seconds", "microseconds"]: value = getattr(self, attr) if value: l.append("{attr}={value:+g}".format(attr=attr, value=value)) for attr in ["year", "month", "day", "weekday", "hour", "minute", "second", "microsecond"]: value = getattr(self, attr) if value is not None: l.append("{attr}={value}".format(attr=attr, value=repr(value))) return "{classname}({attrs})".format(classname=self.__class__.__name__, attrs=", ".join(l)) def _sign(x): return int(copysign(1, x)) # vim:ts=4:sw=4:et ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/rrule.py0000644000175100001710000020177400000000000017546 0ustar00runnerdocker# -*- coding: utf-8 -*- """ The rrule module offers a small, complete, and very fast, implementation of the recurrence rules documented in the `iCalendar RFC `_, including support for caching of results. """ import calendar import datetime import heapq import itertools import re import sys from functools import wraps # For warning about deprecation of until and count from warnings import warn from six import advance_iterator, integer_types from six.moves import _thread, range from ._common import weekday as weekdaybase try: from math import gcd except ImportError: from fractions import gcd __all__ = ["rrule", "rruleset", "rrulestr", "YEARLY", "MONTHLY", "WEEKLY", "DAILY", "HOURLY", "MINUTELY", "SECONDLY", "MO", "TU", "WE", "TH", "FR", "SA", "SU"] # Every mask is 7 days longer to handle cross-year weekly periods. M366MASK = tuple([1]*31+[2]*29+[3]*31+[4]*30+[5]*31+[6]*30 + [7]*31+[8]*31+[9]*30+[10]*31+[11]*30+[12]*31+[1]*7) M365MASK = list(M366MASK) M29, M30, M31 = list(range(1, 30)), list(range(1, 31)), list(range(1, 32)) MDAY366MASK = tuple(M31+M29+M31+M30+M31+M30+M31+M31+M30+M31+M30+M31+M31[:7]) MDAY365MASK = list(MDAY366MASK) M29, M30, M31 = list(range(-29, 0)), list(range(-30, 0)), list(range(-31, 0)) NMDAY366MASK = tuple(M31+M29+M31+M30+M31+M30+M31+M31+M30+M31+M30+M31+M31[:7]) NMDAY365MASK = list(NMDAY366MASK) M366RANGE = (0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366) M365RANGE = (0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365) WDAYMASK = [0, 1, 2, 3, 4, 5, 6]*55 del M29, M30, M31, M365MASK[59], MDAY365MASK[59], NMDAY365MASK[31] MDAY365MASK = tuple(MDAY365MASK) M365MASK = tuple(M365MASK) FREQNAMES = ['YEARLY', 'MONTHLY', 'WEEKLY', 'DAILY', 'HOURLY', 'MINUTELY', 'SECONDLY'] (YEARLY, MONTHLY, WEEKLY, DAILY, HOURLY, MINUTELY, SECONDLY) = list(range(7)) # Imported on demand. easter = None parser = None class weekday(weekdaybase): """ This version of weekday does not allow n = 0. """ def __init__(self, wkday, n=None): if n == 0: raise ValueError("Can't create weekday with n==0") super(weekday, self).__init__(wkday, n) MO, TU, WE, TH, FR, SA, SU = weekdays = tuple(weekday(x) for x in range(7)) def _invalidates_cache(f): """ Decorator for rruleset methods which may invalidate the cached length. """ @wraps(f) def inner_func(self, *args, **kwargs): rv = f(self, *args, **kwargs) self._invalidate_cache() return rv return inner_func class rrulebase(object): def __init__(self, cache=False): if cache: self._cache = [] self._cache_lock = _thread.allocate_lock() self._invalidate_cache() else: self._cache = None self._cache_complete = False self._len = None def __iter__(self): if self._cache_complete: return iter(self._cache) elif self._cache is None: return self._iter() else: return self._iter_cached() def _invalidate_cache(self): if self._cache is not None: self._cache = [] self._cache_complete = False self._cache_gen = self._iter() if self._cache_lock.locked(): self._cache_lock.release() self._len = None def _iter_cached(self): i = 0 gen = self._cache_gen cache = self._cache acquire = self._cache_lock.acquire release = self._cache_lock.release while gen: if i == len(cache): acquire() if self._cache_complete: break try: for j in range(10): cache.append(advance_iterator(gen)) except StopIteration: self._cache_gen = gen = None self._cache_complete = True break release() yield cache[i] i += 1 while i < self._len: yield cache[i] i += 1 def __getitem__(self, item): if self._cache_complete: return self._cache[item] elif isinstance(item, slice): if item.step and item.step < 0: return list(iter(self))[item] else: return list(itertools.islice(self, item.start or 0, item.stop or sys.maxsize, item.step or 1)) elif item >= 0: gen = iter(self) try: for i in range(item+1): res = advance_iterator(gen) except StopIteration: raise IndexError return res else: return list(iter(self))[item] def __contains__(self, item): if self._cache_complete: return item in self._cache else: for i in self: if i == item: return True elif i > item: return False return False # __len__() introduces a large performance penalty. def count(self): """ Returns the number of recurrences in this set. It will have go trough the whole recurrence, if this hasn't been done before. """ if self._len is None: for x in self: pass return self._len def before(self, dt, inc=False): """ Returns the last recurrence before the given datetime instance. The inc keyword defines what happens if dt is an occurrence. With inc=True, if dt itself is an occurrence, it will be returned. """ if self._cache_complete: gen = self._cache else: gen = self last = None if inc: for i in gen: if i > dt: break last = i else: for i in gen: if i >= dt: break last = i return last def after(self, dt, inc=False): """ Returns the first recurrence after the given datetime instance. The inc keyword defines what happens if dt is an occurrence. With inc=True, if dt itself is an occurrence, it will be returned. """ if self._cache_complete: gen = self._cache else: gen = self if inc: for i in gen: if i >= dt: return i else: for i in gen: if i > dt: return i return None def xafter(self, dt, count=None, inc=False): """ Generator which yields up to `count` recurrences after the given datetime instance, equivalent to `after`. :param dt: The datetime at which to start generating recurrences. :param count: The maximum number of recurrences to generate. If `None` (default), dates are generated until the recurrence rule is exhausted. :param inc: If `dt` is an instance of the rule and `inc` is `True`, it is included in the output. :yields: Yields a sequence of `datetime` objects. """ if self._cache_complete: gen = self._cache else: gen = self # Select the comparison function if inc: comp = lambda dc, dtc: dc >= dtc else: comp = lambda dc, dtc: dc > dtc # Generate dates n = 0 for d in gen: if comp(d, dt): if count is not None: n += 1 if n > count: break yield d def between(self, after, before, inc=False, count=1): """ Returns all the occurrences of the rrule between after and before. The inc keyword defines what happens if after and/or before are themselves occurrences. With inc=True, they will be included in the list, if they are found in the recurrence set. """ if self._cache_complete: gen = self._cache else: gen = self started = False l = [] if inc: for i in gen: if i > before: break elif not started: if i >= after: started = True l.append(i) else: l.append(i) else: for i in gen: if i >= before: break elif not started: if i > after: started = True l.append(i) else: l.append(i) return l class rrule(rrulebase): """ That's the base of the rrule operation. It accepts all the keywords defined in the RFC as its constructor parameters (except byday, which was renamed to byweekday) and more. The constructor prototype is:: rrule(freq) Where freq must be one of YEARLY, MONTHLY, WEEKLY, DAILY, HOURLY, MINUTELY, or SECONDLY. .. note:: Per RFC section 3.3.10, recurrence instances falling on invalid dates and times are ignored rather than coerced: Recurrence rules may generate recurrence instances with an invalid date (e.g., February 30) or nonexistent local time (e.g., 1:30 AM on a day where the local time is moved forward by an hour at 1:00 AM). Such recurrence instances MUST be ignored and MUST NOT be counted as part of the recurrence set. This can lead to possibly surprising behavior when, for example, the start date occurs at the end of the month: >>> from dateutil.rrule import rrule, MONTHLY >>> from datetime import datetime >>> start_date = datetime(2014, 12, 31) >>> list(rrule(freq=MONTHLY, count=4, dtstart=start_date)) ... # doctest: +NORMALIZE_WHITESPACE [datetime.datetime(2014, 12, 31, 0, 0), datetime.datetime(2015, 1, 31, 0, 0), datetime.datetime(2015, 3, 31, 0, 0), datetime.datetime(2015, 5, 31, 0, 0)] Additionally, it supports the following keyword arguments: :param dtstart: The recurrence start. Besides being the base for the recurrence, missing parameters in the final recurrence instances will also be extracted from this date. If not given, datetime.now() will be used instead. :param interval: The interval between each freq iteration. For example, when using YEARLY, an interval of 2 means once every two years, but with HOURLY, it means once every two hours. The default interval is 1. :param wkst: The week start day. Must be one of the MO, TU, WE constants, or an integer, specifying the first day of the week. This will affect recurrences based on weekly periods. The default week start is got from calendar.firstweekday(), and may be modified by calendar.setfirstweekday(). :param count: If given, this determines how many occurrences will be generated. .. note:: As of version 2.5.0, the use of the keyword ``until`` in conjunction with ``count`` is deprecated, to make sure ``dateutil`` is fully compliant with `RFC-5545 Sec. 3.3.10 `_. Therefore, ``until`` and ``count`` **must not** occur in the same call to ``rrule``. :param until: If given, this must be a datetime instance specifying the upper-bound limit of the recurrence. The last recurrence in the rule is the greatest datetime that is less than or equal to the value specified in the ``until`` parameter. .. note:: As of version 2.5.0, the use of the keyword ``until`` in conjunction with ``count`` is deprecated, to make sure ``dateutil`` is fully compliant with `RFC-5545 Sec. 3.3.10 `_. Therefore, ``until`` and ``count`` **must not** occur in the same call to ``rrule``. :param bysetpos: If given, it must be either an integer, or a sequence of integers, positive or negative. Each given integer will specify an occurrence number, corresponding to the nth occurrence of the rule inside the frequency period. For example, a bysetpos of -1 if combined with a MONTHLY frequency, and a byweekday of (MO, TU, WE, TH, FR), will result in the last work day of every month. :param bymonth: If given, it must be either an integer, or a sequence of integers, meaning the months to apply the recurrence to. :param bymonthday: If given, it must be either an integer, or a sequence of integers, meaning the month days to apply the recurrence to. :param byyearday: If given, it must be either an integer, or a sequence of integers, meaning the year days to apply the recurrence to. :param byeaster: If given, it must be either an integer, or a sequence of integers, positive or negative. Each integer will define an offset from the Easter Sunday. Passing the offset 0 to byeaster will yield the Easter Sunday itself. This is an extension to the RFC specification. :param byweekno: If given, it must be either an integer, or a sequence of integers, meaning the week numbers to apply the recurrence to. Week numbers have the meaning described in ISO8601, that is, the first week of the year is that containing at least four days of the new year. :param byweekday: If given, it must be either an integer (0 == MO), a sequence of integers, one of the weekday constants (MO, TU, etc), or a sequence of these constants. When given, these variables will define the weekdays where the recurrence will be applied. It's also possible to use an argument n for the weekday instances, which will mean the nth occurrence of this weekday in the period. For example, with MONTHLY, or with YEARLY and BYMONTH, using FR(+1) in byweekday will specify the first friday of the month where the recurrence happens. Notice that in the RFC documentation, this is specified as BYDAY, but was renamed to avoid the ambiguity of that keyword. :param byhour: If given, it must be either an integer, or a sequence of integers, meaning the hours to apply the recurrence to. :param byminute: If given, it must be either an integer, or a sequence of integers, meaning the minutes to apply the recurrence to. :param bysecond: If given, it must be either an integer, or a sequence of integers, meaning the seconds to apply the recurrence to. :param cache: If given, it must be a boolean value specifying to enable or disable caching of results. If you will use the same rrule instance multiple times, enabling caching will improve the performance considerably. """ def __init__(self, freq, dtstart=None, interval=1, wkst=None, count=None, until=None, bysetpos=None, bymonth=None, bymonthday=None, byyearday=None, byeaster=None, byweekno=None, byweekday=None, byhour=None, byminute=None, bysecond=None, cache=False): super(rrule, self).__init__(cache) global easter if not dtstart: if until and until.tzinfo: dtstart = datetime.datetime.now(tz=until.tzinfo).replace(microsecond=0) else: dtstart = datetime.datetime.now().replace(microsecond=0) elif not isinstance(dtstart, datetime.datetime): dtstart = datetime.datetime.fromordinal(dtstart.toordinal()) else: dtstart = dtstart.replace(microsecond=0) self._dtstart = dtstart self._tzinfo = dtstart.tzinfo self._freq = freq self._interval = interval self._count = count # Cache the original byxxx rules, if they are provided, as the _byxxx # attributes do not necessarily map to the inputs, and this can be # a problem in generating the strings. Only store things if they've # been supplied (the string retrieval will just use .get()) self._original_rule = {} if until and not isinstance(until, datetime.datetime): until = datetime.datetime.fromordinal(until.toordinal()) self._until = until if self._dtstart and self._until: if (self._dtstart.tzinfo is not None) != (self._until.tzinfo is not None): # According to RFC5545 Section 3.3.10: # https://tools.ietf.org/html/rfc5545#section-3.3.10 # # > If the "DTSTART" property is specified as a date with UTC # > time or a date with local time and time zone reference, # > then the UNTIL rule part MUST be specified as a date with # > UTC time. raise ValueError( 'RRULE UNTIL values must be specified in UTC when DTSTART ' 'is timezone-aware' ) if count is not None and until: warn("Using both 'count' and 'until' is inconsistent with RFC 5545" " and has been deprecated in dateutil. Future versions will " "raise an error.", DeprecationWarning) if wkst is None: self._wkst = calendar.firstweekday() elif isinstance(wkst, integer_types): self._wkst = wkst else: self._wkst = wkst.weekday if bysetpos is None: self._bysetpos = None elif isinstance(bysetpos, integer_types): if bysetpos == 0 or not (-366 <= bysetpos <= 366): raise ValueError("bysetpos must be between 1 and 366, " "or between -366 and -1") self._bysetpos = (bysetpos,) else: self._bysetpos = tuple(bysetpos) for pos in self._bysetpos: if pos == 0 or not (-366 <= pos <= 366): raise ValueError("bysetpos must be between 1 and 366, " "or between -366 and -1") if self._bysetpos: self._original_rule['bysetpos'] = self._bysetpos if (byweekno is None and byyearday is None and bymonthday is None and byweekday is None and byeaster is None): if freq == YEARLY: if bymonth is None: bymonth = dtstart.month self._original_rule['bymonth'] = None bymonthday = dtstart.day self._original_rule['bymonthday'] = None elif freq == MONTHLY: bymonthday = dtstart.day self._original_rule['bymonthday'] = None elif freq == WEEKLY: byweekday = dtstart.weekday() self._original_rule['byweekday'] = None # bymonth if bymonth is None: self._bymonth = None else: if isinstance(bymonth, integer_types): bymonth = (bymonth,) self._bymonth = tuple(sorted(set(bymonth))) if 'bymonth' not in self._original_rule: self._original_rule['bymonth'] = self._bymonth # byyearday if byyearday is None: self._byyearday = None else: if isinstance(byyearday, integer_types): byyearday = (byyearday,) self._byyearday = tuple(sorted(set(byyearday))) self._original_rule['byyearday'] = self._byyearday # byeaster if byeaster is not None: if not easter: from dateutil import easter if isinstance(byeaster, integer_types): self._byeaster = (byeaster,) else: self._byeaster = tuple(sorted(byeaster)) self._original_rule['byeaster'] = self._byeaster else: self._byeaster = None # bymonthday if bymonthday is None: self._bymonthday = () self._bynmonthday = () else: if isinstance(bymonthday, integer_types): bymonthday = (bymonthday,) bymonthday = set(bymonthday) # Ensure it's unique self._bymonthday = tuple(sorted(x for x in bymonthday if x > 0)) self._bynmonthday = tuple(sorted(x for x in bymonthday if x < 0)) # Storing positive numbers first, then negative numbers if 'bymonthday' not in self._original_rule: self._original_rule['bymonthday'] = tuple( itertools.chain(self._bymonthday, self._bynmonthday)) # byweekno if byweekno is None: self._byweekno = None else: if isinstance(byweekno, integer_types): byweekno = (byweekno,) self._byweekno = tuple(sorted(set(byweekno))) self._original_rule['byweekno'] = self._byweekno # byweekday / bynweekday if byweekday is None: self._byweekday = None self._bynweekday = None else: # If it's one of the valid non-sequence types, convert to a # single-element sequence before the iterator that builds the # byweekday set. if isinstance(byweekday, integer_types) or hasattr(byweekday, "n"): byweekday = (byweekday,) self._byweekday = set() self._bynweekday = set() for wday in byweekday: if isinstance(wday, integer_types): self._byweekday.add(wday) elif not wday.n or freq > MONTHLY: self._byweekday.add(wday.weekday) else: self._bynweekday.add((wday.weekday, wday.n)) if not self._byweekday: self._byweekday = None elif not self._bynweekday: self._bynweekday = None if self._byweekday is not None: self._byweekday = tuple(sorted(self._byweekday)) orig_byweekday = [weekday(x) for x in self._byweekday] else: orig_byweekday = () if self._bynweekday is not None: self._bynweekday = tuple(sorted(self._bynweekday)) orig_bynweekday = [weekday(*x) for x in self._bynweekday] else: orig_bynweekday = () if 'byweekday' not in self._original_rule: self._original_rule['byweekday'] = tuple(itertools.chain( orig_byweekday, orig_bynweekday)) # byhour if byhour is None: if freq < HOURLY: self._byhour = {dtstart.hour} else: self._byhour = None else: if isinstance(byhour, integer_types): byhour = (byhour,) if freq == HOURLY: self._byhour = self.__construct_byset(start=dtstart.hour, byxxx=byhour, base=24) else: self._byhour = set(byhour) self._byhour = tuple(sorted(self._byhour)) self._original_rule['byhour'] = self._byhour # byminute if byminute is None: if freq < MINUTELY: self._byminute = {dtstart.minute} else: self._byminute = None else: if isinstance(byminute, integer_types): byminute = (byminute,) if freq == MINUTELY: self._byminute = self.__construct_byset(start=dtstart.minute, byxxx=byminute, base=60) else: self._byminute = set(byminute) self._byminute = tuple(sorted(self._byminute)) self._original_rule['byminute'] = self._byminute # bysecond if bysecond is None: if freq < SECONDLY: self._bysecond = ((dtstart.second,)) else: self._bysecond = None else: if isinstance(bysecond, integer_types): bysecond = (bysecond,) self._bysecond = set(bysecond) if freq == SECONDLY: self._bysecond = self.__construct_byset(start=dtstart.second, byxxx=bysecond, base=60) else: self._bysecond = set(bysecond) self._bysecond = tuple(sorted(self._bysecond)) self._original_rule['bysecond'] = self._bysecond if self._freq >= HOURLY: self._timeset = None else: self._timeset = [] for hour in self._byhour: for minute in self._byminute: for second in self._bysecond: self._timeset.append( datetime.time(hour, minute, second, tzinfo=self._tzinfo)) self._timeset.sort() self._timeset = tuple(self._timeset) def __str__(self): """ Output a string that would generate this RRULE if passed to rrulestr. This is mostly compatible with RFC5545, except for the dateutil-specific extension BYEASTER. """ output = [] h, m, s = [None] * 3 if self._dtstart: output.append(self._dtstart.strftime('DTSTART:%Y%m%dT%H%M%S')) h, m, s = self._dtstart.timetuple()[3:6] parts = ['FREQ=' + FREQNAMES[self._freq]] if self._interval != 1: parts.append('INTERVAL=' + str(self._interval)) if self._wkst: parts.append('WKST=' + repr(weekday(self._wkst))[0:2]) if self._count is not None: parts.append('COUNT=' + str(self._count)) if self._until: parts.append(self._until.strftime('UNTIL=%Y%m%dT%H%M%S')) if self._original_rule.get('byweekday') is not None: # The str() method on weekday objects doesn't generate # RFC5545-compliant strings, so we should modify that. original_rule = dict(self._original_rule) wday_strings = [] for wday in original_rule['byweekday']: if wday.n: wday_strings.append('{n:+d}{wday}'.format( n=wday.n, wday=repr(wday)[0:2])) else: wday_strings.append(repr(wday)) original_rule['byweekday'] = wday_strings else: original_rule = self._original_rule partfmt = '{name}={vals}' for name, key in [('BYSETPOS', 'bysetpos'), ('BYMONTH', 'bymonth'), ('BYMONTHDAY', 'bymonthday'), ('BYYEARDAY', 'byyearday'), ('BYWEEKNO', 'byweekno'), ('BYDAY', 'byweekday'), ('BYHOUR', 'byhour'), ('BYMINUTE', 'byminute'), ('BYSECOND', 'bysecond'), ('BYEASTER', 'byeaster')]: value = original_rule.get(key) if value: parts.append(partfmt.format(name=name, vals=(','.join(str(v) for v in value)))) output.append('RRULE:' + ';'.join(parts)) return '\n'.join(output) def replace(self, **kwargs): """Return new rrule with same attributes except for those attributes given new values by whichever keyword arguments are specified.""" new_kwargs = {"interval": self._interval, "count": self._count, "dtstart": self._dtstart, "freq": self._freq, "until": self._until, "wkst": self._wkst, "cache": False if self._cache is None else True } new_kwargs.update(self._original_rule) new_kwargs.update(kwargs) return rrule(**new_kwargs) def _iter(self): year, month, day, hour, minute, second, weekday, yearday, _ = \ self._dtstart.timetuple() # Some local variables to speed things up a bit freq = self._freq interval = self._interval wkst = self._wkst until = self._until bymonth = self._bymonth byweekno = self._byweekno byyearday = self._byyearday byweekday = self._byweekday byeaster = self._byeaster bymonthday = self._bymonthday bynmonthday = self._bynmonthday bysetpos = self._bysetpos byhour = self._byhour byminute = self._byminute bysecond = self._bysecond ii = _iterinfo(self) ii.rebuild(year, month) getdayset = {YEARLY: ii.ydayset, MONTHLY: ii.mdayset, WEEKLY: ii.wdayset, DAILY: ii.ddayset, HOURLY: ii.ddayset, MINUTELY: ii.ddayset, SECONDLY: ii.ddayset}[freq] if freq < HOURLY: timeset = self._timeset else: gettimeset = {HOURLY: ii.htimeset, MINUTELY: ii.mtimeset, SECONDLY: ii.stimeset}[freq] if ((freq >= HOURLY and self._byhour and hour not in self._byhour) or (freq >= MINUTELY and self._byminute and minute not in self._byminute) or (freq >= SECONDLY and self._bysecond and second not in self._bysecond)): timeset = () else: timeset = gettimeset(hour, minute, second) total = 0 count = self._count while True: # Get dayset with the right frequency dayset, start, end = getdayset(year, month, day) # Do the "hard" work ;-) filtered = False for i in dayset[start:end]: if ((bymonth and ii.mmask[i] not in bymonth) or (byweekno and not ii.wnomask[i]) or (byweekday and ii.wdaymask[i] not in byweekday) or (ii.nwdaymask and not ii.nwdaymask[i]) or (byeaster and not ii.eastermask[i]) or ((bymonthday or bynmonthday) and ii.mdaymask[i] not in bymonthday and ii.nmdaymask[i] not in bynmonthday) or (byyearday and ((i < ii.yearlen and i+1 not in byyearday and -ii.yearlen+i not in byyearday) or (i >= ii.yearlen and i+1-ii.yearlen not in byyearday and -ii.nextyearlen+i-ii.yearlen not in byyearday)))): dayset[i] = None filtered = True # Output results if bysetpos and timeset: poslist = [] for pos in bysetpos: if pos < 0: daypos, timepos = divmod(pos, len(timeset)) else: daypos, timepos = divmod(pos-1, len(timeset)) try: i = [x for x in dayset[start:end] if x is not None][daypos] time = timeset[timepos] except IndexError: pass else: date = datetime.date.fromordinal(ii.yearordinal+i) res = datetime.datetime.combine(date, time) if res not in poslist: poslist.append(res) poslist.sort() for res in poslist: if until and res > until: self._len = total return elif res >= self._dtstart: if count is not None: count -= 1 if count < 0: self._len = total return total += 1 yield res else: for i in dayset[start:end]: if i is not None: date = datetime.date.fromordinal(ii.yearordinal + i) for time in timeset: res = datetime.datetime.combine(date, time) if until and res > until: self._len = total return elif res >= self._dtstart: if count is not None: count -= 1 if count < 0: self._len = total return total += 1 yield res # Handle frequency and interval fixday = False if freq == YEARLY: year += interval if year > datetime.MAXYEAR: self._len = total return ii.rebuild(year, month) elif freq == MONTHLY: month += interval if month > 12: div, mod = divmod(month, 12) month = mod year += div if month == 0: month = 12 year -= 1 if year > datetime.MAXYEAR: self._len = total return ii.rebuild(year, month) elif freq == WEEKLY: if wkst > weekday: day += -(weekday+1+(6-wkst))+self._interval*7 else: day += -(weekday-wkst)+self._interval*7 weekday = wkst fixday = True elif freq == DAILY: day += interval fixday = True elif freq == HOURLY: if filtered: # Jump to one iteration before next day hour += ((23-hour)//interval)*interval if byhour: ndays, hour = self.__mod_distance(value=hour, byxxx=self._byhour, base=24) else: ndays, hour = divmod(hour+interval, 24) if ndays: day += ndays fixday = True timeset = gettimeset(hour, minute, second) elif freq == MINUTELY: if filtered: # Jump to one iteration before next day minute += ((1439-(hour*60+minute))//interval)*interval valid = False rep_rate = (24*60) for j in range(rep_rate // gcd(interval, rep_rate)): if byminute: nhours, minute = \ self.__mod_distance(value=minute, byxxx=self._byminute, base=60) else: nhours, minute = divmod(minute+interval, 60) div, hour = divmod(hour+nhours, 24) if div: day += div fixday = True filtered = False if not byhour or hour in byhour: valid = True break if not valid: raise ValueError('Invalid combination of interval and ' + 'byhour resulting in empty rule.') timeset = gettimeset(hour, minute, second) elif freq == SECONDLY: if filtered: # Jump to one iteration before next day second += (((86399 - (hour * 3600 + minute * 60 + second)) // interval) * interval) rep_rate = (24 * 3600) valid = False for j in range(0, rep_rate // gcd(interval, rep_rate)): if bysecond: nminutes, second = \ self.__mod_distance(value=second, byxxx=self._bysecond, base=60) else: nminutes, second = divmod(second+interval, 60) div, minute = divmod(minute+nminutes, 60) if div: hour += div div, hour = divmod(hour, 24) if div: day += div fixday = True if ((not byhour or hour in byhour) and (not byminute or minute in byminute) and (not bysecond or second in bysecond)): valid = True break if not valid: raise ValueError('Invalid combination of interval, ' + 'byhour and byminute resulting in empty' + ' rule.') timeset = gettimeset(hour, minute, second) if fixday and day > 28: daysinmonth = calendar.monthrange(year, month)[1] if day > daysinmonth: while day > daysinmonth: day -= daysinmonth month += 1 if month == 13: month = 1 year += 1 if year > datetime.MAXYEAR: self._len = total return daysinmonth = calendar.monthrange(year, month)[1] ii.rebuild(year, month) def __construct_byset(self, start, byxxx, base): """ If a `BYXXX` sequence is passed to the constructor at the same level as `FREQ` (e.g. `FREQ=HOURLY,BYHOUR={2,4,7},INTERVAL=3`), there are some specifications which cannot be reached given some starting conditions. This occurs whenever the interval is not coprime with the base of a given unit and the difference between the starting position and the ending position is not coprime with the greatest common denominator between the interval and the base. For example, with a FREQ of hourly starting at 17:00 and an interval of 4, the only valid values for BYHOUR would be {21, 1, 5, 9, 13, 17}, because 4 and 24 are not coprime. :param start: Specifies the starting position. :param byxxx: An iterable containing the list of allowed values. :param base: The largest allowable value for the specified frequency (e.g. 24 hours, 60 minutes). This does not preserve the type of the iterable, returning a set, since the values should be unique and the order is irrelevant, this will speed up later lookups. In the event of an empty set, raises a :exception:`ValueError`, as this results in an empty rrule. """ cset = set() # Support a single byxxx value. if isinstance(byxxx, integer_types): byxxx = (byxxx, ) for num in byxxx: i_gcd = gcd(self._interval, base) # Use divmod rather than % because we need to wrap negative nums. if i_gcd == 1 or divmod(num - start, i_gcd)[1] == 0: cset.add(num) if len(cset) == 0: raise ValueError("Invalid rrule byxxx generates an empty set.") return cset def __mod_distance(self, value, byxxx, base): """ Calculates the next value in a sequence where the `FREQ` parameter is specified along with a `BYXXX` parameter at the same "level" (e.g. `HOURLY` specified with `BYHOUR`). :param value: The old value of the component. :param byxxx: The `BYXXX` set, which should have been generated by `rrule._construct_byset`, or something else which checks that a valid rule is present. :param base: The largest allowable value for the specified frequency (e.g. 24 hours, 60 minutes). If a valid value is not found after `base` iterations (the maximum number before the sequence would start to repeat), this raises a :exception:`ValueError`, as no valid values were found. This returns a tuple of `divmod(n*interval, base)`, where `n` is the smallest number of `interval` repetitions until the next specified value in `byxxx` is found. """ accumulator = 0 for ii in range(1, base + 1): # Using divmod() over % to account for negative intervals div, value = divmod(value + self._interval, base) accumulator += div if value in byxxx: return (accumulator, value) class _iterinfo(object): __slots__ = ["rrule", "lastyear", "lastmonth", "yearlen", "nextyearlen", "yearordinal", "yearweekday", "mmask", "mrange", "mdaymask", "nmdaymask", "wdaymask", "wnomask", "nwdaymask", "eastermask"] def __init__(self, rrule): for attr in self.__slots__: setattr(self, attr, None) self.rrule = rrule def rebuild(self, year, month): # Every mask is 7 days longer to handle cross-year weekly periods. rr = self.rrule if year != self.lastyear: self.yearlen = 365 + calendar.isleap(year) self.nextyearlen = 365 + calendar.isleap(year + 1) firstyday = datetime.date(year, 1, 1) self.yearordinal = firstyday.toordinal() self.yearweekday = firstyday.weekday() wday = datetime.date(year, 1, 1).weekday() if self.yearlen == 365: self.mmask = M365MASK self.mdaymask = MDAY365MASK self.nmdaymask = NMDAY365MASK self.wdaymask = WDAYMASK[wday:] self.mrange = M365RANGE else: self.mmask = M366MASK self.mdaymask = MDAY366MASK self.nmdaymask = NMDAY366MASK self.wdaymask = WDAYMASK[wday:] self.mrange = M366RANGE if not rr._byweekno: self.wnomask = None else: self.wnomask = [0]*(self.yearlen+7) # no1wkst = firstwkst = self.wdaymask.index(rr._wkst) no1wkst = firstwkst = (7-self.yearweekday+rr._wkst) % 7 if no1wkst >= 4: no1wkst = 0 # Number of days in the year, plus the days we got # from last year. wyearlen = self.yearlen+(self.yearweekday-rr._wkst) % 7 else: # Number of days in the year, minus the days we # left in last year. wyearlen = self.yearlen-no1wkst div, mod = divmod(wyearlen, 7) numweeks = div+mod//4 for n in rr._byweekno: if n < 0: n += numweeks+1 if not (0 < n <= numweeks): continue if n > 1: i = no1wkst+(n-1)*7 if no1wkst != firstwkst: i -= 7-firstwkst else: i = no1wkst for j in range(7): self.wnomask[i] = 1 i += 1 if self.wdaymask[i] == rr._wkst: break if 1 in rr._byweekno: # Check week number 1 of next year as well # TODO: Check -numweeks for next year. i = no1wkst+numweeks*7 if no1wkst != firstwkst: i -= 7-firstwkst if i < self.yearlen: # If week starts in next year, we # don't care about it. for j in range(7): self.wnomask[i] = 1 i += 1 if self.wdaymask[i] == rr._wkst: break if no1wkst: # Check last week number of last year as # well. If no1wkst is 0, either the year # started on week start, or week number 1 # got days from last year, so there are no # days from last year's last week number in # this year. if -1 not in rr._byweekno: lyearweekday = datetime.date(year-1, 1, 1).weekday() lno1wkst = (7-lyearweekday+rr._wkst) % 7 lyearlen = 365+calendar.isleap(year-1) if lno1wkst >= 4: lno1wkst = 0 lnumweeks = 52+(lyearlen + (lyearweekday-rr._wkst) % 7) % 7//4 else: lnumweeks = 52+(self.yearlen-no1wkst) % 7//4 else: lnumweeks = -1 if lnumweeks in rr._byweekno: for i in range(no1wkst): self.wnomask[i] = 1 if (rr._bynweekday and (month != self.lastmonth or year != self.lastyear)): ranges = [] if rr._freq == YEARLY: if rr._bymonth: for month in rr._bymonth: ranges.append(self.mrange[month-1:month+1]) else: ranges = [(0, self.yearlen)] elif rr._freq == MONTHLY: ranges = [self.mrange[month-1:month+1]] if ranges: # Weekly frequency won't get here, so we may not # care about cross-year weekly periods. self.nwdaymask = [0]*self.yearlen for first, last in ranges: last -= 1 for wday, n in rr._bynweekday: if n < 0: i = last+(n+1)*7 i -= (self.wdaymask[i]-wday) % 7 else: i = first+(n-1)*7 i += (7-self.wdaymask[i]+wday) % 7 if first <= i <= last: self.nwdaymask[i] = 1 if rr._byeaster: self.eastermask = [0]*(self.yearlen+7) eyday = easter.easter(year).toordinal()-self.yearordinal for offset in rr._byeaster: self.eastermask[eyday+offset] = 1 self.lastyear = year self.lastmonth = month def ydayset(self, year, month, day): return list(range(self.yearlen)), 0, self.yearlen def mdayset(self, year, month, day): dset = [None]*self.yearlen start, end = self.mrange[month-1:month+1] for i in range(start, end): dset[i] = i return dset, start, end def wdayset(self, year, month, day): # We need to handle cross-year weeks here. dset = [None]*(self.yearlen+7) i = datetime.date(year, month, day).toordinal()-self.yearordinal start = i for j in range(7): dset[i] = i i += 1 # if (not (0 <= i < self.yearlen) or # self.wdaymask[i] == self.rrule._wkst): # This will cross the year boundary, if necessary. if self.wdaymask[i] == self.rrule._wkst: break return dset, start, i def ddayset(self, year, month, day): dset = [None] * self.yearlen i = datetime.date(year, month, day).toordinal() - self.yearordinal dset[i] = i return dset, i, i + 1 def htimeset(self, hour, minute, second): tset = [] rr = self.rrule for minute in rr._byminute: for second in rr._bysecond: tset.append(datetime.time(hour, minute, second, tzinfo=rr._tzinfo)) tset.sort() return tset def mtimeset(self, hour, minute, second): tset = [] rr = self.rrule for second in rr._bysecond: tset.append(datetime.time(hour, minute, second, tzinfo=rr._tzinfo)) tset.sort() return tset def stimeset(self, hour, minute, second): return (datetime.time(hour, minute, second, tzinfo=self.rrule._tzinfo),) class rruleset(rrulebase): """ The rruleset type allows more complex recurrence setups, mixing multiple rules, dates, exclusion rules, and exclusion dates. The type constructor takes the following keyword arguments: :param cache: If True, caching of results will be enabled, improving performance of multiple queries considerably. """ class _genitem(object): def __init__(self, genlist, gen): try: self.dt = advance_iterator(gen) genlist.append(self) except StopIteration: pass self.genlist = genlist self.gen = gen def __next__(self): try: self.dt = advance_iterator(self.gen) except StopIteration: if self.genlist[0] is self: heapq.heappop(self.genlist) else: self.genlist.remove(self) heapq.heapify(self.genlist) next = __next__ def __lt__(self, other): return self.dt < other.dt def __gt__(self, other): return self.dt > other.dt def __eq__(self, other): return self.dt == other.dt def __ne__(self, other): return self.dt != other.dt def __init__(self, cache=False): super(rruleset, self).__init__(cache) self._rrule = [] self._rdate = [] self._exrule = [] self._exdate = [] @_invalidates_cache def rrule(self, rrule): """ Include the given :py:class:`rrule` instance in the recurrence set generation. """ self._rrule.append(rrule) @_invalidates_cache def rdate(self, rdate): """ Include the given :py:class:`datetime` instance in the recurrence set generation. """ self._rdate.append(rdate) @_invalidates_cache def exrule(self, exrule): """ Include the given rrule instance in the recurrence set exclusion list. Dates which are part of the given recurrence rules will not be generated, even if some inclusive rrule or rdate matches them. """ self._exrule.append(exrule) @_invalidates_cache def exdate(self, exdate): """ Include the given datetime instance in the recurrence set exclusion list. Dates included that way will not be generated, even if some inclusive rrule or rdate matches them. """ self._exdate.append(exdate) def _iter(self): rlist = [] self._rdate.sort() self._genitem(rlist, iter(self._rdate)) for gen in [iter(x) for x in self._rrule]: self._genitem(rlist, gen) exlist = [] self._exdate.sort() self._genitem(exlist, iter(self._exdate)) for gen in [iter(x) for x in self._exrule]: self._genitem(exlist, gen) lastdt = None total = 0 heapq.heapify(rlist) heapq.heapify(exlist) while rlist: ritem = rlist[0] if not lastdt or lastdt != ritem.dt: while exlist and exlist[0] < ritem: exitem = exlist[0] advance_iterator(exitem) if exlist and exlist[0] is exitem: heapq.heapreplace(exlist, exitem) if not exlist or ritem != exlist[0]: total += 1 yield ritem.dt lastdt = ritem.dt advance_iterator(ritem) if rlist and rlist[0] is ritem: heapq.heapreplace(rlist, ritem) self._len = total class _rrulestr(object): """ Parses a string representation of a recurrence rule or set of recurrence rules. :param s: Required, a string defining one or more recurrence rules. :param dtstart: If given, used as the default recurrence start if not specified in the rule string. :param cache: If set ``True`` caching of results will be enabled, improving performance of multiple queries considerably. :param unfold: If set ``True`` indicates that a rule string is split over more than one line and should be joined before processing. :param forceset: If set ``True`` forces a :class:`dateutil.rrule.rruleset` to be returned. :param compatible: If set ``True`` forces ``unfold`` and ``forceset`` to be ``True``. :param ignoretz: If set ``True``, time zones in parsed strings are ignored and a naive :class:`datetime.datetime` object is returned. :param tzids: If given, a callable or mapping used to retrieve a :class:`datetime.tzinfo` from a string representation. Defaults to :func:`dateutil.tz.gettz`. :param tzinfos: Additional time zone names / aliases which may be present in a string representation. See :func:`dateutil.parser.parse` for more information. :return: Returns a :class:`dateutil.rrule.rruleset` or :class:`dateutil.rrule.rrule` """ _freq_map = {"YEARLY": YEARLY, "MONTHLY": MONTHLY, "WEEKLY": WEEKLY, "DAILY": DAILY, "HOURLY": HOURLY, "MINUTELY": MINUTELY, "SECONDLY": SECONDLY} _weekday_map = {"MO": 0, "TU": 1, "WE": 2, "TH": 3, "FR": 4, "SA": 5, "SU": 6} def _handle_int(self, rrkwargs, name, value, **kwargs): rrkwargs[name.lower()] = int(value) def _handle_int_list(self, rrkwargs, name, value, **kwargs): rrkwargs[name.lower()] = [int(x) for x in value.split(',')] _handle_INTERVAL = _handle_int _handle_COUNT = _handle_int _handle_BYSETPOS = _handle_int_list _handle_BYMONTH = _handle_int_list _handle_BYMONTHDAY = _handle_int_list _handle_BYYEARDAY = _handle_int_list _handle_BYEASTER = _handle_int_list _handle_BYWEEKNO = _handle_int_list _handle_BYHOUR = _handle_int_list _handle_BYMINUTE = _handle_int_list _handle_BYSECOND = _handle_int_list def _handle_FREQ(self, rrkwargs, name, value, **kwargs): rrkwargs["freq"] = self._freq_map[value] def _handle_UNTIL(self, rrkwargs, name, value, **kwargs): global parser if not parser: from dateutil import parser try: rrkwargs["until"] = parser.parse(value, ignoretz=kwargs.get("ignoretz"), tzinfos=kwargs.get("tzinfos")) except ValueError: raise ValueError("invalid until date") def _handle_WKST(self, rrkwargs, name, value, **kwargs): rrkwargs["wkst"] = self._weekday_map[value] def _handle_BYWEEKDAY(self, rrkwargs, name, value, **kwargs): """ Two ways to specify this: +1MO or MO(+1) """ l = [] for wday in value.split(','): if '(' in wday: # If it's of the form TH(+1), etc. splt = wday.split('(') w = splt[0] n = int(splt[1][:-1]) elif len(wday): # If it's of the form +1MO for i in range(len(wday)): if wday[i] not in '+-0123456789': break n = wday[:i] or None w = wday[i:] if n: n = int(n) else: raise ValueError("Invalid (empty) BYDAY specification.") l.append(weekdays[self._weekday_map[w]](n)) rrkwargs["byweekday"] = l _handle_BYDAY = _handle_BYWEEKDAY def _parse_rfc_rrule(self, line, dtstart=None, cache=False, ignoretz=False, tzinfos=None): if line.find(':') != -1: name, value = line.split(':') if name != "RRULE": raise ValueError("unknown parameter name") else: value = line rrkwargs = {} for pair in value.split(';'): name, value = pair.split('=') name = name.upper() value = value.upper() try: getattr(self, "_handle_"+name)(rrkwargs, name, value, ignoretz=ignoretz, tzinfos=tzinfos) except AttributeError: raise ValueError("unknown parameter '%s'" % name) except (KeyError, ValueError): raise ValueError("invalid '%s': %s" % (name, value)) return rrule(dtstart=dtstart, cache=cache, **rrkwargs) def _parse_date_value(self, date_value, parms, rule_tzids, ignoretz, tzids, tzinfos): global parser if not parser: from dateutil import parser datevals = [] value_found = False TZID = None for parm in parms: if parm.startswith("TZID="): try: tzkey = rule_tzids[parm.split('TZID=')[-1]] except KeyError: continue if tzids is None: from . import tz tzlookup = tz.gettz elif callable(tzids): tzlookup = tzids else: tzlookup = getattr(tzids, 'get', None) if tzlookup is None: msg = ('tzids must be a callable, mapping, or None, ' 'not %s' % tzids) raise ValueError(msg) TZID = tzlookup(tzkey) continue # RFC 5445 3.8.2.4: The VALUE parameter is optional, but may be found # only once. if parm not in {"VALUE=DATE-TIME", "VALUE=DATE"}: raise ValueError("unsupported parm: " + parm) else: if value_found: msg = ("Duplicate value parameter found in: " + parm) raise ValueError(msg) value_found = True for datestr in date_value.split(','): date = parser.parse(datestr, ignoretz=ignoretz, tzinfos=tzinfos) if TZID is not None: if date.tzinfo is None: date = date.replace(tzinfo=TZID) else: raise ValueError('DTSTART/EXDATE specifies multiple timezone') datevals.append(date) return datevals def _parse_rfc(self, s, dtstart=None, cache=False, unfold=False, forceset=False, compatible=False, ignoretz=False, tzids=None, tzinfos=None): global parser if compatible: forceset = True unfold = True TZID_NAMES = dict(map( lambda x: (x.upper(), x), re.findall('TZID=(?P[^:]+):', s) )) s = s.upper() if not s.strip(): raise ValueError("empty string") if unfold: lines = s.splitlines() i = 0 while i < len(lines): line = lines[i].rstrip() if not line: del lines[i] elif i > 0 and line[0] == " ": lines[i-1] += line[1:] del lines[i] else: i += 1 else: lines = s.split() if (not forceset and len(lines) == 1 and (s.find(':') == -1 or s.startswith('RRULE:'))): return self._parse_rfc_rrule(lines[0], cache=cache, dtstart=dtstart, ignoretz=ignoretz, tzinfos=tzinfos) else: rrulevals = [] rdatevals = [] exrulevals = [] exdatevals = [] for line in lines: if not line: continue if line.find(':') == -1: name = "RRULE" value = line else: name, value = line.split(':', 1) parms = name.split(';') if not parms: raise ValueError("empty property name") name = parms[0] parms = parms[1:] if name == "RRULE": for parm in parms: raise ValueError("unsupported RRULE parm: "+parm) rrulevals.append(value) elif name == "RDATE": for parm in parms: if parm != "VALUE=DATE-TIME": raise ValueError("unsupported RDATE parm: "+parm) rdatevals.append(value) elif name == "EXRULE": for parm in parms: raise ValueError("unsupported EXRULE parm: "+parm) exrulevals.append(value) elif name == "EXDATE": exdatevals.extend( self._parse_date_value(value, parms, TZID_NAMES, ignoretz, tzids, tzinfos) ) elif name == "DTSTART": dtvals = self._parse_date_value(value, parms, TZID_NAMES, ignoretz, tzids, tzinfos) if len(dtvals) != 1: raise ValueError("Multiple DTSTART values specified:" + value) dtstart = dtvals[0] else: raise ValueError("unsupported property: "+name) if (forceset or len(rrulevals) > 1 or rdatevals or exrulevals or exdatevals): if not parser and (rdatevals or exdatevals): from dateutil import parser rset = rruleset(cache=cache) for value in rrulevals: rset.rrule(self._parse_rfc_rrule(value, dtstart=dtstart, ignoretz=ignoretz, tzinfos=tzinfos)) for value in rdatevals: for datestr in value.split(','): rset.rdate(parser.parse(datestr, ignoretz=ignoretz, tzinfos=tzinfos)) for value in exrulevals: rset.exrule(self._parse_rfc_rrule(value, dtstart=dtstart, ignoretz=ignoretz, tzinfos=tzinfos)) for value in exdatevals: rset.exdate(value) if compatible and dtstart: rset.rdate(dtstart) return rset else: return self._parse_rfc_rrule(rrulevals[0], dtstart=dtstart, cache=cache, ignoretz=ignoretz, tzinfos=tzinfos) def __call__(self, s, **kwargs): return self._parse_rfc(s, **kwargs) rrulestr = _rrulestr() # vim:ts=4:sw=4:et ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1618729 python-dateutil-2.8.2/dateutil/test/0000755000175100001710000000000000000000000017007 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/__init__.py0000644000175100001710000000000000000000000021106 0ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/_common.py0000644000175100001710000001506500000000000021017 0ustar00runnerdockerfrom __future__ import unicode_literals import os import time import subprocess import warnings import tempfile import pickle import pytest class PicklableMixin(object): def _get_nobj_bytes(self, obj, dump_kwargs, load_kwargs): """ Pickle and unpickle an object using ``pickle.dumps`` / ``pickle.loads`` """ pkl = pickle.dumps(obj, **dump_kwargs) return pickle.loads(pkl, **load_kwargs) def _get_nobj_file(self, obj, dump_kwargs, load_kwargs): """ Pickle and unpickle an object using ``pickle.dump`` / ``pickle.load`` on a temporary file. """ with tempfile.TemporaryFile('w+b') as pkl: pickle.dump(obj, pkl, **dump_kwargs) pkl.seek(0) # Reset the file to the beginning to read it nobj = pickle.load(pkl, **load_kwargs) return nobj def assertPicklable(self, obj, singleton=False, asfile=False, dump_kwargs=None, load_kwargs=None): """ Assert that an object can be pickled and unpickled. This assertion assumes that the desired behavior is that the unpickled object compares equal to the original object, but is not the same object. """ get_nobj = self._get_nobj_file if asfile else self._get_nobj_bytes dump_kwargs = dump_kwargs or {} load_kwargs = load_kwargs or {} nobj = get_nobj(obj, dump_kwargs, load_kwargs) if not singleton: self.assertIsNot(obj, nobj) self.assertEqual(obj, nobj) class TZContextBase(object): """ Base class for a context manager which allows changing of time zones. Subclasses may define a guard variable to either block or or allow time zone changes by redefining ``_guard_var_name`` and ``_guard_allows_change``. The default is that the guard variable must be affirmatively set. Subclasses must define ``get_current_tz`` and ``set_current_tz``. """ _guard_var_name = "DATEUTIL_MAY_CHANGE_TZ" _guard_allows_change = True def __init__(self, tzval): self.tzval = tzval self._old_tz = None @classmethod def tz_change_allowed(cls): """ Class method used to query whether or not this class allows time zone changes. """ guard = bool(os.environ.get(cls._guard_var_name, False)) # _guard_allows_change gives the "default" behavior - if True, the # guard is overcoming a block. If false, the guard is causing a block. # Whether tz_change is allowed is therefore the XNOR of the two. return guard == cls._guard_allows_change @classmethod def tz_change_disallowed_message(cls): """ Generate instructions on how to allow tz changes """ msg = ('Changing time zone not allowed. Set {envar} to {gval} ' 'if you would like to allow this behavior') return msg.format(envar=cls._guard_var_name, gval=cls._guard_allows_change) def __enter__(self): if not self.tz_change_allowed(): msg = self.tz_change_disallowed_message() pytest.skip(msg) # If this is used outside of a test suite, we still want an error. raise ValueError(msg) # pragma: no cover self._old_tz = self.get_current_tz() self.set_current_tz(self.tzval) def __exit__(self, type, value, traceback): if self._old_tz is not None: self.set_current_tz(self._old_tz) self._old_tz = None def get_current_tz(self): raise NotImplementedError def set_current_tz(self): raise NotImplementedError class TZEnvContext(TZContextBase): """ Context manager that temporarily sets the `TZ` variable (for use on *nix-like systems). Because the effect is local to the shell anyway, this will apply *unless* a guard is set. If you do not want the TZ environment variable set, you may set the ``DATEUTIL_MAY_NOT_CHANGE_TZ_VAR`` variable to a truthy value. """ _guard_var_name = "DATEUTIL_MAY_NOT_CHANGE_TZ_VAR" _guard_allows_change = False def get_current_tz(self): return os.environ.get('TZ', UnsetTz) def set_current_tz(self, tzval): if tzval is UnsetTz and 'TZ' in os.environ: del os.environ['TZ'] else: os.environ['TZ'] = tzval time.tzset() class TZWinContext(TZContextBase): """ Context manager for changing local time zone on Windows. Because the effect of this is system-wide and global, it may have unintended side effect. Set the ``DATEUTIL_MAY_CHANGE_TZ`` environment variable to a truthy value before using this context manager. """ def get_current_tz(self): p = subprocess.Popen(['tzutil', '/g'], stdout=subprocess.PIPE) ctzname, err = p.communicate() ctzname = ctzname.decode() # Popen returns if p.returncode: raise OSError('Failed to get current time zone: ' + err) return ctzname def set_current_tz(self, tzname): p = subprocess.Popen('tzutil /s "' + tzname + '"') out, err = p.communicate() if p.returncode: raise OSError('Failed to set current time zone: ' + (err or 'Unknown error.')) ### # Utility classes class NotAValueClass(object): """ A class analogous to NaN that has operations defined for any type. """ def _op(self, other): return self # Operation with NotAValue returns NotAValue def _cmp(self, other): return False __add__ = __radd__ = _op __sub__ = __rsub__ = _op __mul__ = __rmul__ = _op __div__ = __rdiv__ = _op __truediv__ = __rtruediv__ = _op __floordiv__ = __rfloordiv__ = _op __lt__ = __rlt__ = _op __gt__ = __rgt__ = _op __eq__ = __req__ = _op __le__ = __rle__ = _op __ge__ = __rge__ = _op NotAValue = NotAValueClass() class ComparesEqualClass(object): """ A class that is always equal to whatever you compare it to. """ def __eq__(self, other): return True def __ne__(self, other): return False def __le__(self, other): return True def __ge__(self, other): return True def __lt__(self, other): return False def __gt__(self, other): return False __req__ = __eq__ __rne__ = __ne__ __rle__ = __le__ __rge__ = __ge__ __rlt__ = __lt__ __rgt__ = __gt__ ComparesEqual = ComparesEqualClass() class UnsetTzClass(object): """ Sentinel class for unset time zone variable """ pass UnsetTz = UnsetTzClass() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/conftest.py0000644000175100001710000000204300000000000021205 0ustar00runnerdockerimport os import pytest # Configure pytest to ignore xfailing tests # See: https://stackoverflow.com/a/53198349/467366 def pytest_collection_modifyitems(items): for item in items: marker_getter = getattr(item, 'get_closest_marker', None) # Python 3.3 support if marker_getter is None: marker_getter = item.get_marker marker = marker_getter('xfail') # Need to query the args because conditional xfail tests still have # the xfail mark even if they are not expected to fail if marker and (not marker.args or marker.args[0]): item.add_marker(pytest.mark.no_cover) def set_tzpath(): """ Sets the TZPATH variable if it's specified in an environment variable. """ tzpath = os.environ.get('DATEUTIL_TZPATH', None) if tzpath is None: return path_components = tzpath.split(':') print("Setting TZPATH to {}".format(path_components)) from dateutil import tz tz.TZPATHS.clear() tz.TZPATHS.extend(path_components) set_tzpath() ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1618729 python-dateutil-2.8.2/dateutil/test/property/0000755000175100001710000000000000000000000020673 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/property/test_isoparse_prop.py0000644000175100001710000000147000000000000025173 0ustar00runnerdockerfrom hypothesis import given, assume from hypothesis import strategies as st from dateutil import tz from dateutil.parser import isoparse import pytest # Strategies TIME_ZONE_STRATEGY = st.sampled_from([None, tz.UTC] + [tz.gettz(zname) for zname in ('US/Eastern', 'US/Pacific', 'Australia/Sydney', 'Europe/London')]) ASCII_STRATEGY = st.characters(max_codepoint=127) @pytest.mark.isoparser @given(dt=st.datetimes(timezones=TIME_ZONE_STRATEGY), sep=ASCII_STRATEGY) def test_timespec_auto(dt, sep): if dt.tzinfo is not None: # Assume offset has no sub-second components assume(dt.utcoffset().total_seconds() % 60 == 0) sep = str(sep) # Python 2.7 requires bytes dtstr = dt.isoformat(sep=sep) dt_rt = isoparse(dtstr) assert dt_rt == dt ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/property/test_parser_prop.py0000644000175100001710000000104600000000000024641 0ustar00runnerdockerfrom hypothesis.strategies import integers from hypothesis import given import pytest from dateutil.parser import parserinfo @pytest.mark.parserinfo @given(integers(min_value=100, max_value=9999)) def test_convertyear(n): assert n == parserinfo().convertyear(n) @pytest.mark.parserinfo @given(integers(min_value=-50, max_value=49)) def test_convertyear_no_specified_century(n): p = parserinfo() new_year = p._year + n result = p.convertyear(new_year % 100, century_specified=False) assert result == new_year ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/property/test_tz_prop.py0000644000175100001710000000170300000000000024002 0ustar00runnerdockerfrom datetime import datetime, timedelta import pytest import six from hypothesis import assume, given from hypothesis import strategies as st from dateutil import tz as tz EPOCHALYPSE = datetime.fromtimestamp(2147483647) NEGATIVE_EPOCHALYPSE = datetime.fromtimestamp(0) - timedelta(seconds=2147483648) @pytest.mark.gettz @pytest.mark.parametrize("gettz_arg", [None, ""]) # TODO: Remove bounds when GH #590 is resolved @given( dt=st.datetimes( min_value=NEGATIVE_EPOCHALYPSE, max_value=EPOCHALYPSE, timezones=st.just(tz.UTC), ) ) def test_gettz_returns_local(gettz_arg, dt): act_tz = tz.gettz(gettz_arg) if isinstance(act_tz, tz.tzlocal): return dt_act = dt.astimezone(tz.gettz(gettz_arg)) if six.PY2: dt_exp = dt.astimezone(tz.tzlocal()) else: dt_exp = dt.astimezone() assert dt_act == dt_exp assert dt_act.tzname() == dt_exp.tzname() assert dt_act.utcoffset() == dt_exp.utcoffset() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/test_easter.py0000644000175100001710000001023200000000000021701 0ustar00runnerdockerfrom dateutil.easter import easter from dateutil.easter import EASTER_WESTERN, EASTER_ORTHODOX, EASTER_JULIAN from datetime import date import pytest # List of easters between 1990 and 2050 western_easter_dates = [ date(1990, 4, 15), date(1991, 3, 31), date(1992, 4, 19), date(1993, 4, 11), date(1994, 4, 3), date(1995, 4, 16), date(1996, 4, 7), date(1997, 3, 30), date(1998, 4, 12), date(1999, 4, 4), date(2000, 4, 23), date(2001, 4, 15), date(2002, 3, 31), date(2003, 4, 20), date(2004, 4, 11), date(2005, 3, 27), date(2006, 4, 16), date(2007, 4, 8), date(2008, 3, 23), date(2009, 4, 12), date(2010, 4, 4), date(2011, 4, 24), date(2012, 4, 8), date(2013, 3, 31), date(2014, 4, 20), date(2015, 4, 5), date(2016, 3, 27), date(2017, 4, 16), date(2018, 4, 1), date(2019, 4, 21), date(2020, 4, 12), date(2021, 4, 4), date(2022, 4, 17), date(2023, 4, 9), date(2024, 3, 31), date(2025, 4, 20), date(2026, 4, 5), date(2027, 3, 28), date(2028, 4, 16), date(2029, 4, 1), date(2030, 4, 21), date(2031, 4, 13), date(2032, 3, 28), date(2033, 4, 17), date(2034, 4, 9), date(2035, 3, 25), date(2036, 4, 13), date(2037, 4, 5), date(2038, 4, 25), date(2039, 4, 10), date(2040, 4, 1), date(2041, 4, 21), date(2042, 4, 6), date(2043, 3, 29), date(2044, 4, 17), date(2045, 4, 9), date(2046, 3, 25), date(2047, 4, 14), date(2048, 4, 5), date(2049, 4, 18), date(2050, 4, 10) ] orthodox_easter_dates = [ date(1990, 4, 15), date(1991, 4, 7), date(1992, 4, 26), date(1993, 4, 18), date(1994, 5, 1), date(1995, 4, 23), date(1996, 4, 14), date(1997, 4, 27), date(1998, 4, 19), date(1999, 4, 11), date(2000, 4, 30), date(2001, 4, 15), date(2002, 5, 5), date(2003, 4, 27), date(2004, 4, 11), date(2005, 5, 1), date(2006, 4, 23), date(2007, 4, 8), date(2008, 4, 27), date(2009, 4, 19), date(2010, 4, 4), date(2011, 4, 24), date(2012, 4, 15), date(2013, 5, 5), date(2014, 4, 20), date(2015, 4, 12), date(2016, 5, 1), date(2017, 4, 16), date(2018, 4, 8), date(2019, 4, 28), date(2020, 4, 19), date(2021, 5, 2), date(2022, 4, 24), date(2023, 4, 16), date(2024, 5, 5), date(2025, 4, 20), date(2026, 4, 12), date(2027, 5, 2), date(2028, 4, 16), date(2029, 4, 8), date(2030, 4, 28), date(2031, 4, 13), date(2032, 5, 2), date(2033, 4, 24), date(2034, 4, 9), date(2035, 4, 29), date(2036, 4, 20), date(2037, 4, 5), date(2038, 4, 25), date(2039, 4, 17), date(2040, 5, 6), date(2041, 4, 21), date(2042, 4, 13), date(2043, 5, 3), date(2044, 4, 24), date(2045, 4, 9), date(2046, 4, 29), date(2047, 4, 21), date(2048, 4, 5), date(2049, 4, 25), date(2050, 4, 17) ] # A random smattering of Julian dates. # Pulled values from http://www.kevinlaughery.com/east4099.html julian_easter_dates = [ date( 326, 4, 3), date( 375, 4, 5), date( 492, 4, 5), date( 552, 3, 31), date( 562, 4, 9), date( 569, 4, 21), date( 597, 4, 14), date( 621, 4, 19), date( 636, 3, 31), date( 655, 3, 29), date( 700, 4, 11), date( 725, 4, 8), date( 750, 3, 29), date( 782, 4, 7), date( 835, 4, 18), date( 849, 4, 14), date( 867, 3, 30), date( 890, 4, 12), date( 922, 4, 21), date( 934, 4, 6), date(1049, 3, 26), date(1058, 4, 19), date(1113, 4, 6), date(1119, 3, 30), date(1242, 4, 20), date(1255, 3, 28), date(1257, 4, 8), date(1258, 3, 24), date(1261, 4, 24), date(1278, 4, 17), date(1333, 4, 4), date(1351, 4, 17), date(1371, 4, 6), date(1391, 3, 26), date(1402, 3, 26), date(1412, 4, 3), date(1439, 4, 5), date(1445, 3, 28), date(1531, 4, 9), date(1555, 4, 14) ] @pytest.mark.parametrize("easter_date", western_easter_dates) def test_easter_western(easter_date): assert easter_date == easter(easter_date.year, EASTER_WESTERN) @pytest.mark.parametrize("easter_date", orthodox_easter_dates) def test_easter_orthodox(easter_date): assert easter_date == easter(easter_date.year, EASTER_ORTHODOX) @pytest.mark.parametrize("easter_date", julian_easter_dates) def test_easter_julian(easter_date): assert easter_date == easter(easter_date.year, EASTER_JULIAN) def test_easter_bad_method(): with pytest.raises(ValueError): easter(1975, 4) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/test_import_star.py0000644000175100001710000000206300000000000022764 0ustar00runnerdocker"""Test for the "import *" functionality. As import * can be only done at module level, it has been added in a separate file """ import pytest prev_locals = list(locals()) from dateutil import * new_locals = {name:value for name,value in locals().items() if name not in prev_locals} new_locals.pop('prev_locals') @pytest.mark.import_star def test_imported_modules(): """ Test that `from dateutil import *` adds modules in __all__ locally """ import dateutil.easter import dateutil.parser import dateutil.relativedelta import dateutil.rrule import dateutil.tz import dateutil.utils import dateutil.zoneinfo assert dateutil.easter == new_locals.pop("easter") assert dateutil.parser == new_locals.pop("parser") assert dateutil.relativedelta == new_locals.pop("relativedelta") assert dateutil.rrule == new_locals.pop("rrule") assert dateutil.tz == new_locals.pop("tz") assert dateutil.utils == new_locals.pop("utils") assert dateutil.zoneinfo == new_locals.pop("zoneinfo") assert not new_locals ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/test_imports.py0000644000175100001710000001075400000000000022124 0ustar00runnerdockerimport sys import pytest HOST_IS_WINDOWS = sys.platform.startswith('win') def test_import_version_str(): """ Test that dateutil.__version__ can be imported""" from dateutil import __version__ def test_import_version_root(): import dateutil assert hasattr(dateutil, '__version__') # Test that dateutil.easter-related imports work properly def test_import_easter_direct(): import dateutil.easter def test_import_easter_from(): from dateutil import easter def test_import_easter_start(): from dateutil.easter import easter # Test that dateutil.parser-related imports work properly def test_import_parser_direct(): import dateutil.parser def test_import_parser_from(): from dateutil import parser def test_import_parser_all(): # All interface from dateutil.parser import parse from dateutil.parser import parserinfo # Other public classes from dateutil.parser import parser for var in (parse, parserinfo, parser): assert var is not None # Test that dateutil.relativedelta-related imports work properly def test_import_relative_delta_direct(): import dateutil.relativedelta def test_import_relative_delta_from(): from dateutil import relativedelta def test_import_relative_delta_all(): from dateutil.relativedelta import relativedelta from dateutil.relativedelta import MO, TU, WE, TH, FR, SA, SU for var in (relativedelta, MO, TU, WE, TH, FR, SA, SU): assert var is not None # In the public interface but not in all from dateutil.relativedelta import weekday assert weekday is not None # Test that dateutil.rrule related imports work properly def test_import_rrule_direct(): import dateutil.rrule def test_import_rrule_from(): from dateutil import rrule def test_import_rrule_all(): from dateutil.rrule import rrule from dateutil.rrule import rruleset from dateutil.rrule import rrulestr from dateutil.rrule import YEARLY, MONTHLY, WEEKLY, DAILY from dateutil.rrule import HOURLY, MINUTELY, SECONDLY from dateutil.rrule import MO, TU, WE, TH, FR, SA, SU rr_all = (rrule, rruleset, rrulestr, YEARLY, MONTHLY, WEEKLY, DAILY, HOURLY, MINUTELY, SECONDLY, MO, TU, WE, TH, FR, SA, SU) for var in rr_all: assert var is not None # In the public interface but not in all from dateutil.rrule import weekday assert weekday is not None # Test that dateutil.tz related imports work properly def test_import_tztest_direct(): import dateutil.tz def test_import_tz_from(): from dateutil import tz def test_import_tz_all(): from dateutil.tz import tzutc from dateutil.tz import tzoffset from dateutil.tz import tzlocal from dateutil.tz import tzfile from dateutil.tz import tzrange from dateutil.tz import tzstr from dateutil.tz import tzical from dateutil.tz import gettz from dateutil.tz import tzwin from dateutil.tz import tzwinlocal from dateutil.tz import UTC from dateutil.tz import datetime_ambiguous from dateutil.tz import datetime_exists from dateutil.tz import resolve_imaginary tz_all = ["tzutc", "tzoffset", "tzlocal", "tzfile", "tzrange", "tzstr", "tzical", "gettz", "datetime_ambiguous", "datetime_exists", "resolve_imaginary", "UTC"] tz_all += ["tzwin", "tzwinlocal"] if sys.platform.startswith("win") else [] lvars = locals() for var in tz_all: assert lvars[var] is not None # Test that dateutil.tzwin related imports work properly @pytest.mark.skipif(not HOST_IS_WINDOWS, reason="Requires Windows") def test_import_tz_windows_direct(): import dateutil.tzwin @pytest.mark.skipif(not HOST_IS_WINDOWS, reason="Requires Windows") def test_import_tz_windows_from(): from dateutil import tzwin @pytest.mark.skipif(not HOST_IS_WINDOWS, reason="Requires Windows") def test_import_tz_windows_star(): from dateutil.tzwin import tzwin from dateutil.tzwin import tzwinlocal tzwin_all = [tzwin, tzwinlocal] for var in tzwin_all: assert var is not None # Test imports of Zone Info def test_import_zone_info_direct(): import dateutil.zoneinfo def test_import_zone_info_from(): from dateutil import zoneinfo def test_import_zone_info_star(): from dateutil.zoneinfo import gettz from dateutil.zoneinfo import gettz_db_metadata from dateutil.zoneinfo import rebuild zi_all = (gettz, gettz_db_metadata, rebuild) for var in zi_all: assert var is not None ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/test_internals.py0000644000175100001710000000447700000000000022433 0ustar00runnerdocker# -*- coding: utf-8 -*- """ Tests for implementation details, not necessarily part of the user-facing API. The motivating case for these tests is #483, where we want to smoke-test code that may be difficult to reach through the standard API calls. """ import sys import pytest from dateutil.parser._parser import _ymd from dateutil import tz IS_PY32 = sys.version_info[0:2] == (3, 2) @pytest.mark.smoke def test_YMD_could_be_day(): ymd = _ymd('foo bar 124 baz') ymd.append(2, 'M') assert ymd.has_month assert not ymd.has_year assert ymd.could_be_day(4) assert not ymd.could_be_day(-6) assert not ymd.could_be_day(32) # Assumes leap year assert ymd.could_be_day(29) ymd.append(1999) assert ymd.has_year assert not ymd.could_be_day(29) ymd.append(16, 'D') assert ymd.has_day assert not ymd.could_be_day(1) ymd = _ymd('foo bar 124 baz') ymd.append(1999) assert ymd.could_be_day(31) ### # Test that private interfaces in _parser are deprecated properly @pytest.mark.skipif(IS_PY32, reason='pytest.warns not supported on Python 3.2') def test_parser_private_warns(): from dateutil.parser import _timelex, _tzparser from dateutil.parser import _parsetz with pytest.warns(DeprecationWarning): _tzparser() with pytest.warns(DeprecationWarning): _timelex('2014-03-03') with pytest.warns(DeprecationWarning): _parsetz('+05:00') @pytest.mark.skipif(IS_PY32, reason='pytest.warns not supported on Python 3.2') def test_parser_parser_private_not_warns(): from dateutil.parser._parser import _timelex, _tzparser from dateutil.parser._parser import _parsetz with pytest.warns(None) as recorder: _tzparser() assert len(recorder) == 0 with pytest.warns(None) as recorder: _timelex('2014-03-03') assert len(recorder) == 0 with pytest.warns(None) as recorder: _parsetz('+05:00') assert len(recorder) == 0 @pytest.mark.tzstr def test_tzstr_internal_timedeltas(): with pytest.warns(tz.DeprecatedTzFormatWarning): tz1 = tz.tzstr("EST5EDT,5,4,0,7200,11,-3,0,7200") with pytest.warns(tz.DeprecatedTzFormatWarning): tz2 = tz.tzstr("EST5EDT,4,1,0,7200,10,-1,0,7200") assert tz1._start_delta != tz2._start_delta assert tz1._end_delta != tz2._end_delta ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/test_isoparser.py0000644000175100001710000004355700000000000022445 0ustar00runnerdocker# -*- coding: utf-8 -*- from __future__ import unicode_literals from datetime import datetime, timedelta, date, time import itertools as it from dateutil import tz from dateutil.tz import UTC from dateutil.parser import isoparser, isoparse import pytest import six def _generate_tzoffsets(limited): def _mkoffset(hmtuple, fmt): h, m = hmtuple m_td = (-1 if h < 0 else 1) * m tzo = tz.tzoffset(None, timedelta(hours=h, minutes=m_td)) return tzo, fmt.format(h, m) out = [] if not limited: # The subset that's just hours hm_out_h = [(h, 0) for h in (-23, -5, 0, 5, 23)] out.extend([_mkoffset(hm, '{:+03d}') for hm in hm_out_h]) # Ones that have hours and minutes hm_out = [] + hm_out_h hm_out += [(-12, 15), (11, 30), (10, 2), (5, 15), (-5, 30)] else: hm_out = [(-5, -0)] fmts = ['{:+03d}:{:02d}', '{:+03d}{:02d}'] out += [_mkoffset(hm, fmt) for hm in hm_out for fmt in fmts] # Also add in UTC and naive out.append((UTC, 'Z')) out.append((None, '')) return out FULL_TZOFFSETS = _generate_tzoffsets(False) FULL_TZOFFSETS_AWARE = [x for x in FULL_TZOFFSETS if x[1]] TZOFFSETS = _generate_tzoffsets(True) DATES = [datetime(1996, 1, 1), datetime(2017, 1, 1)] @pytest.mark.parametrize('dt', tuple(DATES)) def test_year_only(dt): dtstr = dt.strftime('%Y') assert isoparse(dtstr) == dt DATES += [datetime(2000, 2, 1), datetime(2017, 4, 1)] @pytest.mark.parametrize('dt', tuple(DATES)) def test_year_month(dt): fmt = '%Y-%m' dtstr = dt.strftime(fmt) assert isoparse(dtstr) == dt DATES += [datetime(2016, 2, 29), datetime(2018, 3, 15)] YMD_FMTS = ('%Y%m%d', '%Y-%m-%d') @pytest.mark.parametrize('dt', tuple(DATES)) @pytest.mark.parametrize('fmt', YMD_FMTS) def test_year_month_day(dt, fmt): dtstr = dt.strftime(fmt) assert isoparse(dtstr) == dt def _isoparse_date_and_time(dt, date_fmt, time_fmt, tzoffset, microsecond_precision=None): tzi, offset_str = tzoffset fmt = date_fmt + 'T' + time_fmt dt = dt.replace(tzinfo=tzi) dtstr = dt.strftime(fmt) if microsecond_precision is not None: if not fmt.endswith('%f'): # pragma: nocover raise ValueError('Time format has no microseconds!') if microsecond_precision != 6: dtstr = dtstr[:-(6 - microsecond_precision)] elif microsecond_precision > 6: # pragma: nocover raise ValueError('Precision must be 1-6') dtstr += offset_str assert isoparse(dtstr) == dt DATETIMES = [datetime(1998, 4, 16, 12), datetime(2019, 11, 18, 23), datetime(2014, 12, 16, 4)] @pytest.mark.parametrize('dt', tuple(DATETIMES)) @pytest.mark.parametrize('date_fmt', YMD_FMTS) @pytest.mark.parametrize('tzoffset', TZOFFSETS) def test_ymd_h(dt, date_fmt, tzoffset): _isoparse_date_and_time(dt, date_fmt, '%H', tzoffset) DATETIMES = [datetime(2012, 1, 6, 9, 37)] @pytest.mark.parametrize('dt', tuple(DATETIMES)) @pytest.mark.parametrize('date_fmt', YMD_FMTS) @pytest.mark.parametrize('time_fmt', ('%H%M', '%H:%M')) @pytest.mark.parametrize('tzoffset', TZOFFSETS) def test_ymd_hm(dt, date_fmt, time_fmt, tzoffset): _isoparse_date_and_time(dt, date_fmt, time_fmt, tzoffset) DATETIMES = [datetime(2003, 9, 2, 22, 14, 2), datetime(2003, 8, 8, 14, 9, 14), datetime(2003, 4, 7, 6, 14, 59)] HMS_FMTS = ('%H%M%S', '%H:%M:%S') @pytest.mark.parametrize('dt', tuple(DATETIMES)) @pytest.mark.parametrize('date_fmt', YMD_FMTS) @pytest.mark.parametrize('time_fmt', HMS_FMTS) @pytest.mark.parametrize('tzoffset', TZOFFSETS) def test_ymd_hms(dt, date_fmt, time_fmt, tzoffset): _isoparse_date_and_time(dt, date_fmt, time_fmt, tzoffset) DATETIMES = [datetime(2017, 11, 27, 6, 14, 30, 123456)] @pytest.mark.parametrize('dt', tuple(DATETIMES)) @pytest.mark.parametrize('date_fmt', YMD_FMTS) @pytest.mark.parametrize('time_fmt', (x + sep + '%f' for x in HMS_FMTS for sep in '.,')) @pytest.mark.parametrize('tzoffset', TZOFFSETS) @pytest.mark.parametrize('precision', list(range(3, 7))) def test_ymd_hms_micro(dt, date_fmt, time_fmt, tzoffset, precision): # Truncate the microseconds to the desired precision for the representation dt = dt.replace(microsecond=int(round(dt.microsecond, precision-6))) _isoparse_date_and_time(dt, date_fmt, time_fmt, tzoffset, precision) ### # Truncation of extra digits beyond microsecond precision @pytest.mark.parametrize('dt_str', [ '2018-07-03T14:07:00.123456000001', '2018-07-03T14:07:00.123456999999', ]) def test_extra_subsecond_digits(dt_str): assert isoparse(dt_str) == datetime(2018, 7, 3, 14, 7, 0, 123456) @pytest.mark.parametrize('tzoffset', FULL_TZOFFSETS) def test_full_tzoffsets(tzoffset): dt = datetime(2017, 11, 27, 6, 14, 30, 123456) date_fmt = '%Y-%m-%d' time_fmt = '%H:%M:%S.%f' _isoparse_date_and_time(dt, date_fmt, time_fmt, tzoffset) @pytest.mark.parametrize('dt_str', [ '2014-04-11T00', '2014-04-10T24', '2014-04-11T00:00', '2014-04-10T24:00', '2014-04-11T00:00:00', '2014-04-10T24:00:00', '2014-04-11T00:00:00.000', '2014-04-10T24:00:00.000', '2014-04-11T00:00:00.000000', '2014-04-10T24:00:00.000000'] ) def test_datetime_midnight(dt_str): assert isoparse(dt_str) == datetime(2014, 4, 11, 0, 0, 0, 0) @pytest.mark.parametrize('datestr', [ '2014-01-01', '20140101', ]) @pytest.mark.parametrize('sep', [' ', 'a', 'T', '_', '-']) def test_isoparse_sep_none(datestr, sep): isostr = datestr + sep + '14:33:09' assert isoparse(isostr) == datetime(2014, 1, 1, 14, 33, 9) ## # Uncommon date formats TIME_ARGS = ('time_args', ((None, time(0), None), ) + tuple(('%H:%M:%S.%f', _t, _tz) for _t, _tz in it.product([time(0), time(9, 30), time(14, 47)], TZOFFSETS))) @pytest.mark.parametrize('isocal,dt_expected',[ ((2017, 10), datetime(2017, 3, 6)), ((2020, 1), datetime(2019, 12, 30)), # ISO year != Cal year ((2004, 53), datetime(2004, 12, 27)), # Only half the week is in 2014 ]) def test_isoweek(isocal, dt_expected): # TODO: Figure out how to parametrize this on formats, too for fmt in ('{:04d}-W{:02d}', '{:04d}W{:02d}'): dtstr = fmt.format(*isocal) assert isoparse(dtstr) == dt_expected @pytest.mark.parametrize('isocal,dt_expected',[ ((2016, 13, 7), datetime(2016, 4, 3)), ((2004, 53, 7), datetime(2005, 1, 2)), # ISO year != Cal year ((2009, 1, 2), datetime(2008, 12, 30)), # ISO year < Cal year ((2009, 53, 6), datetime(2010, 1, 2)) # ISO year > Cal year ]) def test_isoweek_day(isocal, dt_expected): # TODO: Figure out how to parametrize this on formats, too for fmt in ('{:04d}-W{:02d}-{:d}', '{:04d}W{:02d}{:d}'): dtstr = fmt.format(*isocal) assert isoparse(dtstr) == dt_expected @pytest.mark.parametrize('isoord,dt_expected', [ ((2004, 1), datetime(2004, 1, 1)), ((2016, 60), datetime(2016, 2, 29)), ((2017, 60), datetime(2017, 3, 1)), ((2016, 366), datetime(2016, 12, 31)), ((2017, 365), datetime(2017, 12, 31)) ]) def test_iso_ordinal(isoord, dt_expected): for fmt in ('{:04d}-{:03d}', '{:04d}{:03d}'): dtstr = fmt.format(*isoord) assert isoparse(dtstr) == dt_expected ### # Acceptance of bytes @pytest.mark.parametrize('isostr,dt', [ (b'2014', datetime(2014, 1, 1)), (b'20140204', datetime(2014, 2, 4)), (b'2014-02-04', datetime(2014, 2, 4)), (b'2014-02-04T12', datetime(2014, 2, 4, 12)), (b'2014-02-04T12:30', datetime(2014, 2, 4, 12, 30)), (b'2014-02-04T12:30:15', datetime(2014, 2, 4, 12, 30, 15)), (b'2014-02-04T12:30:15.224', datetime(2014, 2, 4, 12, 30, 15, 224000)), (b'20140204T123015.224', datetime(2014, 2, 4, 12, 30, 15, 224000)), (b'2014-02-04T12:30:15.224Z', datetime(2014, 2, 4, 12, 30, 15, 224000, UTC)), (b'2014-02-04T12:30:15.224z', datetime(2014, 2, 4, 12, 30, 15, 224000, UTC)), (b'2014-02-04T12:30:15.224+05:00', datetime(2014, 2, 4, 12, 30, 15, 224000, tzinfo=tz.tzoffset(None, timedelta(hours=5))))]) def test_bytes(isostr, dt): assert isoparse(isostr) == dt ### # Invalid ISO strings @pytest.mark.parametrize('isostr,exception', [ ('201', ValueError), # ISO string too short ('2012-0425', ValueError), # Inconsistent date separators ('201204-25', ValueError), # Inconsistent date separators ('20120425T0120:00', ValueError), # Inconsistent time separators ('20120425T01:2000', ValueError), # Inconsistent time separators ('14:3015', ValueError), # Inconsistent time separator ('20120425T012500-334', ValueError), # Wrong microsecond separator ('2001-1', ValueError), # YYYY-M not valid ('2012-04-9', ValueError), # YYYY-MM-D not valid ('201204', ValueError), # YYYYMM not valid ('20120411T03:30+', ValueError), # Time zone too short ('20120411T03:30+1234567', ValueError), # Time zone too long ('20120411T03:30-25:40', ValueError), # Time zone invalid ('2012-1a', ValueError), # Invalid month ('20120411T03:30+00:60', ValueError), # Time zone invalid minutes ('20120411T03:30+00:61', ValueError), # Time zone invalid minutes ('20120411T033030.123456012:00', # No sign in time zone ValueError), ('2012-W00', ValueError), # Invalid ISO week ('2012-W55', ValueError), # Invalid ISO week ('2012-W01-0', ValueError), # Invalid ISO week day ('2012-W01-8', ValueError), # Invalid ISO week day ('2013-000', ValueError), # Invalid ordinal day ('2013-366', ValueError), # Invalid ordinal day ('2013366', ValueError), # Invalid ordinal day ('2014-03-12Т12:30:14', ValueError), # Cyrillic T ('2014-04-21T24:00:01', ValueError), # Invalid use of 24 for midnight ('2014_W01-1', ValueError), # Invalid separator ('2014W01-1', ValueError), # Inconsistent use of dashes ('2014-W011', ValueError), # Inconsistent use of dashes ]) def test_iso_raises(isostr, exception): with pytest.raises(exception): isoparse(isostr) @pytest.mark.parametrize('sep_act, valid_sep, exception', [ ('T', 'C', ValueError), ('C', 'T', ValueError), ]) def test_iso_with_sep_raises(sep_act, valid_sep, exception): parser = isoparser(sep=valid_sep) isostr = '2012-04-25' + sep_act + '01:25:00' with pytest.raises(exception): parser.isoparse(isostr) ### # Test ISOParser constructor @pytest.mark.parametrize('sep', [' ', '9', '🍛']) def test_isoparser_invalid_sep(sep): with pytest.raises(ValueError): isoparser(sep=sep) # This only fails on Python 3 @pytest.mark.xfail(not six.PY2, reason="Fails on Python 3 only") def test_isoparser_byte_sep(): dt = datetime(2017, 12, 6, 12, 30, 45) dt_str = dt.isoformat(sep=str('T')) dt_rt = isoparser(sep=b'T').isoparse(dt_str) assert dt == dt_rt ### # Test parse_tzstr @pytest.mark.parametrize('tzoffset', FULL_TZOFFSETS) def test_parse_tzstr(tzoffset): dt = datetime(2017, 11, 27, 6, 14, 30, 123456) date_fmt = '%Y-%m-%d' time_fmt = '%H:%M:%S.%f' _isoparse_date_and_time(dt, date_fmt, time_fmt, tzoffset) @pytest.mark.parametrize('tzstr', [ '-00:00', '+00:00', '+00', '-00', '+0000', '-0000' ]) @pytest.mark.parametrize('zero_as_utc', [True, False]) def test_parse_tzstr_zero_as_utc(tzstr, zero_as_utc): tzi = isoparser().parse_tzstr(tzstr, zero_as_utc=zero_as_utc) assert tzi == UTC assert (type(tzi) == tz.tzutc) == zero_as_utc @pytest.mark.parametrize('tzstr,exception', [ ('00:00', ValueError), # No sign ('05:00', ValueError), # No sign ('_00:00', ValueError), # Invalid sign ('+25:00', ValueError), # Offset too large ('00:0000', ValueError), # String too long ]) def test_parse_tzstr_fails(tzstr, exception): with pytest.raises(exception): isoparser().parse_tzstr(tzstr) ### # Test parse_isodate def __make_date_examples(): dates_no_day = [ date(1999, 12, 1), date(2016, 2, 1) ] if not six.PY2: # strftime does not support dates before 1900 in Python 2 dates_no_day.append(date(1000, 11, 1)) # Only one supported format for dates with no day o = zip(dates_no_day, it.repeat('%Y-%m')) dates_w_day = [ date(1969, 12, 31), date(1900, 1, 1), date(2016, 2, 29), date(2017, 11, 14) ] dates_w_day_fmts = ('%Y%m%d', '%Y-%m-%d') o = it.chain(o, it.product(dates_w_day, dates_w_day_fmts)) return list(o) @pytest.mark.parametrize('d,dt_fmt', __make_date_examples()) @pytest.mark.parametrize('as_bytes', [True, False]) def test_parse_isodate(d, dt_fmt, as_bytes): d_str = d.strftime(dt_fmt) if isinstance(d_str, six.text_type) and as_bytes: d_str = d_str.encode('ascii') elif isinstance(d_str, bytes) and not as_bytes: d_str = d_str.decode('ascii') iparser = isoparser() assert iparser.parse_isodate(d_str) == d @pytest.mark.parametrize('isostr,exception', [ ('243', ValueError), # ISO string too short ('2014-0423', ValueError), # Inconsistent date separators ('201404-23', ValueError), # Inconsistent date separators ('2014日03月14', ValueError), # Not ASCII ('2013-02-29', ValueError), # Not a leap year ('2014/12/03', ValueError), # Wrong separators ('2014-04-19T', ValueError), # Unknown components ('201202', ValueError), # Invalid format ]) def test_isodate_raises(isostr, exception): with pytest.raises(exception): isoparser().parse_isodate(isostr) def test_parse_isodate_error_text(): with pytest.raises(ValueError) as excinfo: isoparser().parse_isodate('2014-0423') # ensure the error message does not contain b' prefixes if six.PY2: expected_error = "String contains unknown ISO components: u'2014-0423'" else: expected_error = "String contains unknown ISO components: '2014-0423'" assert expected_error == str(excinfo.value) ### # Test parse_isotime def __make_time_examples(): outputs = [] # HH time_h = [time(0), time(8), time(22)] time_h_fmts = ['%H'] outputs.append(it.product(time_h, time_h_fmts)) # HHMM / HH:MM time_hm = [time(0, 0), time(0, 30), time(8, 47), time(16, 1)] time_hm_fmts = ['%H%M', '%H:%M'] outputs.append(it.product(time_hm, time_hm_fmts)) # HHMMSS / HH:MM:SS time_hms = [time(0, 0, 0), time(0, 15, 30), time(8, 2, 16), time(12, 0), time(16, 2), time(20, 45)] time_hms_fmts = ['%H%M%S', '%H:%M:%S'] outputs.append(it.product(time_hms, time_hms_fmts)) # HHMMSS.ffffff / HH:MM:SS.ffffff time_hmsu = [time(0, 0, 0, 0), time(4, 15, 3, 247993), time(14, 21, 59, 948730), time(23, 59, 59, 999999)] time_hmsu_fmts = ['%H%M%S.%f', '%H:%M:%S.%f'] outputs.append(it.product(time_hmsu, time_hmsu_fmts)) outputs = list(map(list, outputs)) # Time zones ex_naive = list(it.chain.from_iterable(x[0:2] for x in outputs)) o = it.product(ex_naive, TZOFFSETS) # ((time, fmt), (tzinfo, offsetstr)) o = ((t.replace(tzinfo=tzi), fmt + off_str) for (t, fmt), (tzi, off_str) in o) outputs.append(o) return list(it.chain.from_iterable(outputs)) @pytest.mark.parametrize('time_val,time_fmt', __make_time_examples()) @pytest.mark.parametrize('as_bytes', [True, False]) def test_isotime(time_val, time_fmt, as_bytes): tstr = time_val.strftime(time_fmt) if isinstance(tstr, six.text_type) and as_bytes: tstr = tstr.encode('ascii') elif isinstance(tstr, bytes) and not as_bytes: tstr = tstr.decode('ascii') iparser = isoparser() assert iparser.parse_isotime(tstr) == time_val @pytest.mark.parametrize('isostr', [ '24:00', '2400', '24:00:00', '240000', '24:00:00.000', '24:00:00,000', '24:00:00.000000', '24:00:00,000000', ]) def test_isotime_midnight(isostr): iparser = isoparser() assert iparser.parse_isotime(isostr) == time(0, 0, 0, 0) @pytest.mark.parametrize('isostr,exception', [ ('3', ValueError), # ISO string too short ('14時30分15秒', ValueError), # Not ASCII ('14_30_15', ValueError), # Invalid separators ('1430:15', ValueError), # Inconsistent separator use ('25', ValueError), # Invalid hours ('25:15', ValueError), # Invalid hours ('14:60', ValueError), # Invalid minutes ('14:59:61', ValueError), # Invalid seconds ('14:30:15.34468305:00', ValueError), # No sign in time zone ('14:30:15+', ValueError), # Time zone too short ('14:30:15+1234567', ValueError), # Time zone invalid ('14:59:59+25:00', ValueError), # Invalid tz hours ('14:59:59+12:62', ValueError), # Invalid tz minutes ('14:59:30_344583', ValueError), # Invalid microsecond separator ('24:01', ValueError), # 24 used for non-midnight time ('24:00:01', ValueError), # 24 used for non-midnight time ('24:00:00.001', ValueError), # 24 used for non-midnight time ('24:00:00.000001', ValueError), # 24 used for non-midnight time ]) def test_isotime_raises(isostr, exception): iparser = isoparser() with pytest.raises(exception): iparser.parse_isotime(isostr) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/test_parser.py0000644000175100001710000011324400000000000021721 0ustar00runnerdocker# -*- coding: utf-8 -*- from __future__ import unicode_literals import itertools from datetime import datetime, timedelta import unittest import sys from dateutil import tz from dateutil.tz import tzoffset from dateutil.parser import parse, parserinfo from dateutil.parser import ParserError from dateutil.parser import UnknownTimezoneWarning from ._common import TZEnvContext from six import assertRaisesRegex, PY2 from io import StringIO import pytest # Platform info IS_WIN = sys.platform.startswith('win') PLATFORM_HAS_DASH_D = False try: if datetime.now().strftime('%-d'): PLATFORM_HAS_DASH_D = True except ValueError: pass @pytest.fixture(params=[True, False]) def fuzzy(request): """Fixture to pass fuzzy=True or fuzzy=False to parse""" return request.param # Parser test cases using no keyword arguments. Format: (parsable_text, expected_datetime, assertion_message) PARSER_TEST_CASES = [ ("Thu Sep 25 10:36:28 2003", datetime(2003, 9, 25, 10, 36, 28), "date command format strip"), ("Thu Sep 25 2003", datetime(2003, 9, 25), "date command format strip"), ("2003-09-25T10:49:41", datetime(2003, 9, 25, 10, 49, 41), "iso format strip"), ("2003-09-25T10:49", datetime(2003, 9, 25, 10, 49), "iso format strip"), ("2003-09-25T10", datetime(2003, 9, 25, 10), "iso format strip"), ("2003-09-25", datetime(2003, 9, 25), "iso format strip"), ("20030925T104941", datetime(2003, 9, 25, 10, 49, 41), "iso stripped format strip"), ("20030925T1049", datetime(2003, 9, 25, 10, 49, 0), "iso stripped format strip"), ("20030925T10", datetime(2003, 9, 25, 10), "iso stripped format strip"), ("20030925", datetime(2003, 9, 25), "iso stripped format strip"), ("2003-09-25 10:49:41,502", datetime(2003, 9, 25, 10, 49, 41, 502000), "python logger format"), ("199709020908", datetime(1997, 9, 2, 9, 8), "no separator"), ("19970902090807", datetime(1997, 9, 2, 9, 8, 7), "no separator"), ("09-25-2003", datetime(2003, 9, 25), "date with dash"), ("25-09-2003", datetime(2003, 9, 25), "date with dash"), ("10-09-2003", datetime(2003, 10, 9), "date with dash"), ("10-09-03", datetime(2003, 10, 9), "date with dash"), ("2003.09.25", datetime(2003, 9, 25), "date with dot"), ("09.25.2003", datetime(2003, 9, 25), "date with dot"), ("25.09.2003", datetime(2003, 9, 25), "date with dot"), ("10.09.2003", datetime(2003, 10, 9), "date with dot"), ("10.09.03", datetime(2003, 10, 9), "date with dot"), ("2003/09/25", datetime(2003, 9, 25), "date with slash"), ("09/25/2003", datetime(2003, 9, 25), "date with slash"), ("25/09/2003", datetime(2003, 9, 25), "date with slash"), ("10/09/2003", datetime(2003, 10, 9), "date with slash"), ("10/09/03", datetime(2003, 10, 9), "date with slash"), ("2003 09 25", datetime(2003, 9, 25), "date with space"), ("09 25 2003", datetime(2003, 9, 25), "date with space"), ("25 09 2003", datetime(2003, 9, 25), "date with space"), ("10 09 2003", datetime(2003, 10, 9), "date with space"), ("10 09 03", datetime(2003, 10, 9), "date with space"), ("25 09 03", datetime(2003, 9, 25), "date with space"), ("03 25 Sep", datetime(2003, 9, 25), "strangely ordered date"), ("25 03 Sep", datetime(2025, 9, 3), "strangely ordered date"), (" July 4 , 1976 12:01:02 am ", datetime(1976, 7, 4, 0, 1, 2), "extra space"), ("Wed, July 10, '96", datetime(1996, 7, 10, 0, 0), "random format"), ("1996.July.10 AD 12:08 PM", datetime(1996, 7, 10, 12, 8), "random format"), ("July 4, 1976", datetime(1976, 7, 4), "random format"), ("7 4 1976", datetime(1976, 7, 4), "random format"), ("4 jul 1976", datetime(1976, 7, 4), "random format"), ("4 Jul 1976", datetime(1976, 7, 4), "'%-d %b %Y' format"), ("7-4-76", datetime(1976, 7, 4), "random format"), ("19760704", datetime(1976, 7, 4), "random format"), ("0:01:02 on July 4, 1976", datetime(1976, 7, 4, 0, 1, 2), "random format"), ("July 4, 1976 12:01:02 am", datetime(1976, 7, 4, 0, 1, 2), "random format"), ("Mon Jan 2 04:24:27 1995", datetime(1995, 1, 2, 4, 24, 27), "random format"), ("04.04.95 00:22", datetime(1995, 4, 4, 0, 22), "random format"), ("Jan 1 1999 11:23:34.578", datetime(1999, 1, 1, 11, 23, 34, 578000), "random format"), ("950404 122212", datetime(1995, 4, 4, 12, 22, 12), "random format"), ("3rd of May 2001", datetime(2001, 5, 3), "random format"), ("5th of March 2001", datetime(2001, 3, 5), "random format"), ("1st of May 2003", datetime(2003, 5, 1), "random format"), ('0099-01-01T00:00:00', datetime(99, 1, 1, 0, 0), "99 ad"), ('0031-01-01T00:00:00', datetime(31, 1, 1, 0, 0), "31 ad"), ("20080227T21:26:01.123456789", datetime(2008, 2, 27, 21, 26, 1, 123456), "high precision seconds"), ('13NOV2017', datetime(2017, 11, 13), "dBY (See GH360)"), ('0003-03-04', datetime(3, 3, 4), "pre 12 year same month (See GH PR #293)"), ('December.0031.30', datetime(31, 12, 30), "BYd corner case (GH#687)"), # Cases with legacy h/m/s format, candidates for deprecation (GH#886) ("2016-12-21 04.2h", datetime(2016, 12, 21, 4, 12), "Fractional Hours"), ] # Check that we don't have any duplicates assert len(set([x[0] for x in PARSER_TEST_CASES])) == len(PARSER_TEST_CASES) @pytest.mark.parametrize("parsable_text,expected_datetime,assertion_message", PARSER_TEST_CASES) def test_parser(parsable_text, expected_datetime, assertion_message): assert parse(parsable_text) == expected_datetime, assertion_message # Parser test cases using datetime(2003, 9, 25) as a default. # Format: (parsable_text, expected_datetime, assertion_message) PARSER_DEFAULT_TEST_CASES = [ ("Thu Sep 25 10:36:28", datetime(2003, 9, 25, 10, 36, 28), "date command format strip"), ("Thu Sep 10:36:28", datetime(2003, 9, 25, 10, 36, 28), "date command format strip"), ("Thu 10:36:28", datetime(2003, 9, 25, 10, 36, 28), "date command format strip"), ("Sep 10:36:28", datetime(2003, 9, 25, 10, 36, 28), "date command format strip"), ("10:36:28", datetime(2003, 9, 25, 10, 36, 28), "date command format strip"), ("10:36", datetime(2003, 9, 25, 10, 36), "date command format strip"), ("Sep 2003", datetime(2003, 9, 25), "date command format strip"), ("Sep", datetime(2003, 9, 25), "date command format strip"), ("2003", datetime(2003, 9, 25), "date command format strip"), ("10h36m28.5s", datetime(2003, 9, 25, 10, 36, 28, 500000), "hour with letters"), ("10h36m28s", datetime(2003, 9, 25, 10, 36, 28), "hour with letters strip"), ("10h36m", datetime(2003, 9, 25, 10, 36), "hour with letters strip"), ("10h", datetime(2003, 9, 25, 10), "hour with letters strip"), ("10 h 36", datetime(2003, 9, 25, 10, 36), "hour with letters strip"), ("10 h 36.5", datetime(2003, 9, 25, 10, 36, 30), "hour with letter strip"), ("36 m 5", datetime(2003, 9, 25, 0, 36, 5), "hour with letters spaces"), ("36 m 5 s", datetime(2003, 9, 25, 0, 36, 5), "minute with letters spaces"), ("36 m 05", datetime(2003, 9, 25, 0, 36, 5), "minute with letters spaces"), ("36 m 05 s", datetime(2003, 9, 25, 0, 36, 5), "minutes with letters spaces"), ("10h am", datetime(2003, 9, 25, 10), "hour am pm"), ("10h pm", datetime(2003, 9, 25, 22), "hour am pm"), ("10am", datetime(2003, 9, 25, 10), "hour am pm"), ("10pm", datetime(2003, 9, 25, 22), "hour am pm"), ("10:00 am", datetime(2003, 9, 25, 10), "hour am pm"), ("10:00 pm", datetime(2003, 9, 25, 22), "hour am pm"), ("10:00am", datetime(2003, 9, 25, 10), "hour am pm"), ("10:00pm", datetime(2003, 9, 25, 22), "hour am pm"), ("10:00a.m", datetime(2003, 9, 25, 10), "hour am pm"), ("10:00p.m", datetime(2003, 9, 25, 22), "hour am pm"), ("10:00a.m.", datetime(2003, 9, 25, 10), "hour am pm"), ("10:00p.m.", datetime(2003, 9, 25, 22), "hour am pm"), ("Wed", datetime(2003, 10, 1), "weekday alone"), ("Wednesday", datetime(2003, 10, 1), "long weekday"), ("October", datetime(2003, 10, 25), "long month"), ("31-Dec-00", datetime(2000, 12, 31), "zero year"), ("0:01:02", datetime(2003, 9, 25, 0, 1, 2), "random format"), ("12h 01m02s am", datetime(2003, 9, 25, 0, 1, 2), "random format"), ("12:08 PM", datetime(2003, 9, 25, 12, 8), "random format"), ("01h02m03", datetime(2003, 9, 25, 1, 2, 3), "random format"), ("01h02", datetime(2003, 9, 25, 1, 2), "random format"), ("01h02s", datetime(2003, 9, 25, 1, 0, 2), "random format"), ("01m02", datetime(2003, 9, 25, 0, 1, 2), "random format"), ("01m02h", datetime(2003, 9, 25, 2, 1), "random format"), ("2004 10 Apr 11h30m", datetime(2004, 4, 10, 11, 30), "random format") ] # Check that we don't have any duplicates assert len(set([x[0] for x in PARSER_DEFAULT_TEST_CASES])) == len(PARSER_DEFAULT_TEST_CASES) @pytest.mark.parametrize("parsable_text,expected_datetime,assertion_message", PARSER_DEFAULT_TEST_CASES) def test_parser_default(parsable_text, expected_datetime, assertion_message): assert parse(parsable_text, default=datetime(2003, 9, 25)) == expected_datetime, assertion_message @pytest.mark.parametrize('sep', ['-', '.', '/', ' ']) def test_parse_dayfirst(sep): expected = datetime(2003, 9, 10) fmt = sep.join(['%d', '%m', '%Y']) dstr = expected.strftime(fmt) result = parse(dstr, dayfirst=True) assert result == expected @pytest.mark.parametrize('sep', ['-', '.', '/', ' ']) def test_parse_yearfirst(sep): expected = datetime(2010, 9, 3) fmt = sep.join(['%Y', '%m', '%d']) dstr = expected.strftime(fmt) result = parse(dstr, yearfirst=True) assert result == expected @pytest.mark.parametrize('dstr,expected', [ ("Thu Sep 25 10:36:28 BRST 2003", datetime(2003, 9, 25, 10, 36, 28)), ("1996.07.10 AD at 15:08:56 PDT", datetime(1996, 7, 10, 15, 8, 56)), ("Tuesday, April 12, 1952 AD 3:30:42pm PST", datetime(1952, 4, 12, 15, 30, 42)), ("November 5, 1994, 8:15:30 am EST", datetime(1994, 11, 5, 8, 15, 30)), ("1994-11-05T08:15:30-05:00", datetime(1994, 11, 5, 8, 15, 30)), ("1994-11-05T08:15:30Z", datetime(1994, 11, 5, 8, 15, 30)), ("1976-07-04T00:01:02Z", datetime(1976, 7, 4, 0, 1, 2)), ("1986-07-05T08:15:30z", datetime(1986, 7, 5, 8, 15, 30)), ("Tue Apr 4 00:22:12 PDT 1995", datetime(1995, 4, 4, 0, 22, 12)), ]) def test_parse_ignoretz(dstr, expected): result = parse(dstr, ignoretz=True) assert result == expected _brsttz = tzoffset("BRST", -10800) @pytest.mark.parametrize('dstr,expected', [ ("20030925T104941-0300", datetime(2003, 9, 25, 10, 49, 41, tzinfo=_brsttz)), ("Thu, 25 Sep 2003 10:49:41 -0300", datetime(2003, 9, 25, 10, 49, 41, tzinfo=_brsttz)), ("2003-09-25T10:49:41.5-03:00", datetime(2003, 9, 25, 10, 49, 41, 500000, tzinfo=_brsttz)), ("2003-09-25T10:49:41-03:00", datetime(2003, 9, 25, 10, 49, 41, tzinfo=_brsttz)), ("20030925T104941.5-0300", datetime(2003, 9, 25, 10, 49, 41, 500000, tzinfo=_brsttz)), ]) def test_parse_with_tzoffset(dstr, expected): # In these cases, we are _not_ passing a tzinfos arg result = parse(dstr) assert result == expected class TestFormat(object): def test_ybd(self): # If we have a 4-digit year, a non-numeric month (abbreviated or not), # and a day (1 or 2 digits), then there is no ambiguity as to which # token is a year/month/day. This holds regardless of what order the # terms are in and for each of the separators below. seps = ['-', ' ', '/', '.'] year_tokens = ['%Y'] month_tokens = ['%b', '%B'] day_tokens = ['%d'] if PLATFORM_HAS_DASH_D: day_tokens.append('%-d') prods = itertools.product(year_tokens, month_tokens, day_tokens) perms = [y for x in prods for y in itertools.permutations(x)] unambig_fmts = [sep.join(perm) for sep in seps for perm in perms] actual = datetime(2003, 9, 25) for fmt in unambig_fmts: dstr = actual.strftime(fmt) res = parse(dstr) assert res == actual # TODO: some redundancy with PARSER_TEST_CASES cases @pytest.mark.parametrize("fmt,dstr", [ ("%a %b %d %Y", "Thu Sep 25 2003"), ("%b %d %Y", "Sep 25 2003"), ("%Y-%m-%d", "2003-09-25"), ("%Y%m%d", "20030925"), ("%Y-%b-%d", "2003-Sep-25"), ("%d-%b-%Y", "25-Sep-2003"), ("%b-%d-%Y", "Sep-25-2003"), ("%m-%d-%Y", "09-25-2003"), ("%d-%m-%Y", "25-09-2003"), ("%Y.%m.%d", "2003.09.25"), ("%Y.%b.%d", "2003.Sep.25"), ("%d.%b.%Y", "25.Sep.2003"), ("%b.%d.%Y", "Sep.25.2003"), ("%m.%d.%Y", "09.25.2003"), ("%d.%m.%Y", "25.09.2003"), ("%Y/%m/%d", "2003/09/25"), ("%Y/%b/%d", "2003/Sep/25"), ("%d/%b/%Y", "25/Sep/2003"), ("%b/%d/%Y", "Sep/25/2003"), ("%m/%d/%Y", "09/25/2003"), ("%d/%m/%Y", "25/09/2003"), ("%Y %m %d", "2003 09 25"), ("%Y %b %d", "2003 Sep 25"), ("%d %b %Y", "25 Sep 2003"), ("%m %d %Y", "09 25 2003"), ("%d %m %Y", "25 09 2003"), ("%y %d %b", "03 25 Sep",), ]) def test_strftime_formats_2003Sep25(self, fmt, dstr): expected = datetime(2003, 9, 25) # First check that the format strings behave as expected # (not strictly necessary, but nice to have) assert expected.strftime(fmt) == dstr res = parse(dstr) assert res == expected class TestInputTypes(object): def test_empty_string_invalid(self): with pytest.raises(ParserError): parse('') def test_none_invalid(self): with pytest.raises(TypeError): parse(None) def test_int_invalid(self): with pytest.raises(TypeError): parse(13) def test_duck_typing(self): # We want to support arbitrary classes that implement the stream # interface. class StringPassThrough(object): def __init__(self, stream): self.stream = stream def read(self, *args, **kwargs): return self.stream.read(*args, **kwargs) dstr = StringPassThrough(StringIO('2014 January 19')) res = parse(dstr) expected = datetime(2014, 1, 19) assert res == expected def test_parse_stream(self): dstr = StringIO('2014 January 19') res = parse(dstr) expected = datetime(2014, 1, 19) assert res == expected def test_parse_str(self): # Parser should be able to handle bytestring and unicode uni_str = '2014-05-01 08:00:00' bytes_str = uni_str.encode() res = parse(bytes_str) expected = parse(uni_str) assert res == expected def test_parse_bytes(self): res = parse(b'2014 January 19') expected = datetime(2014, 1, 19) assert res == expected def test_parse_bytearray(self): # GH#417 res = parse(bytearray(b'2014 January 19')) expected = datetime(2014, 1, 19) assert res == expected class TestTzinfoInputTypes(object): def assert_equal_same_tz(self, dt1, dt2): assert dt1 == dt2 assert dt1.tzinfo is dt2.tzinfo def test_tzinfo_dict_could_return_none(self): dstr = "2017-02-03 12:40 BRST" result = parse(dstr, tzinfos={"BRST": None}) expected = datetime(2017, 2, 3, 12, 40) self.assert_equal_same_tz(result, expected) def test_tzinfos_callable_could_return_none(self): dstr = "2017-02-03 12:40 BRST" result = parse(dstr, tzinfos=lambda *args: None) expected = datetime(2017, 2, 3, 12, 40) self.assert_equal_same_tz(result, expected) def test_invalid_tzinfo_input(self): dstr = "2014 January 19 09:00 UTC" # Pass an absurd tzinfos object tzinfos = {"UTC": ValueError} with pytest.raises(TypeError): parse(dstr, tzinfos=tzinfos) def test_valid_tzinfo_tzinfo_input(self): dstr = "2014 January 19 09:00 UTC" tzinfos = {"UTC": tz.UTC} expected = datetime(2014, 1, 19, 9, tzinfo=tz.UTC) res = parse(dstr, tzinfos=tzinfos) self.assert_equal_same_tz(res, expected) def test_valid_tzinfo_unicode_input(self): dstr = "2014 January 19 09:00 UTC" tzinfos = {u"UTC": u"UTC+0"} expected = datetime(2014, 1, 19, 9, tzinfo=tz.tzstr("UTC+0")) res = parse(dstr, tzinfos=tzinfos) self.assert_equal_same_tz(res, expected) def test_valid_tzinfo_callable_input(self): dstr = "2014 January 19 09:00 UTC" def tzinfos(*args, **kwargs): return u"UTC+0" expected = datetime(2014, 1, 19, 9, tzinfo=tz.tzstr("UTC+0")) res = parse(dstr, tzinfos=tzinfos) self.assert_equal_same_tz(res, expected) def test_valid_tzinfo_int_input(self): dstr = "2014 January 19 09:00 UTC" tzinfos = {u"UTC": -28800} expected = datetime(2014, 1, 19, 9, tzinfo=tz.tzoffset(u"UTC", -28800)) res = parse(dstr, tzinfos=tzinfos) self.assert_equal_same_tz(res, expected) class ParserTest(unittest.TestCase): @classmethod def setup_class(cls): cls.tzinfos = {"BRST": -10800} cls.brsttz = tzoffset("BRST", -10800) cls.default = datetime(2003, 9, 25) # Parser should be able to handle bytestring and unicode cls.uni_str = '2014-05-01 08:00:00' cls.str_str = cls.uni_str.encode() def testParserParseStr(self): from dateutil.parser import parser assert parser().parse(self.str_str) == parser().parse(self.uni_str) def testParseUnicodeWords(self): class rus_parserinfo(parserinfo): MONTHS = [("янв", "Январь"), ("фев", "Февраль"), ("мар", "Март"), ("апр", "Апрель"), ("май", "Май"), ("июн", "Июнь"), ("июл", "Июль"), ("авг", "Август"), ("сен", "Сентябрь"), ("окт", "Октябрь"), ("ноя", "Ноябрь"), ("дек", "Декабрь")] expected = datetime(2015, 9, 10, 10, 20) res = parse('10 Сентябрь 2015 10:20', parserinfo=rus_parserinfo()) assert res == expected def testParseWithNulls(self): # This relies on the from __future__ import unicode_literals, because # explicitly specifying a unicode literal is a syntax error in Py 3.2 # May want to switch to u'...' if we ever drop Python 3.2 support. pstring = '\x00\x00August 29, 1924' assert parse(pstring) == datetime(1924, 8, 29) def testDateCommandFormat(self): self.assertEqual(parse("Thu Sep 25 10:36:28 BRST 2003", tzinfos=self.tzinfos), datetime(2003, 9, 25, 10, 36, 28, tzinfo=self.brsttz)) def testDateCommandFormatReversed(self): self.assertEqual(parse("2003 10:36:28 BRST 25 Sep Thu", tzinfos=self.tzinfos), datetime(2003, 9, 25, 10, 36, 28, tzinfo=self.brsttz)) def testDateCommandFormatWithLong(self): if PY2: self.assertEqual(parse("Thu Sep 25 10:36:28 BRST 2003", tzinfos={"BRST": long(-10800)}), datetime(2003, 9, 25, 10, 36, 28, tzinfo=self.brsttz)) def testISOFormatStrip2(self): self.assertEqual(parse("2003-09-25T10:49:41+03:00"), datetime(2003, 9, 25, 10, 49, 41, tzinfo=tzoffset(None, 10800))) def testISOStrippedFormatStrip2(self): self.assertEqual(parse("20030925T104941+0300"), datetime(2003, 9, 25, 10, 49, 41, tzinfo=tzoffset(None, 10800))) def testAMPMNoHour(self): with pytest.raises(ParserError): parse("AM") with pytest.raises(ParserError): parse("Jan 20, 2015 PM") def testAMPMRange(self): with pytest.raises(ParserError): parse("13:44 AM") with pytest.raises(ParserError): parse("January 25, 1921 23:13 PM") def testPertain(self): self.assertEqual(parse("Sep 03", default=self.default), datetime(2003, 9, 3)) self.assertEqual(parse("Sep of 03", default=self.default), datetime(2003, 9, 25)) def testFuzzy(self): s = "Today is 25 of September of 2003, exactly " \ "at 10:49:41 with timezone -03:00." self.assertEqual(parse(s, fuzzy=True), datetime(2003, 9, 25, 10, 49, 41, tzinfo=self.brsttz)) def testFuzzyWithTokens(self): s1 = "Today is 25 of September of 2003, exactly " \ "at 10:49:41 with timezone -03:00." self.assertEqual(parse(s1, fuzzy_with_tokens=True), (datetime(2003, 9, 25, 10, 49, 41, tzinfo=self.brsttz), ('Today is ', 'of ', ', exactly at ', ' with timezone ', '.'))) s2 = "http://biz.yahoo.com/ipo/p/600221.html" self.assertEqual(parse(s2, fuzzy_with_tokens=True), (datetime(2060, 2, 21, 0, 0, 0), ('http://biz.yahoo.com/ipo/p/', '.html'))) def testFuzzyAMPMProblem(self): # Sometimes fuzzy parsing results in AM/PM flag being set without # hours - if it's fuzzy it should ignore that. s1 = "I have a meeting on March 1, 1974." s2 = "On June 8th, 2020, I am going to be the first man on Mars" # Also don't want any erroneous AM or PMs changing the parsed time s3 = "Meet me at the AM/PM on Sunset at 3:00 AM on December 3rd, 2003" s4 = "Meet me at 3:00AM on December 3rd, 2003 at the AM/PM on Sunset" self.assertEqual(parse(s1, fuzzy=True), datetime(1974, 3, 1)) self.assertEqual(parse(s2, fuzzy=True), datetime(2020, 6, 8)) self.assertEqual(parse(s3, fuzzy=True), datetime(2003, 12, 3, 3)) self.assertEqual(parse(s4, fuzzy=True), datetime(2003, 12, 3, 3)) def testFuzzyIgnoreAMPM(self): s1 = "Jan 29, 1945 14:45 AM I going to see you there?" with pytest.warns(UnknownTimezoneWarning): res = parse(s1, fuzzy=True) self.assertEqual(res, datetime(1945, 1, 29, 14, 45)) def testRandomFormat24(self): self.assertEqual(parse("0:00 PM, PST", default=self.default, ignoretz=True), datetime(2003, 9, 25, 12, 0)) def testRandomFormat26(self): with pytest.warns(UnknownTimezoneWarning): res = parse("5:50 A.M. on June 13, 1990") self.assertEqual(res, datetime(1990, 6, 13, 5, 50)) def testUnspecifiedDayFallback(self): # Test that for an unspecified day, the fallback behavior is correct. self.assertEqual(parse("April 2009", default=datetime(2010, 1, 31)), datetime(2009, 4, 30)) def testUnspecifiedDayFallbackFebNoLeapYear(self): self.assertEqual(parse("Feb 2007", default=datetime(2010, 1, 31)), datetime(2007, 2, 28)) def testUnspecifiedDayFallbackFebLeapYear(self): self.assertEqual(parse("Feb 2008", default=datetime(2010, 1, 31)), datetime(2008, 2, 29)) def testErrorType01(self): with pytest.raises(ParserError): parse('shouldfail') def testCorrectErrorOnFuzzyWithTokens(self): assertRaisesRegex(self, ParserError, 'Unknown string format', parse, '04/04/32/423', fuzzy_with_tokens=True) assertRaisesRegex(self, ParserError, 'Unknown string format', parse, '04/04/04 +32423', fuzzy_with_tokens=True) assertRaisesRegex(self, ParserError, 'Unknown string format', parse, '04/04/0d4', fuzzy_with_tokens=True) def testIncreasingCTime(self): # This test will check 200 different years, every month, every day, # every hour, every minute, every second, and every weekday, using # a delta of more or less 1 year, 1 month, 1 day, 1 minute and # 1 second. delta = timedelta(days=365+31+1, seconds=1+60+60*60) dt = datetime(1900, 1, 1, 0, 0, 0, 0) for i in range(200): assert parse(dt.ctime()) == dt dt += delta def testIncreasingISOFormat(self): delta = timedelta(days=365+31+1, seconds=1+60+60*60) dt = datetime(1900, 1, 1, 0, 0, 0, 0) for i in range(200): assert parse(dt.isoformat()) == dt dt += delta def testMicrosecondsPrecisionError(self): # Skip found out that sad precision problem. :-( dt1 = parse("00:11:25.01") dt2 = parse("00:12:10.01") assert dt1.microsecond == 10000 assert dt2.microsecond == 10000 def testMicrosecondPrecisionErrorReturns(self): # One more precision issue, discovered by Eric Brown. This should # be the last one, as we're no longer using floating points. for ms in [100001, 100000, 99999, 99998, 10001, 10000, 9999, 9998, 1001, 1000, 999, 998, 101, 100, 99, 98]: dt = datetime(2008, 2, 27, 21, 26, 1, ms) assert parse(dt.isoformat()) == dt def testCustomParserInfo(self): # Custom parser info wasn't working, as Michael Elsdörfer discovered. from dateutil.parser import parserinfo, parser class myparserinfo(parserinfo): MONTHS = parserinfo.MONTHS[:] MONTHS[0] = ("Foo", "Foo") myparser = parser(myparserinfo()) dt = myparser.parse("01/Foo/2007") assert dt == datetime(2007, 1, 1) def testCustomParserShortDaynames(self): # Horacio Hoyos discovered that day names shorter than 3 characters, # for example two letter German day name abbreviations, don't work: # https://github.com/dateutil/dateutil/issues/343 from dateutil.parser import parserinfo, parser class GermanParserInfo(parserinfo): WEEKDAYS = [("Mo", "Montag"), ("Di", "Dienstag"), ("Mi", "Mittwoch"), ("Do", "Donnerstag"), ("Fr", "Freitag"), ("Sa", "Samstag"), ("So", "Sonntag")] myparser = parser(GermanParserInfo()) dt = myparser.parse("Sa 21. Jan 2017") self.assertEqual(dt, datetime(2017, 1, 21)) def testNoYearFirstNoDayFirst(self): dtstr = '090107' # Should be MMDDYY self.assertEqual(parse(dtstr), datetime(2007, 9, 1)) self.assertEqual(parse(dtstr, yearfirst=False, dayfirst=False), datetime(2007, 9, 1)) def testYearFirst(self): dtstr = '090107' # Should be MMDDYY self.assertEqual(parse(dtstr, yearfirst=True), datetime(2009, 1, 7)) self.assertEqual(parse(dtstr, yearfirst=True, dayfirst=False), datetime(2009, 1, 7)) def testDayFirst(self): dtstr = '090107' # Should be DDMMYY self.assertEqual(parse(dtstr, dayfirst=True), datetime(2007, 1, 9)) self.assertEqual(parse(dtstr, yearfirst=False, dayfirst=True), datetime(2007, 1, 9)) def testDayFirstYearFirst(self): dtstr = '090107' # Should be YYDDMM self.assertEqual(parse(dtstr, yearfirst=True, dayfirst=True), datetime(2009, 7, 1)) def testUnambiguousYearFirst(self): dtstr = '2015 09 25' self.assertEqual(parse(dtstr, yearfirst=True), datetime(2015, 9, 25)) def testUnambiguousDayFirst(self): dtstr = '2015 09 25' self.assertEqual(parse(dtstr, dayfirst=True), datetime(2015, 9, 25)) def testUnambiguousDayFirstYearFirst(self): dtstr = '2015 09 25' self.assertEqual(parse(dtstr, dayfirst=True, yearfirst=True), datetime(2015, 9, 25)) def test_mstridx(self): # See GH408 dtstr = '2015-15-May' self.assertEqual(parse(dtstr), datetime(2015, 5, 15)) def test_idx_check(self): dtstr = '2017-07-17 06:15:' # Pre-PR, the trailing colon will cause an IndexError at 824-825 # when checking `i < len_l` and then accessing `l[i+1]` res = parse(dtstr, fuzzy=True) assert res == datetime(2017, 7, 17, 6, 15) def test_hmBY(self): # See GH#483 dtstr = '02:17NOV2017' res = parse(dtstr, default=self.default) assert res == datetime(2017, 11, self.default.day, 2, 17) def test_validate_hour(self): # See GH353 invalid = "201A-01-01T23:58:39.239769+03:00" with pytest.raises(ParserError): parse(invalid) def test_era_trailing_year(self): dstr = 'AD2001' res = parse(dstr) assert res.year == 2001, res def test_includes_timestr(self): timestr = "2020-13-97T44:61:83" try: parse(timestr) except ParserError as e: assert e.args[1] == timestr else: pytest.fail("Failed to raise ParserError") class TestOutOfBounds(object): def test_no_year_zero(self): with pytest.raises(ParserError): parse("0000 Jun 20") def test_out_of_bound_day(self): with pytest.raises(ParserError): parse("Feb 30, 2007") def test_illegal_month_error(self): with pytest.raises(ParserError): parse("0-100") def test_day_sanity(self, fuzzy): dstr = "2014-15-25" with pytest.raises(ParserError): parse(dstr, fuzzy=fuzzy) def test_minute_sanity(self, fuzzy): dstr = "2014-02-28 22:64" with pytest.raises(ParserError): parse(dstr, fuzzy=fuzzy) def test_hour_sanity(self, fuzzy): dstr = "2014-02-28 25:16 PM" with pytest.raises(ParserError): parse(dstr, fuzzy=fuzzy) def test_second_sanity(self, fuzzy): dstr = "2014-02-28 22:14:64" with pytest.raises(ParserError): parse(dstr, fuzzy=fuzzy) class TestParseUnimplementedCases(object): @pytest.mark.xfail def test_somewhat_ambiguous_string(self): # Ref: github issue #487 # The parser is choosing the wrong part for hour # causing datetime to raise an exception. dtstr = '1237 PM BRST Mon Oct 30 2017' res = parse(dtstr, tzinfo=self.tzinfos) assert res == datetime(2017, 10, 30, 12, 37, tzinfo=self.tzinfos) @pytest.mark.xfail def test_YmdH_M_S(self): # found in nasdaq's ftp data dstr = '1991041310:19:24' expected = datetime(1991, 4, 13, 10, 19, 24) res = parse(dstr) assert res == expected, (res, expected) @pytest.mark.xfail def test_first_century(self): dstr = '0031 Nov 03' expected = datetime(31, 11, 3) res = parse(dstr) assert res == expected, res @pytest.mark.xfail def test_era_trailing_year_with_dots(self): dstr = 'A.D.2001' res = parse(dstr) assert res.year == 2001, res @pytest.mark.xfail def test_ad_nospace(self): expected = datetime(6, 5, 19) for dstr in [' 6AD May 19', ' 06AD May 19', ' 006AD May 19', ' 0006AD May 19']: res = parse(dstr) assert res == expected, (dstr, res) @pytest.mark.xfail def test_four_letter_day(self): dstr = 'Frid Dec 30, 2016' expected = datetime(2016, 12, 30) res = parse(dstr) assert res == expected @pytest.mark.xfail def test_non_date_number(self): dstr = '1,700' with pytest.raises(ParserError): parse(dstr) @pytest.mark.xfail def test_on_era(self): # This could be classified as an "eras" test, but the relevant part # about this is the ` on ` dstr = '2:15 PM on January 2nd 1973 A.D.' expected = datetime(1973, 1, 2, 14, 15) res = parse(dstr) assert res == expected @pytest.mark.xfail def test_extraneous_year(self): # This was found in the wild at insidertrading.org dstr = "2011 MARTIN CHILDREN'S IRREVOCABLE TRUST u/a/d NOVEMBER 7, 2012" res = parse(dstr, fuzzy_with_tokens=True) expected = datetime(2012, 11, 7) assert res == expected @pytest.mark.xfail def test_extraneous_year_tokens(self): # This was found in the wild at insidertrading.org # Unlike in the case above, identifying the first "2012" as the year # would not be a problem, but inferring that the latter 2012 is hhmm # is a problem. dstr = "2012 MARTIN CHILDREN'S IRREVOCABLE TRUST u/a/d NOVEMBER 7, 2012" expected = datetime(2012, 11, 7) (res, tokens) = parse(dstr, fuzzy_with_tokens=True) assert res == expected assert tokens == ("2012 MARTIN CHILDREN'S IRREVOCABLE TRUST u/a/d ",) @pytest.mark.xfail def test_extraneous_year2(self): # This was found in the wild at insidertrading.org dstr = ("Berylson Amy Smith 1998 Grantor Retained Annuity Trust " "u/d/t November 2, 1998 f/b/o Jennifer L Berylson") res = parse(dstr, fuzzy_with_tokens=True) expected = datetime(1998, 11, 2) assert res == expected @pytest.mark.xfail def test_extraneous_year3(self): # This was found in the wild at insidertrading.org dstr = "SMITH R & WEISS D 94 CHILD TR FBO M W SMITH UDT 12/1/1994" res = parse(dstr, fuzzy_with_tokens=True) expected = datetime(1994, 12, 1) assert res == expected @pytest.mark.xfail def test_unambiguous_YYYYMM(self): # 171206 can be parsed as YYMMDD. However, 201712 cannot be parsed # as instance of YYMMDD and parser could fallback to YYYYMM format. dstr = "201712" res = parse(dstr) expected = datetime(2017, 12, 1) assert res == expected @pytest.mark.xfail def test_extraneous_numerical_content(self): # ref: https://github.com/dateutil/dateutil/issues/1029 # parser interprets price and percentage as parts of the date dstr = "£14.99 (25% off, until April 20)" res = parse(dstr, fuzzy=True, default=datetime(2000, 1, 1)) expected = datetime(2000, 4, 20) assert res == expected @pytest.mark.skipif(IS_WIN, reason="Windows does not use TZ var") class TestTZVar(object): def test_parse_unambiguous_nonexistent_local(self): # When dates are specified "EST" even when they should be "EDT" in the # local time zone, we should still assign the local time zone with TZEnvContext('EST+5EDT,M3.2.0/2,M11.1.0/2'): dt_exp = datetime(2011, 8, 1, 12, 30, tzinfo=tz.tzlocal()) dt = parse('2011-08-01T12:30 EST') assert dt.tzname() == 'EDT' assert dt == dt_exp def test_tzlocal_in_gmt(self): # GH #318 with TZEnvContext('GMT0BST,M3.5.0,M10.5.0'): # This is an imaginary datetime in tz.tzlocal() but should still # parse using the GMT-as-alias-for-UTC rule dt = parse('2004-05-01T12:00 GMT') dt_exp = datetime(2004, 5, 1, 12, tzinfo=tz.UTC) assert dt == dt_exp def test_tzlocal_parse_fold(self): # One manifestion of GH #318 with TZEnvContext('EST+5EDT,M3.2.0/2,M11.1.0/2'): dt_exp = datetime(2011, 11, 6, 1, 30, tzinfo=tz.tzlocal()) dt_exp = tz.enfold(dt_exp, fold=1) dt = parse('2011-11-06T01:30 EST') # Because this is ambiguous, until `tz.tzlocal() is tz.tzlocal()` # we'll just check the attributes we care about rather than # dt == dt_exp assert dt.tzname() == dt_exp.tzname() assert dt.replace(tzinfo=None) == dt_exp.replace(tzinfo=None) assert getattr(dt, 'fold') == getattr(dt_exp, 'fold') assert dt.astimezone(tz.UTC) == dt_exp.astimezone(tz.UTC) def test_parse_tzinfos_fold(): NYC = tz.gettz('America/New_York') tzinfos = {'EST': NYC, 'EDT': NYC} dt_exp = tz.enfold(datetime(2011, 11, 6, 1, 30, tzinfo=NYC), fold=1) dt = parse('2011-11-06T01:30 EST', tzinfos=tzinfos) assert dt == dt_exp assert dt.tzinfo is dt_exp.tzinfo assert getattr(dt, 'fold') == getattr(dt_exp, 'fold') assert dt.astimezone(tz.UTC) == dt_exp.astimezone(tz.UTC) @pytest.mark.parametrize('dtstr,dt', [ ('5.6h', datetime(2003, 9, 25, 5, 36)), ('5.6m', datetime(2003, 9, 25, 0, 5, 36)), # '5.6s' never had a rounding problem, test added for completeness ('5.6s', datetime(2003, 9, 25, 0, 0, 5, 600000)) ]) def test_rounding_floatlike_strings(dtstr, dt): assert parse(dtstr, default=datetime(2003, 9, 25)) == dt @pytest.mark.parametrize('value', ['1: test', 'Nan']) def test_decimal_error(value): # GH 632, GH 662 - decimal.Decimal raises some non-ParserError exception # when constructed with an invalid value with pytest.raises(ParserError): parse(value) def test_parsererror_repr(): # GH 991 — the __repr__ was not properly indented and so was never defined. # This tests the current behavior of the ParserError __repr__, but the # precise format is not guaranteed to be stable and may change even in # minor versions. This test exists to avoid regressions. s = repr(ParserError("Problem with string: %s", "2019-01-01")) assert s == "ParserError('Problem with string: %s', '2019-01-01')" ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/test_relativedelta.py0000644000175100001710000006503700000000000023260 0ustar00runnerdocker# -*- coding: utf-8 -*- from __future__ import unicode_literals from ._common import NotAValue import calendar from datetime import datetime, date, timedelta import unittest import pytest from dateutil.relativedelta import relativedelta, MO, TU, WE, FR, SU class RelativeDeltaTest(unittest.TestCase): now = datetime(2003, 9, 17, 20, 54, 47, 282310) today = date(2003, 9, 17) def testInheritance(self): # Ensure that relativedelta is inheritance-friendly. class rdChildClass(relativedelta): pass ccRD = rdChildClass(years=1, months=1, days=1, leapdays=1, weeks=1, hours=1, minutes=1, seconds=1, microseconds=1) rd = relativedelta(years=1, months=1, days=1, leapdays=1, weeks=1, hours=1, minutes=1, seconds=1, microseconds=1) self.assertEqual(type(ccRD + rd), type(ccRD), msg='Addition does not inherit type.') self.assertEqual(type(ccRD - rd), type(ccRD), msg='Subtraction does not inherit type.') self.assertEqual(type(-ccRD), type(ccRD), msg='Negation does not inherit type.') self.assertEqual(type(ccRD * 5.0), type(ccRD), msg='Multiplication does not inherit type.') self.assertEqual(type(ccRD / 5.0), type(ccRD), msg='Division does not inherit type.') def testMonthEndMonthBeginning(self): self.assertEqual(relativedelta(datetime(2003, 1, 31, 23, 59, 59), datetime(2003, 3, 1, 0, 0, 0)), relativedelta(months=-1, seconds=-1)) self.assertEqual(relativedelta(datetime(2003, 3, 1, 0, 0, 0), datetime(2003, 1, 31, 23, 59, 59)), relativedelta(months=1, seconds=1)) def testMonthEndMonthBeginningLeapYear(self): self.assertEqual(relativedelta(datetime(2012, 1, 31, 23, 59, 59), datetime(2012, 3, 1, 0, 0, 0)), relativedelta(months=-1, seconds=-1)) self.assertEqual(relativedelta(datetime(2003, 3, 1, 0, 0, 0), datetime(2003, 1, 31, 23, 59, 59)), relativedelta(months=1, seconds=1)) def testNextMonth(self): self.assertEqual(self.now+relativedelta(months=+1), datetime(2003, 10, 17, 20, 54, 47, 282310)) def testNextMonthPlusOneWeek(self): self.assertEqual(self.now+relativedelta(months=+1, weeks=+1), datetime(2003, 10, 24, 20, 54, 47, 282310)) def testNextMonthPlusOneWeek10am(self): self.assertEqual(self.today + relativedelta(months=+1, weeks=+1, hour=10), datetime(2003, 10, 24, 10, 0)) def testNextMonthPlusOneWeek10amDiff(self): self.assertEqual(relativedelta(datetime(2003, 10, 24, 10, 0), self.today), relativedelta(months=+1, days=+7, hours=+10)) def testOneMonthBeforeOneYear(self): self.assertEqual(self.now+relativedelta(years=+1, months=-1), datetime(2004, 8, 17, 20, 54, 47, 282310)) def testMonthsOfDiffNumOfDays(self): self.assertEqual(date(2003, 1, 27)+relativedelta(months=+1), date(2003, 2, 27)) self.assertEqual(date(2003, 1, 31)+relativedelta(months=+1), date(2003, 2, 28)) self.assertEqual(date(2003, 1, 31)+relativedelta(months=+2), date(2003, 3, 31)) def testMonthsOfDiffNumOfDaysWithYears(self): self.assertEqual(date(2000, 2, 28)+relativedelta(years=+1), date(2001, 2, 28)) self.assertEqual(date(2000, 2, 29)+relativedelta(years=+1), date(2001, 2, 28)) self.assertEqual(date(1999, 2, 28)+relativedelta(years=+1), date(2000, 2, 28)) self.assertEqual(date(1999, 3, 1)+relativedelta(years=+1), date(2000, 3, 1)) self.assertEqual(date(1999, 3, 1)+relativedelta(years=+1), date(2000, 3, 1)) self.assertEqual(date(2001, 2, 28)+relativedelta(years=-1), date(2000, 2, 28)) self.assertEqual(date(2001, 3, 1)+relativedelta(years=-1), date(2000, 3, 1)) def testNextFriday(self): self.assertEqual(self.today+relativedelta(weekday=FR), date(2003, 9, 19)) def testNextFridayInt(self): self.assertEqual(self.today+relativedelta(weekday=calendar.FRIDAY), date(2003, 9, 19)) def testLastFridayInThisMonth(self): self.assertEqual(self.today+relativedelta(day=31, weekday=FR(-1)), date(2003, 9, 26)) def testLastDayOfFebruary(self): self.assertEqual(date(2021, 2, 1) + relativedelta(day=31), date(2021, 2, 28)) def testLastDayOfFebruaryLeapYear(self): self.assertEqual(date(2020, 2, 1) + relativedelta(day=31), date(2020, 2, 29)) def testNextWednesdayIsToday(self): self.assertEqual(self.today+relativedelta(weekday=WE), date(2003, 9, 17)) def testNextWednesdayNotToday(self): self.assertEqual(self.today+relativedelta(days=+1, weekday=WE), date(2003, 9, 24)) def testAddMoreThan12Months(self): self.assertEqual(date(2003, 12, 1) + relativedelta(months=+13), date(2005, 1, 1)) def testAddNegativeMonths(self): self.assertEqual(date(2003, 1, 1) + relativedelta(months=-2), date(2002, 11, 1)) def test15thISOYearWeek(self): self.assertEqual(date(2003, 1, 1) + relativedelta(day=4, weeks=+14, weekday=MO(-1)), date(2003, 4, 7)) def testMillenniumAge(self): self.assertEqual(relativedelta(self.now, date(2001, 1, 1)), relativedelta(years=+2, months=+8, days=+16, hours=+20, minutes=+54, seconds=+47, microseconds=+282310)) def testJohnAge(self): self.assertEqual(relativedelta(self.now, datetime(1978, 4, 5, 12, 0)), relativedelta(years=+25, months=+5, days=+12, hours=+8, minutes=+54, seconds=+47, microseconds=+282310)) def testJohnAgeWithDate(self): self.assertEqual(relativedelta(self.today, datetime(1978, 4, 5, 12, 0)), relativedelta(years=+25, months=+5, days=+11, hours=+12)) def testYearDay(self): self.assertEqual(date(2003, 1, 1)+relativedelta(yearday=260), date(2003, 9, 17)) self.assertEqual(date(2002, 1, 1)+relativedelta(yearday=260), date(2002, 9, 17)) self.assertEqual(date(2000, 1, 1)+relativedelta(yearday=260), date(2000, 9, 16)) self.assertEqual(self.today+relativedelta(yearday=261), date(2003, 9, 18)) def testYearDayBug(self): # Tests a problem reported by Adam Ryan. self.assertEqual(date(2010, 1, 1)+relativedelta(yearday=15), date(2010, 1, 15)) def testNonLeapYearDay(self): self.assertEqual(date(2003, 1, 1)+relativedelta(nlyearday=260), date(2003, 9, 17)) self.assertEqual(date(2002, 1, 1)+relativedelta(nlyearday=260), date(2002, 9, 17)) self.assertEqual(date(2000, 1, 1)+relativedelta(nlyearday=260), date(2000, 9, 17)) self.assertEqual(self.today+relativedelta(yearday=261), date(2003, 9, 18)) def testAddition(self): self.assertEqual(relativedelta(days=10) + relativedelta(years=1, months=2, days=3, hours=4, minutes=5, microseconds=6), relativedelta(years=1, months=2, days=13, hours=4, minutes=5, microseconds=6)) def testAbsoluteAddition(self): self.assertEqual(relativedelta() + relativedelta(day=0, hour=0), relativedelta(day=0, hour=0)) self.assertEqual(relativedelta(day=0, hour=0) + relativedelta(), relativedelta(day=0, hour=0)) def testAdditionToDatetime(self): self.assertEqual(datetime(2000, 1, 1) + relativedelta(days=1), datetime(2000, 1, 2)) def testRightAdditionToDatetime(self): self.assertEqual(relativedelta(days=1) + datetime(2000, 1, 1), datetime(2000, 1, 2)) def testAdditionInvalidType(self): with self.assertRaises(TypeError): relativedelta(days=3) + 9 def testAdditionUnsupportedType(self): # For unsupported types that define their own comparators, etc. self.assertIs(relativedelta(days=1) + NotAValue, NotAValue) def testAdditionFloatValue(self): self.assertEqual(datetime(2000, 1, 1) + relativedelta(days=float(1)), datetime(2000, 1, 2)) self.assertEqual(datetime(2000, 1, 1) + relativedelta(months=float(1)), datetime(2000, 2, 1)) self.assertEqual(datetime(2000, 1, 1) + relativedelta(years=float(1)), datetime(2001, 1, 1)) def testAdditionFloatFractionals(self): self.assertEqual(datetime(2000, 1, 1, 0) + relativedelta(days=float(0.5)), datetime(2000, 1, 1, 12)) self.assertEqual(datetime(2000, 1, 1, 0, 0) + relativedelta(hours=float(0.5)), datetime(2000, 1, 1, 0, 30)) self.assertEqual(datetime(2000, 1, 1, 0, 0, 0) + relativedelta(minutes=float(0.5)), datetime(2000, 1, 1, 0, 0, 30)) self.assertEqual(datetime(2000, 1, 1, 0, 0, 0, 0) + relativedelta(seconds=float(0.5)), datetime(2000, 1, 1, 0, 0, 0, 500000)) self.assertEqual(datetime(2000, 1, 1, 0, 0, 0, 0) + relativedelta(microseconds=float(500000.25)), datetime(2000, 1, 1, 0, 0, 0, 500000)) def testSubtraction(self): self.assertEqual(relativedelta(days=10) - relativedelta(years=1, months=2, days=3, hours=4, minutes=5, microseconds=6), relativedelta(years=-1, months=-2, days=7, hours=-4, minutes=-5, microseconds=-6)) def testRightSubtractionFromDatetime(self): self.assertEqual(datetime(2000, 1, 2) - relativedelta(days=1), datetime(2000, 1, 1)) def testSubractionWithDatetime(self): self.assertRaises(TypeError, lambda x, y: x - y, (relativedelta(days=1), datetime(2000, 1, 1))) def testSubtractionInvalidType(self): with self.assertRaises(TypeError): relativedelta(hours=12) - 14 def testSubtractionUnsupportedType(self): self.assertIs(relativedelta(days=1) + NotAValue, NotAValue) def testMultiplication(self): self.assertEqual(datetime(2000, 1, 1) + relativedelta(days=1) * 28, datetime(2000, 1, 29)) self.assertEqual(datetime(2000, 1, 1) + 28 * relativedelta(days=1), datetime(2000, 1, 29)) def testMultiplicationUnsupportedType(self): self.assertIs(relativedelta(days=1) * NotAValue, NotAValue) def testDivision(self): self.assertEqual(datetime(2000, 1, 1) + relativedelta(days=28) / 28, datetime(2000, 1, 2)) def testDivisionUnsupportedType(self): self.assertIs(relativedelta(days=1) / NotAValue, NotAValue) def testBoolean(self): self.assertFalse(relativedelta(days=0)) self.assertTrue(relativedelta(days=1)) def testAbsoluteValueNegative(self): rd_base = relativedelta(years=-1, months=-5, days=-2, hours=-3, minutes=-5, seconds=-2, microseconds=-12) rd_expected = relativedelta(years=1, months=5, days=2, hours=3, minutes=5, seconds=2, microseconds=12) self.assertEqual(abs(rd_base), rd_expected) def testAbsoluteValuePositive(self): rd_base = relativedelta(years=1, months=5, days=2, hours=3, minutes=5, seconds=2, microseconds=12) rd_expected = rd_base self.assertEqual(abs(rd_base), rd_expected) def testComparison(self): d1 = relativedelta(years=1, months=1, days=1, leapdays=0, hours=1, minutes=1, seconds=1, microseconds=1) d2 = relativedelta(years=1, months=1, days=1, leapdays=0, hours=1, minutes=1, seconds=1, microseconds=1) d3 = relativedelta(years=1, months=1, days=1, leapdays=0, hours=1, minutes=1, seconds=1, microseconds=2) self.assertEqual(d1, d2) self.assertNotEqual(d1, d3) def testInequalityTypeMismatch(self): # Different type self.assertFalse(relativedelta(year=1) == 19) def testInequalityUnsupportedType(self): self.assertIs(relativedelta(hours=3) == NotAValue, NotAValue) def testInequalityWeekdays(self): # Different weekdays no_wday = relativedelta(year=1997, month=4) wday_mo_1 = relativedelta(year=1997, month=4, weekday=MO(+1)) wday_mo_2 = relativedelta(year=1997, month=4, weekday=MO(+2)) wday_tu = relativedelta(year=1997, month=4, weekday=TU) self.assertTrue(wday_mo_1 == wday_mo_1) self.assertFalse(no_wday == wday_mo_1) self.assertFalse(wday_mo_1 == no_wday) self.assertFalse(wday_mo_1 == wday_mo_2) self.assertFalse(wday_mo_2 == wday_mo_1) self.assertFalse(wday_mo_1 == wday_tu) self.assertFalse(wday_tu == wday_mo_1) def testMonthOverflow(self): self.assertEqual(relativedelta(months=273), relativedelta(years=22, months=9)) def testWeeks(self): # Test that the weeks property is working properly. rd = relativedelta(years=4, months=2, weeks=8, days=6) self.assertEqual((rd.weeks, rd.days), (8, 8 * 7 + 6)) rd.weeks = 3 self.assertEqual((rd.weeks, rd.days), (3, 3 * 7 + 6)) def testRelativeDeltaRepr(self): self.assertEqual(repr(relativedelta(years=1, months=-1, days=15)), 'relativedelta(years=+1, months=-1, days=+15)') self.assertEqual(repr(relativedelta(months=14, seconds=-25)), 'relativedelta(years=+1, months=+2, seconds=-25)') self.assertEqual(repr(relativedelta(month=3, hour=3, weekday=SU(3))), 'relativedelta(month=3, weekday=SU(+3), hour=3)') def testRelativeDeltaFractionalYear(self): with self.assertRaises(ValueError): relativedelta(years=1.5) def testRelativeDeltaFractionalMonth(self): with self.assertRaises(ValueError): relativedelta(months=1.5) def testRelativeDeltaInvalidDatetimeObject(self): with self.assertRaises(TypeError): relativedelta(dt1='2018-01-01', dt2='2018-01-02') with self.assertRaises(TypeError): relativedelta(dt1=datetime(2018, 1, 1), dt2='2018-01-02') with self.assertRaises(TypeError): relativedelta(dt1='2018-01-01', dt2=datetime(2018, 1, 2)) def testRelativeDeltaFractionalAbsolutes(self): # Fractional absolute values will soon be unsupported, # check for the deprecation warning. with pytest.warns(DeprecationWarning): relativedelta(year=2.86) with pytest.warns(DeprecationWarning): relativedelta(month=1.29) with pytest.warns(DeprecationWarning): relativedelta(day=0.44) with pytest.warns(DeprecationWarning): relativedelta(hour=23.98) with pytest.warns(DeprecationWarning): relativedelta(minute=45.21) with pytest.warns(DeprecationWarning): relativedelta(second=13.2) with pytest.warns(DeprecationWarning): relativedelta(microsecond=157221.93) def testRelativeDeltaFractionalRepr(self): rd = relativedelta(years=3, months=-2, days=1.25) self.assertEqual(repr(rd), 'relativedelta(years=+3, months=-2, days=+1.25)') rd = relativedelta(hours=0.5, seconds=9.22) self.assertEqual(repr(rd), 'relativedelta(hours=+0.5, seconds=+9.22)') def testRelativeDeltaFractionalWeeks(self): # Equivalent to days=8, hours=18 rd = relativedelta(weeks=1.25) d1 = datetime(2009, 9, 3, 0, 0) self.assertEqual(d1 + rd, datetime(2009, 9, 11, 18)) def testRelativeDeltaFractionalDays(self): rd1 = relativedelta(days=1.48) d1 = datetime(2009, 9, 3, 0, 0) self.assertEqual(d1 + rd1, datetime(2009, 9, 4, 11, 31, 12)) rd2 = relativedelta(days=1.5) self.assertEqual(d1 + rd2, datetime(2009, 9, 4, 12, 0, 0)) def testRelativeDeltaFractionalHours(self): rd = relativedelta(days=1, hours=12.5) d1 = datetime(2009, 9, 3, 0, 0) self.assertEqual(d1 + rd, datetime(2009, 9, 4, 12, 30, 0)) def testRelativeDeltaFractionalMinutes(self): rd = relativedelta(hours=1, minutes=30.5) d1 = datetime(2009, 9, 3, 0, 0) self.assertEqual(d1 + rd, datetime(2009, 9, 3, 1, 30, 30)) def testRelativeDeltaFractionalSeconds(self): rd = relativedelta(hours=5, minutes=30, seconds=30.5) d1 = datetime(2009, 9, 3, 0, 0) self.assertEqual(d1 + rd, datetime(2009, 9, 3, 5, 30, 30, 500000)) def testRelativeDeltaFractionalPositiveOverflow(self): # Equivalent to (days=1, hours=14) rd1 = relativedelta(days=1.5, hours=2) d1 = datetime(2009, 9, 3, 0, 0) self.assertEqual(d1 + rd1, datetime(2009, 9, 4, 14, 0, 0)) # Equivalent to (days=1, hours=14, minutes=45) rd2 = relativedelta(days=1.5, hours=2.5, minutes=15) d1 = datetime(2009, 9, 3, 0, 0) self.assertEqual(d1 + rd2, datetime(2009, 9, 4, 14, 45)) # Carry back up - equivalent to (days=2, hours=2, minutes=0, seconds=1) rd3 = relativedelta(days=1.5, hours=13, minutes=59.5, seconds=31) self.assertEqual(d1 + rd3, datetime(2009, 9, 5, 2, 0, 1)) def testRelativeDeltaFractionalNegativeDays(self): # Equivalent to (days=-1, hours=-1) rd1 = relativedelta(days=-1.5, hours=11) d1 = datetime(2009, 9, 3, 12, 0) self.assertEqual(d1 + rd1, datetime(2009, 9, 2, 11, 0, 0)) # Equivalent to (days=-1, hours=-9) rd2 = relativedelta(days=-1.25, hours=-3) self.assertEqual(d1 + rd2, datetime(2009, 9, 2, 3)) def testRelativeDeltaNormalizeFractionalDays(self): # Equivalent to (days=2, hours=18) rd1 = relativedelta(days=2.75) self.assertEqual(rd1.normalized(), relativedelta(days=2, hours=18)) # Equivalent to (days=1, hours=11, minutes=31, seconds=12) rd2 = relativedelta(days=1.48) self.assertEqual(rd2.normalized(), relativedelta(days=1, hours=11, minutes=31, seconds=12)) def testRelativeDeltaNormalizeFractionalDays2(self): # Equivalent to (hours=1, minutes=30) rd1 = relativedelta(hours=1.5) self.assertEqual(rd1.normalized(), relativedelta(hours=1, minutes=30)) # Equivalent to (hours=3, minutes=17, seconds=5, microseconds=100) rd2 = relativedelta(hours=3.28472225) self.assertEqual(rd2.normalized(), relativedelta(hours=3, minutes=17, seconds=5, microseconds=100)) def testRelativeDeltaNormalizeFractionalMinutes(self): # Equivalent to (minutes=15, seconds=36) rd1 = relativedelta(minutes=15.6) self.assertEqual(rd1.normalized(), relativedelta(minutes=15, seconds=36)) # Equivalent to (minutes=25, seconds=20, microseconds=25000) rd2 = relativedelta(minutes=25.33375) self.assertEqual(rd2.normalized(), relativedelta(minutes=25, seconds=20, microseconds=25000)) def testRelativeDeltaNormalizeFractionalSeconds(self): # Equivalent to (seconds=45, microseconds=25000) rd1 = relativedelta(seconds=45.025) self.assertEqual(rd1.normalized(), relativedelta(seconds=45, microseconds=25000)) def testRelativeDeltaFractionalPositiveOverflow2(self): # Equivalent to (days=1, hours=14) rd1 = relativedelta(days=1.5, hours=2) self.assertEqual(rd1.normalized(), relativedelta(days=1, hours=14)) # Equivalent to (days=1, hours=14, minutes=45) rd2 = relativedelta(days=1.5, hours=2.5, minutes=15) self.assertEqual(rd2.normalized(), relativedelta(days=1, hours=14, minutes=45)) # Carry back up - equivalent to: # (days=2, hours=2, minutes=0, seconds=2, microseconds=3) rd3 = relativedelta(days=1.5, hours=13, minutes=59.50045, seconds=31.473, microseconds=500003) self.assertEqual(rd3.normalized(), relativedelta(days=2, hours=2, minutes=0, seconds=2, microseconds=3)) def testRelativeDeltaFractionalNegativeOverflow(self): # Equivalent to (days=-1) rd1 = relativedelta(days=-0.5, hours=-12) self.assertEqual(rd1.normalized(), relativedelta(days=-1)) # Equivalent to (days=-1) rd2 = relativedelta(days=-1.5, hours=12) self.assertEqual(rd2.normalized(), relativedelta(days=-1)) # Equivalent to (days=-1, hours=-14, minutes=-45) rd3 = relativedelta(days=-1.5, hours=-2.5, minutes=-15) self.assertEqual(rd3.normalized(), relativedelta(days=-1, hours=-14, minutes=-45)) # Equivalent to (days=-1, hours=-14, minutes=+15) rd4 = relativedelta(days=-1.5, hours=-2.5, minutes=45) self.assertEqual(rd4.normalized(), relativedelta(days=-1, hours=-14, minutes=+15)) # Carry back up - equivalent to: # (days=-2, hours=-2, minutes=0, seconds=-2, microseconds=-3) rd3 = relativedelta(days=-1.5, hours=-13, minutes=-59.50045, seconds=-31.473, microseconds=-500003) self.assertEqual(rd3.normalized(), relativedelta(days=-2, hours=-2, minutes=0, seconds=-2, microseconds=-3)) def testInvalidYearDay(self): with self.assertRaises(ValueError): relativedelta(yearday=367) def testAddTimedeltaToUnpopulatedRelativedelta(self): td = timedelta( days=1, seconds=1, microseconds=1, milliseconds=1, minutes=1, hours=1, weeks=1 ) expected = relativedelta( weeks=1, days=1, hours=1, minutes=1, seconds=1, microseconds=1001 ) self.assertEqual(expected, relativedelta() + td) def testAddTimedeltaToPopulatedRelativeDelta(self): td = timedelta( days=1, seconds=1, microseconds=1, milliseconds=1, minutes=1, hours=1, weeks=1 ) rd = relativedelta( year=1, month=1, day=1, hour=1, minute=1, second=1, microsecond=1, years=1, months=1, days=1, weeks=1, hours=1, minutes=1, seconds=1, microseconds=1 ) expected = relativedelta( year=1, month=1, day=1, hour=1, minute=1, second=1, microsecond=1, years=1, months=1, weeks=2, days=2, hours=2, minutes=2, seconds=2, microseconds=1002, ) self.assertEqual(expected, rd + td) def testHashable(self): try: {relativedelta(minute=1): 'test'} except: self.fail("relativedelta() failed to hash!") class RelativeDeltaWeeksPropertyGetterTest(unittest.TestCase): """Test the weeks property getter""" def test_one_day(self): rd = relativedelta(days=1) self.assertEqual(rd.days, 1) self.assertEqual(rd.weeks, 0) def test_minus_one_day(self): rd = relativedelta(days=-1) self.assertEqual(rd.days, -1) self.assertEqual(rd.weeks, 0) def test_height_days(self): rd = relativedelta(days=8) self.assertEqual(rd.days, 8) self.assertEqual(rd.weeks, 1) def test_minus_height_days(self): rd = relativedelta(days=-8) self.assertEqual(rd.days, -8) self.assertEqual(rd.weeks, -1) class RelativeDeltaWeeksPropertySetterTest(unittest.TestCase): """Test the weeks setter which makes a "smart" update of the days attribute""" def test_one_day_set_one_week(self): rd = relativedelta(days=1) rd.weeks = 1 # add 7 days self.assertEqual(rd.days, 8) self.assertEqual(rd.weeks, 1) def test_minus_one_day_set_one_week(self): rd = relativedelta(days=-1) rd.weeks = 1 # add 7 days self.assertEqual(rd.days, 6) self.assertEqual(rd.weeks, 0) def test_height_days_set_minus_one_week(self): rd = relativedelta(days=8) rd.weeks = -1 # change from 1 week, 1 day to -1 week, 1 day self.assertEqual(rd.days, -6) self.assertEqual(rd.weeks, 0) def test_minus_height_days_set_minus_one_week(self): rd = relativedelta(days=-8) rd.weeks = -1 # does not change anything self.assertEqual(rd.days, -8) self.assertEqual(rd.weeks, -1) # vim:ts=4:sw=4:et ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/test_rrule.py0000644000175100001710000064651400000000000021571 0ustar00runnerdocker# -*- coding: utf-8 -*- from __future__ import unicode_literals from datetime import datetime, date import unittest from six import PY2 from dateutil import tz from dateutil.rrule import ( rrule, rruleset, rrulestr, YEARLY, MONTHLY, WEEKLY, DAILY, HOURLY, MINUTELY, SECONDLY, MO, TU, WE, TH, FR, SA, SU ) from freezegun import freeze_time import pytest @pytest.mark.rrule class RRuleTest(unittest.TestCase): def _rrulestr_reverse_test(self, rule): """ Call with an `rrule` and it will test that `str(rrule)` generates a string which generates the same `rrule` as the input when passed to `rrulestr()` """ rr_str = str(rule) rrulestr_rrule = rrulestr(rr_str) self.assertEqual(list(rule), list(rrulestr_rrule)) def testStrAppendRRULEToken(self): # `_rrulestr_reverse_test` does not check if the "RRULE:" prefix # property is appended properly, so give it a dedicated test self.assertEqual(str(rrule(YEARLY, count=5, dtstart=datetime(1997, 9, 2, 9, 0))), "DTSTART:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=5") rr_str = ( 'DTSTART:19970105T083000\nRRULE:FREQ=YEARLY;INTERVAL=2' ) self.assertEqual(str(rrulestr(rr_str)), rr_str) def testYearly(self): self.assertEqual(list(rrule(YEARLY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1998, 9, 2, 9, 0), datetime(1999, 9, 2, 9, 0)]) def testYearlyInterval(self): self.assertEqual(list(rrule(YEARLY, count=3, interval=2, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1999, 9, 2, 9, 0), datetime(2001, 9, 2, 9, 0)]) def testYearlyIntervalLarge(self): self.assertEqual(list(rrule(YEARLY, count=3, interval=100, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(2097, 9, 2, 9, 0), datetime(2197, 9, 2, 9, 0)]) def testYearlyByMonth(self): self.assertEqual(list(rrule(YEARLY, count=3, bymonth=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 2, 9, 0), datetime(1998, 3, 2, 9, 0), datetime(1999, 1, 2, 9, 0)]) def testYearlyByMonthDay(self): self.assertEqual(list(rrule(YEARLY, count=3, bymonthday=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 3, 9, 0), datetime(1997, 10, 1, 9, 0), datetime(1997, 10, 3, 9, 0)]) def testYearlyByMonthAndMonthDay(self): self.assertEqual(list(rrule(YEARLY, count=3, bymonth=(1, 3), bymonthday=(5, 7), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 5, 9, 0), datetime(1998, 1, 7, 9, 0), datetime(1998, 3, 5, 9, 0)]) def testYearlyByWeekDay(self): self.assertEqual(list(rrule(YEARLY, count=3, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 9, 9, 0)]) def testYearlyByNWeekDay(self): self.assertEqual(list(rrule(YEARLY, count=3, byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 25, 9, 0), datetime(1998, 1, 6, 9, 0), datetime(1998, 12, 31, 9, 0)]) def testYearlyByNWeekDayLarge(self): self.assertEqual(list(rrule(YEARLY, count=3, byweekday=(TU(3), TH(-3)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 11, 9, 0), datetime(1998, 1, 20, 9, 0), datetime(1998, 12, 17, 9, 0)]) def testYearlyByMonthAndWeekDay(self): self.assertEqual(list(rrule(YEARLY, count=3, bymonth=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 1, 6, 9, 0), datetime(1998, 1, 8, 9, 0)]) def testYearlyByMonthAndNWeekDay(self): self.assertEqual(list(rrule(YEARLY, count=3, bymonth=(1, 3), byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 6, 9, 0), datetime(1998, 1, 29, 9, 0), datetime(1998, 3, 3, 9, 0)]) def testYearlyByMonthAndNWeekDayLarge(self): # This is interesting because the TH(-3) ends up before # the TU(3). self.assertEqual(list(rrule(YEARLY, count=3, bymonth=(1, 3), byweekday=(TU(3), TH(-3)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 15, 9, 0), datetime(1998, 1, 20, 9, 0), datetime(1998, 3, 12, 9, 0)]) def testYearlyByMonthDayAndWeekDay(self): self.assertEqual(list(rrule(YEARLY, count=3, bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 2, 3, 9, 0), datetime(1998, 3, 3, 9, 0)]) def testYearlyByMonthAndMonthDayAndWeekDay(self): self.assertEqual(list(rrule(YEARLY, count=3, bymonth=(1, 3), bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 3, 3, 9, 0), datetime(2001, 3, 1, 9, 0)]) def testYearlyByYearDay(self): self.assertEqual(list(rrule(YEARLY, count=4, byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 31, 9, 0), datetime(1998, 1, 1, 9, 0), datetime(1998, 4, 10, 9, 0), datetime(1998, 7, 19, 9, 0)]) def testYearlyByYearDayNeg(self): self.assertEqual(list(rrule(YEARLY, count=4, byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 31, 9, 0), datetime(1998, 1, 1, 9, 0), datetime(1998, 4, 10, 9, 0), datetime(1998, 7, 19, 9, 0)]) def testYearlyByMonthAndYearDay(self): self.assertEqual(list(rrule(YEARLY, count=4, bymonth=(4, 7), byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 10, 9, 0), datetime(1998, 7, 19, 9, 0), datetime(1999, 4, 10, 9, 0), datetime(1999, 7, 19, 9, 0)]) def testYearlyByMonthAndYearDayNeg(self): self.assertEqual(list(rrule(YEARLY, count=4, bymonth=(4, 7), byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 10, 9, 0), datetime(1998, 7, 19, 9, 0), datetime(1999, 4, 10, 9, 0), datetime(1999, 7, 19, 9, 0)]) def testYearlyByWeekNo(self): self.assertEqual(list(rrule(YEARLY, count=3, byweekno=20, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 5, 11, 9, 0), datetime(1998, 5, 12, 9, 0), datetime(1998, 5, 13, 9, 0)]) def testYearlyByWeekNoAndWeekDay(self): # That's a nice one. The first days of week number one # may be in the last year. self.assertEqual(list(rrule(YEARLY, count=3, byweekno=1, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 29, 9, 0), datetime(1999, 1, 4, 9, 0), datetime(2000, 1, 3, 9, 0)]) def testYearlyByWeekNoAndWeekDayLarge(self): # Another nice test. The last days of week number 52/53 # may be in the next year. self.assertEqual(list(rrule(YEARLY, count=3, byweekno=52, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 28, 9, 0), datetime(1998, 12, 27, 9, 0), datetime(2000, 1, 2, 9, 0)]) def testYearlyByWeekNoAndWeekDayLast(self): self.assertEqual(list(rrule(YEARLY, count=3, byweekno=-1, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 28, 9, 0), datetime(1999, 1, 3, 9, 0), datetime(2000, 1, 2, 9, 0)]) def testYearlyByEaster(self): self.assertEqual(list(rrule(YEARLY, count=3, byeaster=0, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 12, 9, 0), datetime(1999, 4, 4, 9, 0), datetime(2000, 4, 23, 9, 0)]) def testYearlyByEasterPos(self): self.assertEqual(list(rrule(YEARLY, count=3, byeaster=1, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 13, 9, 0), datetime(1999, 4, 5, 9, 0), datetime(2000, 4, 24, 9, 0)]) def testYearlyByEasterNeg(self): self.assertEqual(list(rrule(YEARLY, count=3, byeaster=-1, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 11, 9, 0), datetime(1999, 4, 3, 9, 0), datetime(2000, 4, 22, 9, 0)]) def testYearlyByWeekNoAndWeekDay53(self): self.assertEqual(list(rrule(YEARLY, count=3, byweekno=53, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 12, 28, 9, 0), datetime(2004, 12, 27, 9, 0), datetime(2009, 12, 28, 9, 0)]) def testYearlyByHour(self): self.assertEqual(list(rrule(YEARLY, count=3, byhour=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0), datetime(1998, 9, 2, 6, 0), datetime(1998, 9, 2, 18, 0)]) def testYearlyByMinute(self): self.assertEqual(list(rrule(YEARLY, count=3, byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 6), datetime(1997, 9, 2, 9, 18), datetime(1998, 9, 2, 9, 6)]) def testYearlyBySecond(self): self.assertEqual(list(rrule(YEARLY, count=3, bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0, 6), datetime(1997, 9, 2, 9, 0, 18), datetime(1998, 9, 2, 9, 0, 6)]) def testYearlyByHourAndMinute(self): self.assertEqual(list(rrule(YEARLY, count=3, byhour=(6, 18), byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 6), datetime(1997, 9, 2, 18, 18), datetime(1998, 9, 2, 6, 6)]) def testYearlyByHourAndSecond(self): self.assertEqual(list(rrule(YEARLY, count=3, byhour=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0, 6), datetime(1997, 9, 2, 18, 0, 18), datetime(1998, 9, 2, 6, 0, 6)]) def testYearlyByMinuteAndSecond(self): self.assertEqual(list(rrule(YEARLY, count=3, byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 6, 6), datetime(1997, 9, 2, 9, 6, 18), datetime(1997, 9, 2, 9, 18, 6)]) def testYearlyByHourAndMinuteAndSecond(self): self.assertEqual(list(rrule(YEARLY, count=3, byhour=(6, 18), byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 6, 6), datetime(1997, 9, 2, 18, 6, 18), datetime(1997, 9, 2, 18, 18, 6)]) def testYearlyBySetPos(self): self.assertEqual(list(rrule(YEARLY, count=3, bymonthday=15, byhour=(6, 18), bysetpos=(3, -3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 11, 15, 18, 0), datetime(1998, 2, 15, 6, 0), datetime(1998, 11, 15, 18, 0)]) def testMonthly(self): self.assertEqual(list(rrule(MONTHLY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 10, 2, 9, 0), datetime(1997, 11, 2, 9, 0)]) def testMonthlyInterval(self): self.assertEqual(list(rrule(MONTHLY, count=3, interval=2, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 11, 2, 9, 0), datetime(1998, 1, 2, 9, 0)]) def testMonthlyIntervalLarge(self): self.assertEqual(list(rrule(MONTHLY, count=3, interval=18, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1999, 3, 2, 9, 0), datetime(2000, 9, 2, 9, 0)]) def testMonthlyByMonth(self): self.assertEqual(list(rrule(MONTHLY, count=3, bymonth=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 2, 9, 0), datetime(1998, 3, 2, 9, 0), datetime(1999, 1, 2, 9, 0)]) def testMonthlyByMonthDay(self): self.assertEqual(list(rrule(MONTHLY, count=3, bymonthday=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 3, 9, 0), datetime(1997, 10, 1, 9, 0), datetime(1997, 10, 3, 9, 0)]) def testMonthlyByMonthAndMonthDay(self): self.assertEqual(list(rrule(MONTHLY, count=3, bymonth=(1, 3), bymonthday=(5, 7), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 5, 9, 0), datetime(1998, 1, 7, 9, 0), datetime(1998, 3, 5, 9, 0)]) def testMonthlyByWeekDay(self): self.assertEqual(list(rrule(MONTHLY, count=3, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 9, 9, 0)]) # Third Monday of the month self.assertEqual(rrule(MONTHLY, byweekday=(MO(+3)), dtstart=datetime(1997, 9, 1)).between(datetime(1997, 9, 1), datetime(1997, 12, 1)), [datetime(1997, 9, 15, 0, 0), datetime(1997, 10, 20, 0, 0), datetime(1997, 11, 17, 0, 0)]) def testMonthlyByNWeekDay(self): self.assertEqual(list(rrule(MONTHLY, count=3, byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 25, 9, 0), datetime(1997, 10, 7, 9, 0)]) def testMonthlyByNWeekDayLarge(self): self.assertEqual(list(rrule(MONTHLY, count=3, byweekday=(TU(3), TH(-3)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 11, 9, 0), datetime(1997, 9, 16, 9, 0), datetime(1997, 10, 16, 9, 0)]) def testMonthlyByMonthAndWeekDay(self): self.assertEqual(list(rrule(MONTHLY, count=3, bymonth=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 1, 6, 9, 0), datetime(1998, 1, 8, 9, 0)]) def testMonthlyByMonthAndNWeekDay(self): self.assertEqual(list(rrule(MONTHLY, count=3, bymonth=(1, 3), byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 6, 9, 0), datetime(1998, 1, 29, 9, 0), datetime(1998, 3, 3, 9, 0)]) def testMonthlyByMonthAndNWeekDayLarge(self): self.assertEqual(list(rrule(MONTHLY, count=3, bymonth=(1, 3), byweekday=(TU(3), TH(-3)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 15, 9, 0), datetime(1998, 1, 20, 9, 0), datetime(1998, 3, 12, 9, 0)]) def testMonthlyByMonthDayAndWeekDay(self): self.assertEqual(list(rrule(MONTHLY, count=3, bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 2, 3, 9, 0), datetime(1998, 3, 3, 9, 0)]) def testMonthlyByMonthAndMonthDayAndWeekDay(self): self.assertEqual(list(rrule(MONTHLY, count=3, bymonth=(1, 3), bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 3, 3, 9, 0), datetime(2001, 3, 1, 9, 0)]) def testMonthlyByYearDay(self): self.assertEqual(list(rrule(MONTHLY, count=4, byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 31, 9, 0), datetime(1998, 1, 1, 9, 0), datetime(1998, 4, 10, 9, 0), datetime(1998, 7, 19, 9, 0)]) def testMonthlyByYearDayNeg(self): self.assertEqual(list(rrule(MONTHLY, count=4, byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 31, 9, 0), datetime(1998, 1, 1, 9, 0), datetime(1998, 4, 10, 9, 0), datetime(1998, 7, 19, 9, 0)]) def testMonthlyByMonthAndYearDay(self): self.assertEqual(list(rrule(MONTHLY, count=4, bymonth=(4, 7), byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 10, 9, 0), datetime(1998, 7, 19, 9, 0), datetime(1999, 4, 10, 9, 0), datetime(1999, 7, 19, 9, 0)]) def testMonthlyByMonthAndYearDayNeg(self): self.assertEqual(list(rrule(MONTHLY, count=4, bymonth=(4, 7), byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 10, 9, 0), datetime(1998, 7, 19, 9, 0), datetime(1999, 4, 10, 9, 0), datetime(1999, 7, 19, 9, 0)]) def testMonthlyByWeekNo(self): self.assertEqual(list(rrule(MONTHLY, count=3, byweekno=20, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 5, 11, 9, 0), datetime(1998, 5, 12, 9, 0), datetime(1998, 5, 13, 9, 0)]) def testMonthlyByWeekNoAndWeekDay(self): # That's a nice one. The first days of week number one # may be in the last year. self.assertEqual(list(rrule(MONTHLY, count=3, byweekno=1, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 29, 9, 0), datetime(1999, 1, 4, 9, 0), datetime(2000, 1, 3, 9, 0)]) def testMonthlyByWeekNoAndWeekDayLarge(self): # Another nice test. The last days of week number 52/53 # may be in the next year. self.assertEqual(list(rrule(MONTHLY, count=3, byweekno=52, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 28, 9, 0), datetime(1998, 12, 27, 9, 0), datetime(2000, 1, 2, 9, 0)]) def testMonthlyByWeekNoAndWeekDayLast(self): self.assertEqual(list(rrule(MONTHLY, count=3, byweekno=-1, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 28, 9, 0), datetime(1999, 1, 3, 9, 0), datetime(2000, 1, 2, 9, 0)]) def testMonthlyByWeekNoAndWeekDay53(self): self.assertEqual(list(rrule(MONTHLY, count=3, byweekno=53, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 12, 28, 9, 0), datetime(2004, 12, 27, 9, 0), datetime(2009, 12, 28, 9, 0)]) def testMonthlyByEaster(self): self.assertEqual(list(rrule(MONTHLY, count=3, byeaster=0, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 12, 9, 0), datetime(1999, 4, 4, 9, 0), datetime(2000, 4, 23, 9, 0)]) def testMonthlyByEasterPos(self): self.assertEqual(list(rrule(MONTHLY, count=3, byeaster=1, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 13, 9, 0), datetime(1999, 4, 5, 9, 0), datetime(2000, 4, 24, 9, 0)]) def testMonthlyByEasterNeg(self): self.assertEqual(list(rrule(MONTHLY, count=3, byeaster=-1, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 11, 9, 0), datetime(1999, 4, 3, 9, 0), datetime(2000, 4, 22, 9, 0)]) def testMonthlyByHour(self): self.assertEqual(list(rrule(MONTHLY, count=3, byhour=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0), datetime(1997, 10, 2, 6, 0), datetime(1997, 10, 2, 18, 0)]) def testMonthlyByMinute(self): self.assertEqual(list(rrule(MONTHLY, count=3, byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 6), datetime(1997, 9, 2, 9, 18), datetime(1997, 10, 2, 9, 6)]) def testMonthlyBySecond(self): self.assertEqual(list(rrule(MONTHLY, count=3, bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0, 6), datetime(1997, 9, 2, 9, 0, 18), datetime(1997, 10, 2, 9, 0, 6)]) def testMonthlyByHourAndMinute(self): self.assertEqual(list(rrule(MONTHLY, count=3, byhour=(6, 18), byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 6), datetime(1997, 9, 2, 18, 18), datetime(1997, 10, 2, 6, 6)]) def testMonthlyByHourAndSecond(self): self.assertEqual(list(rrule(MONTHLY, count=3, byhour=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0, 6), datetime(1997, 9, 2, 18, 0, 18), datetime(1997, 10, 2, 6, 0, 6)]) def testMonthlyByMinuteAndSecond(self): self.assertEqual(list(rrule(MONTHLY, count=3, byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 6, 6), datetime(1997, 9, 2, 9, 6, 18), datetime(1997, 9, 2, 9, 18, 6)]) def testMonthlyByHourAndMinuteAndSecond(self): self.assertEqual(list(rrule(MONTHLY, count=3, byhour=(6, 18), byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 6, 6), datetime(1997, 9, 2, 18, 6, 18), datetime(1997, 9, 2, 18, 18, 6)]) def testMonthlyBySetPos(self): self.assertEqual(list(rrule(MONTHLY, count=3, bymonthday=(13, 17), byhour=(6, 18), bysetpos=(3, -3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 13, 18, 0), datetime(1997, 9, 17, 6, 0), datetime(1997, 10, 13, 18, 0)]) def testWeekly(self): self.assertEqual(list(rrule(WEEKLY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 16, 9, 0)]) def testWeeklyInterval(self): self.assertEqual(list(rrule(WEEKLY, count=3, interval=2, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 16, 9, 0), datetime(1997, 9, 30, 9, 0)]) def testWeeklyIntervalLarge(self): self.assertEqual(list(rrule(WEEKLY, count=3, interval=20, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1998, 1, 20, 9, 0), datetime(1998, 6, 9, 9, 0)]) def testWeeklyByMonth(self): self.assertEqual(list(rrule(WEEKLY, count=3, bymonth=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 6, 9, 0), datetime(1998, 1, 13, 9, 0), datetime(1998, 1, 20, 9, 0)]) def testWeeklyByMonthDay(self): self.assertEqual(list(rrule(WEEKLY, count=3, bymonthday=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 3, 9, 0), datetime(1997, 10, 1, 9, 0), datetime(1997, 10, 3, 9, 0)]) def testWeeklyByMonthAndMonthDay(self): self.assertEqual(list(rrule(WEEKLY, count=3, bymonth=(1, 3), bymonthday=(5, 7), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 5, 9, 0), datetime(1998, 1, 7, 9, 0), datetime(1998, 3, 5, 9, 0)]) def testWeeklyByWeekDay(self): self.assertEqual(list(rrule(WEEKLY, count=3, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 9, 9, 0)]) def testWeeklyByNWeekDay(self): self.assertEqual(list(rrule(WEEKLY, count=3, byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 9, 9, 0)]) def testWeeklyByMonthAndWeekDay(self): # This test is interesting, because it crosses the year # boundary in a weekly period to find day '1' as a # valid recurrence. self.assertEqual(list(rrule(WEEKLY, count=3, bymonth=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 1, 6, 9, 0), datetime(1998, 1, 8, 9, 0)]) def testWeeklyByMonthAndNWeekDay(self): self.assertEqual(list(rrule(WEEKLY, count=3, bymonth=(1, 3), byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 1, 6, 9, 0), datetime(1998, 1, 8, 9, 0)]) def testWeeklyByMonthDayAndWeekDay(self): self.assertEqual(list(rrule(WEEKLY, count=3, bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 2, 3, 9, 0), datetime(1998, 3, 3, 9, 0)]) def testWeeklyByMonthAndMonthDayAndWeekDay(self): self.assertEqual(list(rrule(WEEKLY, count=3, bymonth=(1, 3), bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 3, 3, 9, 0), datetime(2001, 3, 1, 9, 0)]) def testWeeklyByYearDay(self): self.assertEqual(list(rrule(WEEKLY, count=4, byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 31, 9, 0), datetime(1998, 1, 1, 9, 0), datetime(1998, 4, 10, 9, 0), datetime(1998, 7, 19, 9, 0)]) def testWeeklyByYearDayNeg(self): self.assertEqual(list(rrule(WEEKLY, count=4, byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 31, 9, 0), datetime(1998, 1, 1, 9, 0), datetime(1998, 4, 10, 9, 0), datetime(1998, 7, 19, 9, 0)]) def testWeeklyByMonthAndYearDay(self): self.assertEqual(list(rrule(WEEKLY, count=4, bymonth=(1, 7), byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 7, 19, 9, 0), datetime(1999, 1, 1, 9, 0), datetime(1999, 7, 19, 9, 0)]) def testWeeklyByMonthAndYearDayNeg(self): self.assertEqual(list(rrule(WEEKLY, count=4, bymonth=(1, 7), byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 7, 19, 9, 0), datetime(1999, 1, 1, 9, 0), datetime(1999, 7, 19, 9, 0)]) def testWeeklyByWeekNo(self): self.assertEqual(list(rrule(WEEKLY, count=3, byweekno=20, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 5, 11, 9, 0), datetime(1998, 5, 12, 9, 0), datetime(1998, 5, 13, 9, 0)]) def testWeeklyByWeekNoAndWeekDay(self): # That's a nice one. The first days of week number one # may be in the last year. self.assertEqual(list(rrule(WEEKLY, count=3, byweekno=1, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 29, 9, 0), datetime(1999, 1, 4, 9, 0), datetime(2000, 1, 3, 9, 0)]) def testWeeklyByWeekNoAndWeekDayLarge(self): # Another nice test. The last days of week number 52/53 # may be in the next year. self.assertEqual(list(rrule(WEEKLY, count=3, byweekno=52, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 28, 9, 0), datetime(1998, 12, 27, 9, 0), datetime(2000, 1, 2, 9, 0)]) def testWeeklyByWeekNoAndWeekDayLast(self): self.assertEqual(list(rrule(WEEKLY, count=3, byweekno=-1, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 28, 9, 0), datetime(1999, 1, 3, 9, 0), datetime(2000, 1, 2, 9, 0)]) def testWeeklyByWeekNoAndWeekDay53(self): self.assertEqual(list(rrule(WEEKLY, count=3, byweekno=53, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 12, 28, 9, 0), datetime(2004, 12, 27, 9, 0), datetime(2009, 12, 28, 9, 0)]) def testWeeklyByEaster(self): self.assertEqual(list(rrule(WEEKLY, count=3, byeaster=0, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 12, 9, 0), datetime(1999, 4, 4, 9, 0), datetime(2000, 4, 23, 9, 0)]) def testWeeklyByEasterPos(self): self.assertEqual(list(rrule(WEEKLY, count=3, byeaster=1, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 13, 9, 0), datetime(1999, 4, 5, 9, 0), datetime(2000, 4, 24, 9, 0)]) def testWeeklyByEasterNeg(self): self.assertEqual(list(rrule(WEEKLY, count=3, byeaster=-1, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 11, 9, 0), datetime(1999, 4, 3, 9, 0), datetime(2000, 4, 22, 9, 0)]) def testWeeklyByHour(self): self.assertEqual(list(rrule(WEEKLY, count=3, byhour=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0), datetime(1997, 9, 9, 6, 0), datetime(1997, 9, 9, 18, 0)]) def testWeeklyByMinute(self): self.assertEqual(list(rrule(WEEKLY, count=3, byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 6), datetime(1997, 9, 2, 9, 18), datetime(1997, 9, 9, 9, 6)]) def testWeeklyBySecond(self): self.assertEqual(list(rrule(WEEKLY, count=3, bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0, 6), datetime(1997, 9, 2, 9, 0, 18), datetime(1997, 9, 9, 9, 0, 6)]) def testWeeklyByHourAndMinute(self): self.assertEqual(list(rrule(WEEKLY, count=3, byhour=(6, 18), byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 6), datetime(1997, 9, 2, 18, 18), datetime(1997, 9, 9, 6, 6)]) def testWeeklyByHourAndSecond(self): self.assertEqual(list(rrule(WEEKLY, count=3, byhour=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0, 6), datetime(1997, 9, 2, 18, 0, 18), datetime(1997, 9, 9, 6, 0, 6)]) def testWeeklyByMinuteAndSecond(self): self.assertEqual(list(rrule(WEEKLY, count=3, byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 6, 6), datetime(1997, 9, 2, 9, 6, 18), datetime(1997, 9, 2, 9, 18, 6)]) def testWeeklyByHourAndMinuteAndSecond(self): self.assertEqual(list(rrule(WEEKLY, count=3, byhour=(6, 18), byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 6, 6), datetime(1997, 9, 2, 18, 6, 18), datetime(1997, 9, 2, 18, 18, 6)]) def testWeeklyBySetPos(self): self.assertEqual(list(rrule(WEEKLY, count=3, byweekday=(TU, TH), byhour=(6, 18), bysetpos=(3, -3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0), datetime(1997, 9, 4, 6, 0), datetime(1997, 9, 9, 18, 0)]) def testDaily(self): self.assertEqual(list(rrule(DAILY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 3, 9, 0), datetime(1997, 9, 4, 9, 0)]) def testDailyInterval(self): self.assertEqual(list(rrule(DAILY, count=3, interval=2, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 6, 9, 0)]) def testDailyIntervalLarge(self): self.assertEqual(list(rrule(DAILY, count=3, interval=92, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 12, 3, 9, 0), datetime(1998, 3, 5, 9, 0)]) def testDailyByMonth(self): self.assertEqual(list(rrule(DAILY, count=3, bymonth=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 1, 2, 9, 0), datetime(1998, 1, 3, 9, 0)]) def testDailyByMonthDay(self): self.assertEqual(list(rrule(DAILY, count=3, bymonthday=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 3, 9, 0), datetime(1997, 10, 1, 9, 0), datetime(1997, 10, 3, 9, 0)]) def testDailyByMonthAndMonthDay(self): self.assertEqual(list(rrule(DAILY, count=3, bymonth=(1, 3), bymonthday=(5, 7), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 5, 9, 0), datetime(1998, 1, 7, 9, 0), datetime(1998, 3, 5, 9, 0)]) def testDailyByWeekDay(self): self.assertEqual(list(rrule(DAILY, count=3, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 9, 9, 0)]) def testDailyByNWeekDay(self): self.assertEqual(list(rrule(DAILY, count=3, byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 9, 9, 0)]) def testDailyByMonthAndWeekDay(self): self.assertEqual(list(rrule(DAILY, count=3, bymonth=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 1, 6, 9, 0), datetime(1998, 1, 8, 9, 0)]) def testDailyByMonthAndNWeekDay(self): self.assertEqual(list(rrule(DAILY, count=3, bymonth=(1, 3), byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 1, 6, 9, 0), datetime(1998, 1, 8, 9, 0)]) def testDailyByMonthDayAndWeekDay(self): self.assertEqual(list(rrule(DAILY, count=3, bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 2, 3, 9, 0), datetime(1998, 3, 3, 9, 0)]) def testDailyByMonthAndMonthDayAndWeekDay(self): self.assertEqual(list(rrule(DAILY, count=3, bymonth=(1, 3), bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 3, 3, 9, 0), datetime(2001, 3, 1, 9, 0)]) def testDailyByYearDay(self): self.assertEqual(list(rrule(DAILY, count=4, byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 31, 9, 0), datetime(1998, 1, 1, 9, 0), datetime(1998, 4, 10, 9, 0), datetime(1998, 7, 19, 9, 0)]) def testDailyByYearDayNeg(self): self.assertEqual(list(rrule(DAILY, count=4, byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 31, 9, 0), datetime(1998, 1, 1, 9, 0), datetime(1998, 4, 10, 9, 0), datetime(1998, 7, 19, 9, 0)]) def testDailyByMonthAndYearDay(self): self.assertEqual(list(rrule(DAILY, count=4, bymonth=(1, 7), byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 7, 19, 9, 0), datetime(1999, 1, 1, 9, 0), datetime(1999, 7, 19, 9, 0)]) def testDailyByMonthAndYearDayNeg(self): self.assertEqual(list(rrule(DAILY, count=4, bymonth=(1, 7), byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 9, 0), datetime(1998, 7, 19, 9, 0), datetime(1999, 1, 1, 9, 0), datetime(1999, 7, 19, 9, 0)]) def testDailyByWeekNo(self): self.assertEqual(list(rrule(DAILY, count=3, byweekno=20, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 5, 11, 9, 0), datetime(1998, 5, 12, 9, 0), datetime(1998, 5, 13, 9, 0)]) def testDailyByWeekNoAndWeekDay(self): # That's a nice one. The first days of week number one # may be in the last year. self.assertEqual(list(rrule(DAILY, count=3, byweekno=1, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 29, 9, 0), datetime(1999, 1, 4, 9, 0), datetime(2000, 1, 3, 9, 0)]) def testDailyByWeekNoAndWeekDayLarge(self): # Another nice test. The last days of week number 52/53 # may be in the next year. self.assertEqual(list(rrule(DAILY, count=3, byweekno=52, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 28, 9, 0), datetime(1998, 12, 27, 9, 0), datetime(2000, 1, 2, 9, 0)]) def testDailyByWeekNoAndWeekDayLast(self): self.assertEqual(list(rrule(DAILY, count=3, byweekno=-1, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 28, 9, 0), datetime(1999, 1, 3, 9, 0), datetime(2000, 1, 2, 9, 0)]) def testDailyByWeekNoAndWeekDay53(self): self.assertEqual(list(rrule(DAILY, count=3, byweekno=53, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 12, 28, 9, 0), datetime(2004, 12, 27, 9, 0), datetime(2009, 12, 28, 9, 0)]) def testDailyByEaster(self): self.assertEqual(list(rrule(DAILY, count=3, byeaster=0, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 12, 9, 0), datetime(1999, 4, 4, 9, 0), datetime(2000, 4, 23, 9, 0)]) def testDailyByEasterPos(self): self.assertEqual(list(rrule(DAILY, count=3, byeaster=1, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 13, 9, 0), datetime(1999, 4, 5, 9, 0), datetime(2000, 4, 24, 9, 0)]) def testDailyByEasterNeg(self): self.assertEqual(list(rrule(DAILY, count=3, byeaster=-1, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 11, 9, 0), datetime(1999, 4, 3, 9, 0), datetime(2000, 4, 22, 9, 0)]) def testDailyByHour(self): self.assertEqual(list(rrule(DAILY, count=3, byhour=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0), datetime(1997, 9, 3, 6, 0), datetime(1997, 9, 3, 18, 0)]) def testDailyByMinute(self): self.assertEqual(list(rrule(DAILY, count=3, byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 6), datetime(1997, 9, 2, 9, 18), datetime(1997, 9, 3, 9, 6)]) def testDailyBySecond(self): self.assertEqual(list(rrule(DAILY, count=3, bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0, 6), datetime(1997, 9, 2, 9, 0, 18), datetime(1997, 9, 3, 9, 0, 6)]) def testDailyByHourAndMinute(self): self.assertEqual(list(rrule(DAILY, count=3, byhour=(6, 18), byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 6), datetime(1997, 9, 2, 18, 18), datetime(1997, 9, 3, 6, 6)]) def testDailyByHourAndSecond(self): self.assertEqual(list(rrule(DAILY, count=3, byhour=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0, 6), datetime(1997, 9, 2, 18, 0, 18), datetime(1997, 9, 3, 6, 0, 6)]) def testDailyByMinuteAndSecond(self): self.assertEqual(list(rrule(DAILY, count=3, byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 6, 6), datetime(1997, 9, 2, 9, 6, 18), datetime(1997, 9, 2, 9, 18, 6)]) def testDailyByHourAndMinuteAndSecond(self): self.assertEqual(list(rrule(DAILY, count=3, byhour=(6, 18), byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 6, 6), datetime(1997, 9, 2, 18, 6, 18), datetime(1997, 9, 2, 18, 18, 6)]) def testDailyBySetPos(self): self.assertEqual(list(rrule(DAILY, count=3, byhour=(6, 18), byminute=(15, 45), bysetpos=(3, -3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 15), datetime(1997, 9, 3, 6, 45), datetime(1997, 9, 3, 18, 15)]) def testHourly(self): self.assertEqual(list(rrule(HOURLY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 2, 10, 0), datetime(1997, 9, 2, 11, 0)]) def testHourlyInterval(self): self.assertEqual(list(rrule(HOURLY, count=3, interval=2, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 2, 11, 0), datetime(1997, 9, 2, 13, 0)]) def testHourlyIntervalLarge(self): self.assertEqual(list(rrule(HOURLY, count=3, interval=769, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 10, 4, 10, 0), datetime(1997, 11, 5, 11, 0)]) def testHourlyByMonth(self): self.assertEqual(list(rrule(HOURLY, count=3, bymonth=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0), datetime(1998, 1, 1, 1, 0), datetime(1998, 1, 1, 2, 0)]) def testHourlyByMonthDay(self): self.assertEqual(list(rrule(HOURLY, count=3, bymonthday=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 3, 0, 0), datetime(1997, 9, 3, 1, 0), datetime(1997, 9, 3, 2, 0)]) def testHourlyByMonthAndMonthDay(self): self.assertEqual(list(rrule(HOURLY, count=3, bymonth=(1, 3), bymonthday=(5, 7), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 5, 0, 0), datetime(1998, 1, 5, 1, 0), datetime(1998, 1, 5, 2, 0)]) def testHourlyByWeekDay(self): self.assertEqual(list(rrule(HOURLY, count=3, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 2, 10, 0), datetime(1997, 9, 2, 11, 0)]) def testHourlyByNWeekDay(self): self.assertEqual(list(rrule(HOURLY, count=3, byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 2, 10, 0), datetime(1997, 9, 2, 11, 0)]) def testHourlyByMonthAndWeekDay(self): self.assertEqual(list(rrule(HOURLY, count=3, bymonth=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0), datetime(1998, 1, 1, 1, 0), datetime(1998, 1, 1, 2, 0)]) def testHourlyByMonthAndNWeekDay(self): self.assertEqual(list(rrule(HOURLY, count=3, bymonth=(1, 3), byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0), datetime(1998, 1, 1, 1, 0), datetime(1998, 1, 1, 2, 0)]) def testHourlyByMonthDayAndWeekDay(self): self.assertEqual(list(rrule(HOURLY, count=3, bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0), datetime(1998, 1, 1, 1, 0), datetime(1998, 1, 1, 2, 0)]) def testHourlyByMonthAndMonthDayAndWeekDay(self): self.assertEqual(list(rrule(HOURLY, count=3, bymonth=(1, 3), bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0), datetime(1998, 1, 1, 1, 0), datetime(1998, 1, 1, 2, 0)]) def testHourlyByYearDay(self): self.assertEqual(list(rrule(HOURLY, count=4, byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 31, 0, 0), datetime(1997, 12, 31, 1, 0), datetime(1997, 12, 31, 2, 0), datetime(1997, 12, 31, 3, 0)]) def testHourlyByYearDayNeg(self): self.assertEqual(list(rrule(HOURLY, count=4, byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 31, 0, 0), datetime(1997, 12, 31, 1, 0), datetime(1997, 12, 31, 2, 0), datetime(1997, 12, 31, 3, 0)]) def testHourlyByMonthAndYearDay(self): self.assertEqual(list(rrule(HOURLY, count=4, bymonth=(4, 7), byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 10, 0, 0), datetime(1998, 4, 10, 1, 0), datetime(1998, 4, 10, 2, 0), datetime(1998, 4, 10, 3, 0)]) def testHourlyByMonthAndYearDayNeg(self): self.assertEqual(list(rrule(HOURLY, count=4, bymonth=(4, 7), byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 10, 0, 0), datetime(1998, 4, 10, 1, 0), datetime(1998, 4, 10, 2, 0), datetime(1998, 4, 10, 3, 0)]) def testHourlyByWeekNo(self): self.assertEqual(list(rrule(HOURLY, count=3, byweekno=20, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 5, 11, 0, 0), datetime(1998, 5, 11, 1, 0), datetime(1998, 5, 11, 2, 0)]) def testHourlyByWeekNoAndWeekDay(self): self.assertEqual(list(rrule(HOURLY, count=3, byweekno=1, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 29, 0, 0), datetime(1997, 12, 29, 1, 0), datetime(1997, 12, 29, 2, 0)]) def testHourlyByWeekNoAndWeekDayLarge(self): self.assertEqual(list(rrule(HOURLY, count=3, byweekno=52, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 28, 0, 0), datetime(1997, 12, 28, 1, 0), datetime(1997, 12, 28, 2, 0)]) def testHourlyByWeekNoAndWeekDayLast(self): self.assertEqual(list(rrule(HOURLY, count=3, byweekno=-1, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 28, 0, 0), datetime(1997, 12, 28, 1, 0), datetime(1997, 12, 28, 2, 0)]) def testHourlyByWeekNoAndWeekDay53(self): self.assertEqual(list(rrule(HOURLY, count=3, byweekno=53, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 12, 28, 0, 0), datetime(1998, 12, 28, 1, 0), datetime(1998, 12, 28, 2, 0)]) def testHourlyByEaster(self): self.assertEqual(list(rrule(HOURLY, count=3, byeaster=0, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 12, 0, 0), datetime(1998, 4, 12, 1, 0), datetime(1998, 4, 12, 2, 0)]) def testHourlyByEasterPos(self): self.assertEqual(list(rrule(HOURLY, count=3, byeaster=1, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 13, 0, 0), datetime(1998, 4, 13, 1, 0), datetime(1998, 4, 13, 2, 0)]) def testHourlyByEasterNeg(self): self.assertEqual(list(rrule(HOURLY, count=3, byeaster=-1, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 11, 0, 0), datetime(1998, 4, 11, 1, 0), datetime(1998, 4, 11, 2, 0)]) def testHourlyByHour(self): self.assertEqual(list(rrule(HOURLY, count=3, byhour=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0), datetime(1997, 9, 3, 6, 0), datetime(1997, 9, 3, 18, 0)]) def testHourlyByMinute(self): self.assertEqual(list(rrule(HOURLY, count=3, byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 6), datetime(1997, 9, 2, 9, 18), datetime(1997, 9, 2, 10, 6)]) def testHourlyBySecond(self): self.assertEqual(list(rrule(HOURLY, count=3, bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0, 6), datetime(1997, 9, 2, 9, 0, 18), datetime(1997, 9, 2, 10, 0, 6)]) def testHourlyByHourAndMinute(self): self.assertEqual(list(rrule(HOURLY, count=3, byhour=(6, 18), byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 6), datetime(1997, 9, 2, 18, 18), datetime(1997, 9, 3, 6, 6)]) def testHourlyByHourAndSecond(self): self.assertEqual(list(rrule(HOURLY, count=3, byhour=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0, 6), datetime(1997, 9, 2, 18, 0, 18), datetime(1997, 9, 3, 6, 0, 6)]) def testHourlyByMinuteAndSecond(self): self.assertEqual(list(rrule(HOURLY, count=3, byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 6, 6), datetime(1997, 9, 2, 9, 6, 18), datetime(1997, 9, 2, 9, 18, 6)]) def testHourlyByHourAndMinuteAndSecond(self): self.assertEqual(list(rrule(HOURLY, count=3, byhour=(6, 18), byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 6, 6), datetime(1997, 9, 2, 18, 6, 18), datetime(1997, 9, 2, 18, 18, 6)]) def testHourlyBySetPos(self): self.assertEqual(list(rrule(HOURLY, count=3, byminute=(15, 45), bysecond=(15, 45), bysetpos=(3, -3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 15, 45), datetime(1997, 9, 2, 9, 45, 15), datetime(1997, 9, 2, 10, 15, 45)]) def testMinutely(self): self.assertEqual(list(rrule(MINUTELY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 2, 9, 1), datetime(1997, 9, 2, 9, 2)]) def testMinutelyInterval(self): self.assertEqual(list(rrule(MINUTELY, count=3, interval=2, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 2, 9, 2), datetime(1997, 9, 2, 9, 4)]) def testMinutelyIntervalLarge(self): self.assertEqual(list(rrule(MINUTELY, count=3, interval=1501, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 3, 10, 1), datetime(1997, 9, 4, 11, 2)]) def testMinutelyByMonth(self): self.assertEqual(list(rrule(MINUTELY, count=3, bymonth=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0), datetime(1998, 1, 1, 0, 1), datetime(1998, 1, 1, 0, 2)]) def testMinutelyByMonthDay(self): self.assertEqual(list(rrule(MINUTELY, count=3, bymonthday=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 3, 0, 0), datetime(1997, 9, 3, 0, 1), datetime(1997, 9, 3, 0, 2)]) def testMinutelyByMonthAndMonthDay(self): self.assertEqual(list(rrule(MINUTELY, count=3, bymonth=(1, 3), bymonthday=(5, 7), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 5, 0, 0), datetime(1998, 1, 5, 0, 1), datetime(1998, 1, 5, 0, 2)]) def testMinutelyByWeekDay(self): self.assertEqual(list(rrule(MINUTELY, count=3, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 2, 9, 1), datetime(1997, 9, 2, 9, 2)]) def testMinutelyByNWeekDay(self): self.assertEqual(list(rrule(MINUTELY, count=3, byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 2, 9, 1), datetime(1997, 9, 2, 9, 2)]) def testMinutelyByMonthAndWeekDay(self): self.assertEqual(list(rrule(MINUTELY, count=3, bymonth=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0), datetime(1998, 1, 1, 0, 1), datetime(1998, 1, 1, 0, 2)]) def testMinutelyByMonthAndNWeekDay(self): self.assertEqual(list(rrule(MINUTELY, count=3, bymonth=(1, 3), byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0), datetime(1998, 1, 1, 0, 1), datetime(1998, 1, 1, 0, 2)]) def testMinutelyByMonthDayAndWeekDay(self): self.assertEqual(list(rrule(MINUTELY, count=3, bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0), datetime(1998, 1, 1, 0, 1), datetime(1998, 1, 1, 0, 2)]) def testMinutelyByMonthAndMonthDayAndWeekDay(self): self.assertEqual(list(rrule(MINUTELY, count=3, bymonth=(1, 3), bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0), datetime(1998, 1, 1, 0, 1), datetime(1998, 1, 1, 0, 2)]) def testMinutelyByYearDay(self): self.assertEqual(list(rrule(MINUTELY, count=4, byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 31, 0, 0), datetime(1997, 12, 31, 0, 1), datetime(1997, 12, 31, 0, 2), datetime(1997, 12, 31, 0, 3)]) def testMinutelyByYearDayNeg(self): self.assertEqual(list(rrule(MINUTELY, count=4, byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 31, 0, 0), datetime(1997, 12, 31, 0, 1), datetime(1997, 12, 31, 0, 2), datetime(1997, 12, 31, 0, 3)]) def testMinutelyByMonthAndYearDay(self): self.assertEqual(list(rrule(MINUTELY, count=4, bymonth=(4, 7), byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 10, 0, 0), datetime(1998, 4, 10, 0, 1), datetime(1998, 4, 10, 0, 2), datetime(1998, 4, 10, 0, 3)]) def testMinutelyByMonthAndYearDayNeg(self): self.assertEqual(list(rrule(MINUTELY, count=4, bymonth=(4, 7), byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 10, 0, 0), datetime(1998, 4, 10, 0, 1), datetime(1998, 4, 10, 0, 2), datetime(1998, 4, 10, 0, 3)]) def testMinutelyByWeekNo(self): self.assertEqual(list(rrule(MINUTELY, count=3, byweekno=20, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 5, 11, 0, 0), datetime(1998, 5, 11, 0, 1), datetime(1998, 5, 11, 0, 2)]) def testMinutelyByWeekNoAndWeekDay(self): self.assertEqual(list(rrule(MINUTELY, count=3, byweekno=1, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 29, 0, 0), datetime(1997, 12, 29, 0, 1), datetime(1997, 12, 29, 0, 2)]) def testMinutelyByWeekNoAndWeekDayLarge(self): self.assertEqual(list(rrule(MINUTELY, count=3, byweekno=52, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 28, 0, 0), datetime(1997, 12, 28, 0, 1), datetime(1997, 12, 28, 0, 2)]) def testMinutelyByWeekNoAndWeekDayLast(self): self.assertEqual(list(rrule(MINUTELY, count=3, byweekno=-1, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 28, 0, 0), datetime(1997, 12, 28, 0, 1), datetime(1997, 12, 28, 0, 2)]) def testMinutelyByWeekNoAndWeekDay53(self): self.assertEqual(list(rrule(MINUTELY, count=3, byweekno=53, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 12, 28, 0, 0), datetime(1998, 12, 28, 0, 1), datetime(1998, 12, 28, 0, 2)]) def testMinutelyByEaster(self): self.assertEqual(list(rrule(MINUTELY, count=3, byeaster=0, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 12, 0, 0), datetime(1998, 4, 12, 0, 1), datetime(1998, 4, 12, 0, 2)]) def testMinutelyByEasterPos(self): self.assertEqual(list(rrule(MINUTELY, count=3, byeaster=1, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 13, 0, 0), datetime(1998, 4, 13, 0, 1), datetime(1998, 4, 13, 0, 2)]) def testMinutelyByEasterNeg(self): self.assertEqual(list(rrule(MINUTELY, count=3, byeaster=-1, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 11, 0, 0), datetime(1998, 4, 11, 0, 1), datetime(1998, 4, 11, 0, 2)]) def testMinutelyByHour(self): self.assertEqual(list(rrule(MINUTELY, count=3, byhour=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0), datetime(1997, 9, 2, 18, 1), datetime(1997, 9, 2, 18, 2)]) def testMinutelyByMinute(self): self.assertEqual(list(rrule(MINUTELY, count=3, byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 6), datetime(1997, 9, 2, 9, 18), datetime(1997, 9, 2, 10, 6)]) def testMinutelyBySecond(self): self.assertEqual(list(rrule(MINUTELY, count=3, bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0, 6), datetime(1997, 9, 2, 9, 0, 18), datetime(1997, 9, 2, 9, 1, 6)]) def testMinutelyByHourAndMinute(self): self.assertEqual(list(rrule(MINUTELY, count=3, byhour=(6, 18), byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 6), datetime(1997, 9, 2, 18, 18), datetime(1997, 9, 3, 6, 6)]) def testMinutelyByHourAndSecond(self): self.assertEqual(list(rrule(MINUTELY, count=3, byhour=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0, 6), datetime(1997, 9, 2, 18, 0, 18), datetime(1997, 9, 2, 18, 1, 6)]) def testMinutelyByMinuteAndSecond(self): self.assertEqual(list(rrule(MINUTELY, count=3, byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 6, 6), datetime(1997, 9, 2, 9, 6, 18), datetime(1997, 9, 2, 9, 18, 6)]) def testMinutelyByHourAndMinuteAndSecond(self): self.assertEqual(list(rrule(MINUTELY, count=3, byhour=(6, 18), byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 6, 6), datetime(1997, 9, 2, 18, 6, 18), datetime(1997, 9, 2, 18, 18, 6)]) def testMinutelyBySetPos(self): self.assertEqual(list(rrule(MINUTELY, count=3, bysecond=(15, 30, 45), bysetpos=(3, -3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0, 15), datetime(1997, 9, 2, 9, 0, 45), datetime(1997, 9, 2, 9, 1, 15)]) def testSecondly(self): self.assertEqual(list(rrule(SECONDLY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0, 0), datetime(1997, 9, 2, 9, 0, 1), datetime(1997, 9, 2, 9, 0, 2)]) def testSecondlyInterval(self): self.assertEqual(list(rrule(SECONDLY, count=3, interval=2, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0, 0), datetime(1997, 9, 2, 9, 0, 2), datetime(1997, 9, 2, 9, 0, 4)]) def testSecondlyIntervalLarge(self): self.assertEqual(list(rrule(SECONDLY, count=3, interval=90061, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0, 0), datetime(1997, 9, 3, 10, 1, 1), datetime(1997, 9, 4, 11, 2, 2)]) def testSecondlyByMonth(self): self.assertEqual(list(rrule(SECONDLY, count=3, bymonth=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0, 0), datetime(1998, 1, 1, 0, 0, 1), datetime(1998, 1, 1, 0, 0, 2)]) def testSecondlyByMonthDay(self): self.assertEqual(list(rrule(SECONDLY, count=3, bymonthday=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 3, 0, 0, 0), datetime(1997, 9, 3, 0, 0, 1), datetime(1997, 9, 3, 0, 0, 2)]) def testSecondlyByMonthAndMonthDay(self): self.assertEqual(list(rrule(SECONDLY, count=3, bymonth=(1, 3), bymonthday=(5, 7), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 5, 0, 0, 0), datetime(1998, 1, 5, 0, 0, 1), datetime(1998, 1, 5, 0, 0, 2)]) def testSecondlyByWeekDay(self): self.assertEqual(list(rrule(SECONDLY, count=3, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0, 0), datetime(1997, 9, 2, 9, 0, 1), datetime(1997, 9, 2, 9, 0, 2)]) def testSecondlyByNWeekDay(self): self.assertEqual(list(rrule(SECONDLY, count=3, byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0, 0), datetime(1997, 9, 2, 9, 0, 1), datetime(1997, 9, 2, 9, 0, 2)]) def testSecondlyByMonthAndWeekDay(self): self.assertEqual(list(rrule(SECONDLY, count=3, bymonth=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0, 0), datetime(1998, 1, 1, 0, 0, 1), datetime(1998, 1, 1, 0, 0, 2)]) def testSecondlyByMonthAndNWeekDay(self): self.assertEqual(list(rrule(SECONDLY, count=3, bymonth=(1, 3), byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0, 0), datetime(1998, 1, 1, 0, 0, 1), datetime(1998, 1, 1, 0, 0, 2)]) def testSecondlyByMonthDayAndWeekDay(self): self.assertEqual(list(rrule(SECONDLY, count=3, bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0, 0), datetime(1998, 1, 1, 0, 0, 1), datetime(1998, 1, 1, 0, 0, 2)]) def testSecondlyByMonthAndMonthDayAndWeekDay(self): self.assertEqual(list(rrule(SECONDLY, count=3, bymonth=(1, 3), bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 1, 0, 0, 0), datetime(1998, 1, 1, 0, 0, 1), datetime(1998, 1, 1, 0, 0, 2)]) def testSecondlyByYearDay(self): self.assertEqual(list(rrule(SECONDLY, count=4, byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 31, 0, 0, 0), datetime(1997, 12, 31, 0, 0, 1), datetime(1997, 12, 31, 0, 0, 2), datetime(1997, 12, 31, 0, 0, 3)]) def testSecondlyByYearDayNeg(self): self.assertEqual(list(rrule(SECONDLY, count=4, byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 31, 0, 0, 0), datetime(1997, 12, 31, 0, 0, 1), datetime(1997, 12, 31, 0, 0, 2), datetime(1997, 12, 31, 0, 0, 3)]) def testSecondlyByMonthAndYearDay(self): self.assertEqual(list(rrule(SECONDLY, count=4, bymonth=(4, 7), byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 10, 0, 0, 0), datetime(1998, 4, 10, 0, 0, 1), datetime(1998, 4, 10, 0, 0, 2), datetime(1998, 4, 10, 0, 0, 3)]) def testSecondlyByMonthAndYearDayNeg(self): self.assertEqual(list(rrule(SECONDLY, count=4, bymonth=(4, 7), byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 10, 0, 0, 0), datetime(1998, 4, 10, 0, 0, 1), datetime(1998, 4, 10, 0, 0, 2), datetime(1998, 4, 10, 0, 0, 3)]) def testSecondlyByWeekNo(self): self.assertEqual(list(rrule(SECONDLY, count=3, byweekno=20, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 5, 11, 0, 0, 0), datetime(1998, 5, 11, 0, 0, 1), datetime(1998, 5, 11, 0, 0, 2)]) def testSecondlyByWeekNoAndWeekDay(self): self.assertEqual(list(rrule(SECONDLY, count=3, byweekno=1, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 29, 0, 0, 0), datetime(1997, 12, 29, 0, 0, 1), datetime(1997, 12, 29, 0, 0, 2)]) def testSecondlyByWeekNoAndWeekDayLarge(self): self.assertEqual(list(rrule(SECONDLY, count=3, byweekno=52, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 28, 0, 0, 0), datetime(1997, 12, 28, 0, 0, 1), datetime(1997, 12, 28, 0, 0, 2)]) def testSecondlyByWeekNoAndWeekDayLast(self): self.assertEqual(list(rrule(SECONDLY, count=3, byweekno=-1, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 12, 28, 0, 0, 0), datetime(1997, 12, 28, 0, 0, 1), datetime(1997, 12, 28, 0, 0, 2)]) def testSecondlyByWeekNoAndWeekDay53(self): self.assertEqual(list(rrule(SECONDLY, count=3, byweekno=53, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 12, 28, 0, 0, 0), datetime(1998, 12, 28, 0, 0, 1), datetime(1998, 12, 28, 0, 0, 2)]) def testSecondlyByEaster(self): self.assertEqual(list(rrule(SECONDLY, count=3, byeaster=0, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 12, 0, 0, 0), datetime(1998, 4, 12, 0, 0, 1), datetime(1998, 4, 12, 0, 0, 2)]) def testSecondlyByEasterPos(self): self.assertEqual(list(rrule(SECONDLY, count=3, byeaster=1, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 13, 0, 0, 0), datetime(1998, 4, 13, 0, 0, 1), datetime(1998, 4, 13, 0, 0, 2)]) def testSecondlyByEasterNeg(self): self.assertEqual(list(rrule(SECONDLY, count=3, byeaster=-1, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 4, 11, 0, 0, 0), datetime(1998, 4, 11, 0, 0, 1), datetime(1998, 4, 11, 0, 0, 2)]) def testSecondlyByHour(self): self.assertEqual(list(rrule(SECONDLY, count=3, byhour=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0, 0), datetime(1997, 9, 2, 18, 0, 1), datetime(1997, 9, 2, 18, 0, 2)]) def testSecondlyByMinute(self): self.assertEqual(list(rrule(SECONDLY, count=3, byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 6, 0), datetime(1997, 9, 2, 9, 6, 1), datetime(1997, 9, 2, 9, 6, 2)]) def testSecondlyBySecond(self): self.assertEqual(list(rrule(SECONDLY, count=3, bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0, 6), datetime(1997, 9, 2, 9, 0, 18), datetime(1997, 9, 2, 9, 1, 6)]) def testSecondlyByHourAndMinute(self): self.assertEqual(list(rrule(SECONDLY, count=3, byhour=(6, 18), byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 6, 0), datetime(1997, 9, 2, 18, 6, 1), datetime(1997, 9, 2, 18, 6, 2)]) def testSecondlyByHourAndSecond(self): self.assertEqual(list(rrule(SECONDLY, count=3, byhour=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 0, 6), datetime(1997, 9, 2, 18, 0, 18), datetime(1997, 9, 2, 18, 1, 6)]) def testSecondlyByMinuteAndSecond(self): self.assertEqual(list(rrule(SECONDLY, count=3, byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 6, 6), datetime(1997, 9, 2, 9, 6, 18), datetime(1997, 9, 2, 9, 18, 6)]) def testSecondlyByHourAndMinuteAndSecond(self): self.assertEqual(list(rrule(SECONDLY, count=3, byhour=(6, 18), byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 18, 6, 6), datetime(1997, 9, 2, 18, 6, 18), datetime(1997, 9, 2, 18, 18, 6)]) def testSecondlyByHourAndMinuteAndSecondBug(self): # This explores a bug found by Mathieu Bridon. self.assertEqual(list(rrule(SECONDLY, count=3, bysecond=(0,), byminute=(1,), dtstart=datetime(2010, 3, 22, 12, 1))), [datetime(2010, 3, 22, 12, 1), datetime(2010, 3, 22, 13, 1), datetime(2010, 3, 22, 14, 1)]) def testLongIntegers(self): if PY2: # There are no longs in python3 self.assertEqual(list(rrule(MINUTELY, count=long(2), interval=long(2), bymonth=long(2), byweekday=long(3), byhour=long(6), byminute=long(6), bysecond=long(6), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 2, 5, 6, 6, 6), datetime(1998, 2, 12, 6, 6, 6)]) self.assertEqual(list(rrule(YEARLY, count=long(2), bymonthday=long(5), byweekno=long(2), dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1998, 1, 5, 9, 0), datetime(2004, 1, 5, 9, 0)]) def testHourlyBadRRule(self): """ When `byhour` is specified with `freq=HOURLY`, there are certain combinations of `dtstart` and `byhour` which result in an rrule with no valid values. See https://github.com/dateutil/dateutil/issues/4 """ self.assertRaises(ValueError, rrule, HOURLY, **dict(interval=4, byhour=(7, 11, 15, 19), dtstart=datetime(1997, 9, 2, 9, 0))) def testMinutelyBadRRule(self): """ See :func:`testHourlyBadRRule` for details. """ self.assertRaises(ValueError, rrule, MINUTELY, **dict(interval=12, byminute=(10, 11, 25, 39, 50), dtstart=datetime(1997, 9, 2, 9, 0))) def testSecondlyBadRRule(self): """ See :func:`testHourlyBadRRule` for details. """ self.assertRaises(ValueError, rrule, SECONDLY, **dict(interval=10, bysecond=(2, 15, 37, 42, 59), dtstart=datetime(1997, 9, 2, 9, 0))) def testMinutelyBadComboRRule(self): """ Certain values of :param:`interval` in :class:`rrule`, when combined with certain values of :param:`byhour` create rules which apply to no valid dates. The library should detect this case in the iterator and raise a :exception:`ValueError`. """ # In Python 2.7 you can use a context manager for this. def make_bad_rrule(): list(rrule(MINUTELY, interval=120, byhour=(10, 12, 14, 16), count=2, dtstart=datetime(1997, 9, 2, 9, 0))) self.assertRaises(ValueError, make_bad_rrule) def testSecondlyBadComboRRule(self): """ See :func:`testMinutelyBadComboRRule' for details. """ # In Python 2.7 you can use a context manager for this. def make_bad_minute_rrule(): list(rrule(SECONDLY, interval=360, byminute=(10, 28, 49), count=4, dtstart=datetime(1997, 9, 2, 9, 0))) def make_bad_hour_rrule(): list(rrule(SECONDLY, interval=43200, byhour=(2, 10, 18, 23), count=4, dtstart=datetime(1997, 9, 2, 9, 0))) self.assertRaises(ValueError, make_bad_minute_rrule) self.assertRaises(ValueError, make_bad_hour_rrule) def testBadUntilCountRRule(self): """ See rfc-5545 3.3.10 - This checks for the deprecation warning, and will eventually check for an error. """ with pytest.warns(DeprecationWarning): rrule(DAILY, dtstart=datetime(1997, 9, 2, 9, 0), count=3, until=datetime(1997, 9, 4, 9, 0)) def testUntilNotMatching(self): self.assertEqual(list(rrule(DAILY, dtstart=datetime(1997, 9, 2, 9, 0), until=datetime(1997, 9, 5, 8, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 3, 9, 0), datetime(1997, 9, 4, 9, 0)]) def testUntilMatching(self): self.assertEqual(list(rrule(DAILY, dtstart=datetime(1997, 9, 2, 9, 0), until=datetime(1997, 9, 4, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 3, 9, 0), datetime(1997, 9, 4, 9, 0)]) def testUntilSingle(self): self.assertEqual(list(rrule(DAILY, dtstart=datetime(1997, 9, 2, 9, 0), until=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0)]) def testUntilEmpty(self): self.assertEqual(list(rrule(DAILY, dtstart=datetime(1997, 9, 2, 9, 0), until=datetime(1997, 9, 1, 9, 0))), []) def testUntilWithDate(self): self.assertEqual(list(rrule(DAILY, dtstart=datetime(1997, 9, 2, 9, 0), until=date(1997, 9, 5))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 3, 9, 0), datetime(1997, 9, 4, 9, 0)]) def testWkStIntervalMO(self): self.assertEqual(list(rrule(WEEKLY, count=3, interval=2, byweekday=(TU, SU), wkst=MO, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 7, 9, 0), datetime(1997, 9, 16, 9, 0)]) def testWkStIntervalSU(self): self.assertEqual(list(rrule(WEEKLY, count=3, interval=2, byweekday=(TU, SU), wkst=SU, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 14, 9, 0), datetime(1997, 9, 16, 9, 0)]) def testDTStartIsDate(self): self.assertEqual(list(rrule(DAILY, count=3, dtstart=date(1997, 9, 2))), [datetime(1997, 9, 2, 0, 0), datetime(1997, 9, 3, 0, 0), datetime(1997, 9, 4, 0, 0)]) def testDTStartWithMicroseconds(self): self.assertEqual(list(rrule(DAILY, count=3, dtstart=datetime(1997, 9, 2, 9, 0, 0, 500000))), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 3, 9, 0), datetime(1997, 9, 4, 9, 0)]) def testMaxYear(self): self.assertEqual(list(rrule(YEARLY, count=3, bymonth=2, bymonthday=31, dtstart=datetime(9997, 9, 2, 9, 0, 0))), []) def testGetItem(self): self.assertEqual(rrule(DAILY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))[0], datetime(1997, 9, 2, 9, 0)) def testGetItemNeg(self): self.assertEqual(rrule(DAILY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))[-1], datetime(1997, 9, 4, 9, 0)) def testGetItemSlice(self): self.assertEqual(rrule(DAILY, # count=3, dtstart=datetime(1997, 9, 2, 9, 0))[1:2], [datetime(1997, 9, 3, 9, 0)]) def testGetItemSliceEmpty(self): self.assertEqual(rrule(DAILY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))[:], [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 3, 9, 0), datetime(1997, 9, 4, 9, 0)]) def testGetItemSliceStep(self): self.assertEqual(rrule(DAILY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))[::-2], [datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 2, 9, 0)]) def testCount(self): self.assertEqual(rrule(DAILY, count=3, dtstart=datetime(1997, 9, 2, 9, 0)).count(), 3) def testCountZero(self): self.assertEqual(rrule(YEARLY, count=0, dtstart=datetime(1997, 9, 2, 9, 0)).count(), 0) def testContains(self): rr = rrule(DAILY, count=3, dtstart=datetime(1997, 9, 2, 9, 0)) self.assertEqual(datetime(1997, 9, 3, 9, 0) in rr, True) def testContainsNot(self): rr = rrule(DAILY, count=3, dtstart=datetime(1997, 9, 2, 9, 0)) self.assertEqual(datetime(1997, 9, 3, 9, 0) not in rr, False) def testBefore(self): self.assertEqual(rrule(DAILY, # count=5 dtstart=datetime(1997, 9, 2, 9, 0)).before(datetime(1997, 9, 5, 9, 0)), datetime(1997, 9, 4, 9, 0)) def testBeforeInc(self): self.assertEqual(rrule(DAILY, #count=5, dtstart=datetime(1997, 9, 2, 9, 0)) .before(datetime(1997, 9, 5, 9, 0), inc=True), datetime(1997, 9, 5, 9, 0)) def testAfter(self): self.assertEqual(rrule(DAILY, #count=5, dtstart=datetime(1997, 9, 2, 9, 0)) .after(datetime(1997, 9, 4, 9, 0)), datetime(1997, 9, 5, 9, 0)) def testAfterInc(self): self.assertEqual(rrule(DAILY, #count=5, dtstart=datetime(1997, 9, 2, 9, 0)) .after(datetime(1997, 9, 4, 9, 0), inc=True), datetime(1997, 9, 4, 9, 0)) def testXAfter(self): self.assertEqual(list(rrule(DAILY, dtstart=datetime(1997, 9, 2, 9, 0)) .xafter(datetime(1997, 9, 8, 9, 0), count=12)), [datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 10, 9, 0), datetime(1997, 9, 11, 9, 0), datetime(1997, 9, 12, 9, 0), datetime(1997, 9, 13, 9, 0), datetime(1997, 9, 14, 9, 0), datetime(1997, 9, 15, 9, 0), datetime(1997, 9, 16, 9, 0), datetime(1997, 9, 17, 9, 0), datetime(1997, 9, 18, 9, 0), datetime(1997, 9, 19, 9, 0), datetime(1997, 9, 20, 9, 0)]) def testXAfterInc(self): self.assertEqual(list(rrule(DAILY, dtstart=datetime(1997, 9, 2, 9, 0)) .xafter(datetime(1997, 9, 8, 9, 0), count=12, inc=True)), [datetime(1997, 9, 8, 9, 0), datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 10, 9, 0), datetime(1997, 9, 11, 9, 0), datetime(1997, 9, 12, 9, 0), datetime(1997, 9, 13, 9, 0), datetime(1997, 9, 14, 9, 0), datetime(1997, 9, 15, 9, 0), datetime(1997, 9, 16, 9, 0), datetime(1997, 9, 17, 9, 0), datetime(1997, 9, 18, 9, 0), datetime(1997, 9, 19, 9, 0)]) def testBetween(self): self.assertEqual(rrule(DAILY, #count=5, dtstart=datetime(1997, 9, 2, 9, 0)) .between(datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 6, 9, 0)), [datetime(1997, 9, 3, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 5, 9, 0)]) def testBetweenInc(self): self.assertEqual(rrule(DAILY, #count=5, dtstart=datetime(1997, 9, 2, 9, 0)) .between(datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 6, 9, 0), inc=True), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 3, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 5, 9, 0), datetime(1997, 9, 6, 9, 0)]) def testCachePre(self): rr = rrule(DAILY, count=15, cache=True, dtstart=datetime(1997, 9, 2, 9, 0)) self.assertEqual(list(rr), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 3, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 5, 9, 0), datetime(1997, 9, 6, 9, 0), datetime(1997, 9, 7, 9, 0), datetime(1997, 9, 8, 9, 0), datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 10, 9, 0), datetime(1997, 9, 11, 9, 0), datetime(1997, 9, 12, 9, 0), datetime(1997, 9, 13, 9, 0), datetime(1997, 9, 14, 9, 0), datetime(1997, 9, 15, 9, 0), datetime(1997, 9, 16, 9, 0)]) def testCachePost(self): rr = rrule(DAILY, count=15, cache=True, dtstart=datetime(1997, 9, 2, 9, 0)) for x in rr: pass self.assertEqual(list(rr), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 3, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 5, 9, 0), datetime(1997, 9, 6, 9, 0), datetime(1997, 9, 7, 9, 0), datetime(1997, 9, 8, 9, 0), datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 10, 9, 0), datetime(1997, 9, 11, 9, 0), datetime(1997, 9, 12, 9, 0), datetime(1997, 9, 13, 9, 0), datetime(1997, 9, 14, 9, 0), datetime(1997, 9, 15, 9, 0), datetime(1997, 9, 16, 9, 0)]) def testCachePostInternal(self): rr = rrule(DAILY, count=15, cache=True, dtstart=datetime(1997, 9, 2, 9, 0)) for x in rr: pass self.assertEqual(rr._cache, [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 3, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 5, 9, 0), datetime(1997, 9, 6, 9, 0), datetime(1997, 9, 7, 9, 0), datetime(1997, 9, 8, 9, 0), datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 10, 9, 0), datetime(1997, 9, 11, 9, 0), datetime(1997, 9, 12, 9, 0), datetime(1997, 9, 13, 9, 0), datetime(1997, 9, 14, 9, 0), datetime(1997, 9, 15, 9, 0), datetime(1997, 9, 16, 9, 0)]) def testCachePreContains(self): rr = rrule(DAILY, count=3, cache=True, dtstart=datetime(1997, 9, 2, 9, 0)) self.assertEqual(datetime(1997, 9, 3, 9, 0) in rr, True) def testCachePostContains(self): rr = rrule(DAILY, count=3, cache=True, dtstart=datetime(1997, 9, 2, 9, 0)) for x in rr: pass self.assertEqual(datetime(1997, 9, 3, 9, 0) in rr, True) def testStr(self): self.assertEqual(list(rrulestr( "DTSTART:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=3\n" )), [datetime(1997, 9, 2, 9, 0), datetime(1998, 9, 2, 9, 0), datetime(1999, 9, 2, 9, 0)]) def testStrWithTZID(self): NYC = tz.gettz('America/New_York') self.assertEqual(list(rrulestr( "DTSTART;TZID=America/New_York:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=3\n" )), [datetime(1997, 9, 2, 9, 0, tzinfo=NYC), datetime(1998, 9, 2, 9, 0, tzinfo=NYC), datetime(1999, 9, 2, 9, 0, tzinfo=NYC)]) def testStrWithTZIDMapping(self): rrstr = ("DTSTART;TZID=Eastern:19970902T090000\n" + "RRULE:FREQ=YEARLY;COUNT=3") NYC = tz.gettz('America/New_York') rr = rrulestr(rrstr, tzids={'Eastern': NYC}) exp = [datetime(1997, 9, 2, 9, 0, tzinfo=NYC), datetime(1998, 9, 2, 9, 0, tzinfo=NYC), datetime(1999, 9, 2, 9, 0, tzinfo=NYC)] self.assertEqual(list(rr), exp) def testStrWithTZIDCallable(self): rrstr = ('DTSTART;TZID=UTC+04:19970902T090000\n' + 'RRULE:FREQ=YEARLY;COUNT=3') TZ = tz.tzstr('UTC+04') def parse_tzstr(tzstr): if tzstr is None: raise ValueError('Invalid tzstr') return tz.tzstr(tzstr) rr = rrulestr(rrstr, tzids=parse_tzstr) exp = [datetime(1997, 9, 2, 9, 0, tzinfo=TZ), datetime(1998, 9, 2, 9, 0, tzinfo=TZ), datetime(1999, 9, 2, 9, 0, tzinfo=TZ),] self.assertEqual(list(rr), exp) def testStrWithTZIDCallableFailure(self): rrstr = ('DTSTART;TZID=America/New_York:19970902T090000\n' + 'RRULE:FREQ=YEARLY;COUNT=3') class TzInfoError(Exception): pass def tzinfos(tzstr): if tzstr == 'America/New_York': raise TzInfoError('Invalid!') return None with self.assertRaises(TzInfoError): rrulestr(rrstr, tzids=tzinfos) def testStrWithConflictingTZID(self): # RFC 5545 Section 3.3.5, FORM #2: DATE WITH UTC TIME # https://tools.ietf.org/html/rfc5545#section-3.3.5 # The "TZID" property parameter MUST NOT be applied to DATE-TIME with self.assertRaises(ValueError): rrulestr("DTSTART;TZID=America/New_York:19970902T090000Z\n"+ "RRULE:FREQ=YEARLY;COUNT=3\n") def testStrType(self): self.assertEqual(isinstance(rrulestr( "DTSTART:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=3\n" ), rrule), True) def testStrForceSetType(self): self.assertEqual(isinstance(rrulestr( "DTSTART:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=3\n" , forceset=True), rruleset), True) def testStrSetType(self): self.assertEqual(isinstance(rrulestr( "DTSTART:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=2;BYDAY=TU\n" "RRULE:FREQ=YEARLY;COUNT=1;BYDAY=TH\n" ), rruleset), True) def testStrCase(self): self.assertEqual(list(rrulestr( "dtstart:19970902T090000\n" "rrule:freq=yearly;count=3\n" )), [datetime(1997, 9, 2, 9, 0), datetime(1998, 9, 2, 9, 0), datetime(1999, 9, 2, 9, 0)]) def testStrSpaces(self): self.assertEqual(list(rrulestr( " DTSTART:19970902T090000 " " RRULE:FREQ=YEARLY;COUNT=3 " )), [datetime(1997, 9, 2, 9, 0), datetime(1998, 9, 2, 9, 0), datetime(1999, 9, 2, 9, 0)]) def testStrSpacesAndLines(self): self.assertEqual(list(rrulestr( " DTSTART:19970902T090000 \n" " \n" " RRULE:FREQ=YEARLY;COUNT=3 \n" )), [datetime(1997, 9, 2, 9, 0), datetime(1998, 9, 2, 9, 0), datetime(1999, 9, 2, 9, 0)]) def testStrNoDTStart(self): self.assertEqual(list(rrulestr( "RRULE:FREQ=YEARLY;COUNT=3\n" , dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1998, 9, 2, 9, 0), datetime(1999, 9, 2, 9, 0)]) def testStrValueOnly(self): self.assertEqual(list(rrulestr( "FREQ=YEARLY;COUNT=3\n" , dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1998, 9, 2, 9, 0), datetime(1999, 9, 2, 9, 0)]) def testStrUnfold(self): self.assertEqual(list(rrulestr( "FREQ=YEA\n RLY;COUNT=3\n", unfold=True, dtstart=datetime(1997, 9, 2, 9, 0))), [datetime(1997, 9, 2, 9, 0), datetime(1998, 9, 2, 9, 0), datetime(1999, 9, 2, 9, 0)]) def testStrSet(self): self.assertEqual(list(rrulestr( "DTSTART:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=2;BYDAY=TU\n" "RRULE:FREQ=YEARLY;COUNT=1;BYDAY=TH\n" )), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 9, 9, 0)]) def testStrSetDate(self): self.assertEqual(list(rrulestr( "DTSTART:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=1;BYDAY=TU\n" "RDATE:19970904T090000\n" "RDATE:19970909T090000\n" )), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 9, 9, 0)]) def testStrSetExRule(self): self.assertEqual(list(rrulestr( "DTSTART:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=6;BYDAY=TU,TH\n" "EXRULE:FREQ=YEARLY;COUNT=3;BYDAY=TH\n" )), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 16, 9, 0)]) def testStrSetExDate(self): self.assertEqual(list(rrulestr( "DTSTART:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=6;BYDAY=TU,TH\n" "EXDATE:19970904T090000\n" "EXDATE:19970911T090000\n" "EXDATE:19970918T090000\n" )), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 16, 9, 0)]) def testStrSetExDateMultiple(self): rrstr = ("DTSTART:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=6;BYDAY=TU,TH\n" "EXDATE:19970904T090000,19970911T090000,19970918T090000\n") rr = rrulestr(rrstr) assert list(rr) == [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 16, 9, 0)] def testStrSetExDateWithTZID(self): BXL = tz.gettz('Europe/Brussels') rr = rrulestr("DTSTART;TZID=Europe/Brussels:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=6;BYDAY=TU,TH\n" "EXDATE;TZID=Europe/Brussels:19970904T090000\n" "EXDATE;TZID=Europe/Brussels:19970911T090000\n" "EXDATE;TZID=Europe/Brussels:19970918T090000\n") assert list(rr) == [datetime(1997, 9, 2, 9, 0, tzinfo=BXL), datetime(1997, 9, 9, 9, 0, tzinfo=BXL), datetime(1997, 9, 16, 9, 0, tzinfo=BXL)] def testStrSetExDateValueDateTimeNoTZID(self): rrstr = '\n'.join([ "DTSTART:19970902T090000", "RRULE:FREQ=YEARLY;COUNT=4;BYDAY=TU,TH", "EXDATE;VALUE=DATE-TIME:19970902T090000", "EXDATE;VALUE=DATE-TIME:19970909T090000", ]) rr = rrulestr(rrstr) assert list(rr) == [datetime(1997, 9, 4, 9), datetime(1997, 9, 11, 9)] def testStrSetExDateValueMixDateTimeNoTZID(self): rrstr = '\n'.join([ "DTSTART:19970902T090000", "RRULE:FREQ=YEARLY;COUNT=4;BYDAY=TU,TH", "EXDATE;VALUE=DATE-TIME:19970902T090000", "EXDATE:19970909T090000", ]) rr = rrulestr(rrstr) assert list(rr) == [datetime(1997, 9, 4, 9), datetime(1997, 9, 11, 9)] def testStrSetExDateValueDateTimeWithTZID(self): BXL = tz.gettz('Europe/Brussels') rrstr = '\n'.join([ "DTSTART;VALUE=DATE-TIME;TZID=Europe/Brussels:19970902T090000", "RRULE:FREQ=YEARLY;COUNT=4;BYDAY=TU,TH", "EXDATE;VALUE=DATE-TIME;TZID=Europe/Brussels:19970902T090000", "EXDATE;VALUE=DATE-TIME;TZID=Europe/Brussels:19970909T090000", ]) rr = rrulestr(rrstr) assert list(rr) == [datetime(1997, 9, 4, 9, tzinfo=BXL), datetime(1997, 9, 11, 9, tzinfo=BXL)] def testStrSetExDateValueDate(self): rrstr = '\n'.join([ "DTSTART;VALUE=DATE:19970902", "RRULE:FREQ=YEARLY;COUNT=4;BYDAY=TU,TH", "EXDATE;VALUE=DATE:19970902", "EXDATE;VALUE=DATE:19970909", ]) rr = rrulestr(rrstr) assert list(rr) == [datetime(1997, 9, 4), datetime(1997, 9, 11)] def testStrSetDateAndExDate(self): self.assertEqual(list(rrulestr( "DTSTART:19970902T090000\n" "RDATE:19970902T090000\n" "RDATE:19970904T090000\n" "RDATE:19970909T090000\n" "RDATE:19970911T090000\n" "RDATE:19970916T090000\n" "RDATE:19970918T090000\n" "EXDATE:19970904T090000\n" "EXDATE:19970911T090000\n" "EXDATE:19970918T090000\n" )), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 16, 9, 0)]) def testStrSetDateAndExRule(self): self.assertEqual(list(rrulestr( "DTSTART:19970902T090000\n" "RDATE:19970902T090000\n" "RDATE:19970904T090000\n" "RDATE:19970909T090000\n" "RDATE:19970911T090000\n" "RDATE:19970916T090000\n" "RDATE:19970918T090000\n" "EXRULE:FREQ=YEARLY;COUNT=3;BYDAY=TH\n" )), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 16, 9, 0)]) def testStrKeywords(self): self.assertEqual(list(rrulestr( "DTSTART:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=3;INTERVAL=3;" "BYMONTH=3;BYWEEKDAY=TH;BYMONTHDAY=3;" "BYHOUR=3;BYMINUTE=3;BYSECOND=3\n" )), [datetime(2033, 3, 3, 3, 3, 3), datetime(2039, 3, 3, 3, 3, 3), datetime(2072, 3, 3, 3, 3, 3)]) def testStrNWeekDay(self): self.assertEqual(list(rrulestr( "DTSTART:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=3;BYDAY=1TU,-1TH\n" )), [datetime(1997, 12, 25, 9, 0), datetime(1998, 1, 6, 9, 0), datetime(1998, 12, 31, 9, 0)]) def testStrUntil(self): self.assertEqual(list(rrulestr( "DTSTART:19970902T090000\n" "RRULE:FREQ=YEARLY;" "UNTIL=19990101T000000;BYDAY=1TU,-1TH\n" )), [datetime(1997, 12, 25, 9, 0), datetime(1998, 1, 6, 9, 0), datetime(1998, 12, 31, 9, 0)]) def testStrValueDatetime(self): rr = rrulestr("DTSTART;VALUE=DATE-TIME:19970902T090000\n" "RRULE:FREQ=YEARLY;COUNT=2") self.assertEqual(list(rr), [datetime(1997, 9, 2, 9, 0, 0), datetime(1998, 9, 2, 9, 0, 0)]) def testStrValueDate(self): rr = rrulestr("DTSTART;VALUE=DATE:19970902\n" "RRULE:FREQ=YEARLY;COUNT=2") self.assertEqual(list(rr), [datetime(1997, 9, 2, 0, 0, 0), datetime(1998, 9, 2, 0, 0, 0)]) def testStrMultipleDTStartComma(self): with pytest.raises(ValueError): rr = rrulestr("DTSTART:19970101T000000,19970202T000000\n" "RRULE:FREQ=YEARLY;COUNT=1") def testStrInvalidUntil(self): with self.assertRaises(ValueError): list(rrulestr("DTSTART:19970902T090000\n" "RRULE:FREQ=YEARLY;" "UNTIL=TheCowsComeHome;BYDAY=1TU,-1TH\n")) def testStrUntilMustBeUTC(self): with self.assertRaises(ValueError): list(rrulestr("DTSTART;TZID=America/New_York:19970902T090000\n" "RRULE:FREQ=YEARLY;" "UNTIL=19990101T000000;BYDAY=1TU,-1TH\n")) def testStrUntilWithTZ(self): NYC = tz.gettz('America/New_York') rr = list(rrulestr("DTSTART;TZID=America/New_York:19970101T000000\n" "RRULE:FREQ=YEARLY;" "UNTIL=19990101T000000Z\n")) self.assertEqual(list(rr), [datetime(1997, 1, 1, 0, 0, 0, tzinfo=NYC), datetime(1998, 1, 1, 0, 0, 0, tzinfo=NYC)]) def testStrEmptyByDay(self): with self.assertRaises(ValueError): list(rrulestr("DTSTART:19970902T090000\n" "FREQ=WEEKLY;" "BYDAY=;" # This part is invalid "WKST=SU")) def testStrInvalidByDay(self): with self.assertRaises(ValueError): list(rrulestr("DTSTART:19970902T090000\n" "FREQ=WEEKLY;" "BYDAY=-1OK;" # This part is invalid "WKST=SU")) def testBadBySetPos(self): self.assertRaises(ValueError, rrule, MONTHLY, count=1, bysetpos=0, dtstart=datetime(1997, 9, 2, 9, 0)) def testBadBySetPosMany(self): self.assertRaises(ValueError, rrule, MONTHLY, count=1, bysetpos=(-1, 0, 1), dtstart=datetime(1997, 9, 2, 9, 0)) # Tests to ensure that str(rrule) works def testToStrYearly(self): rule = rrule(YEARLY, count=3, dtstart=datetime(1997, 9, 2, 9, 0)) self._rrulestr_reverse_test(rule) def testToStrYearlyInterval(self): rule = rrule(YEARLY, count=3, interval=2, dtstart=datetime(1997, 9, 2, 9, 0)) self._rrulestr_reverse_test(rule) def testToStrYearlyByMonth(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, bymonth=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByMonthDay(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, bymonthday=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByMonthAndMonthDay(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, bymonth=(1, 3), bymonthday=(5, 7), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByWeekDay(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByNWeekDay(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByNWeekDayLarge(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byweekday=(TU(3), TH(-3)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByMonthAndWeekDay(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, bymonth=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByMonthAndNWeekDay(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, bymonth=(1, 3), byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByMonthAndNWeekDayLarge(self): # This is interesting because the TH(-3) ends up before # the TU(3). self._rrulestr_reverse_test(rrule(YEARLY, count=3, bymonth=(1, 3), byweekday=(TU(3), TH(-3)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByMonthDayAndWeekDay(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByMonthAndMonthDayAndWeekDay(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, bymonth=(1, 3), bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByYearDay(self): self._rrulestr_reverse_test(rrule(YEARLY, count=4, byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByYearDayNeg(self): self._rrulestr_reverse_test(rrule(YEARLY, count=4, byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByMonthAndYearDay(self): self._rrulestr_reverse_test(rrule(YEARLY, count=4, bymonth=(4, 7), byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByMonthAndYearDayNeg(self): self._rrulestr_reverse_test(rrule(YEARLY, count=4, bymonth=(4, 7), byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByWeekNo(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byweekno=20, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByWeekNoAndWeekDay(self): # That's a nice one. The first days of week number one # may be in the last year. self._rrulestr_reverse_test(rrule(YEARLY, count=3, byweekno=1, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByWeekNoAndWeekDayLarge(self): # Another nice test. The last days of week number 52/53 # may be in the next year. self._rrulestr_reverse_test(rrule(YEARLY, count=3, byweekno=52, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByWeekNoAndWeekDayLast(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byweekno=-1, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByEaster(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byeaster=0, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByEasterPos(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byeaster=1, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByEasterNeg(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byeaster=-1, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByWeekNoAndWeekDay53(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byweekno=53, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByHour(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byhour=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByMinute(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyBySecond(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByHourAndMinute(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byhour=(6, 18), byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByHourAndSecond(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byhour=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByMinuteAndSecond(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyByHourAndMinuteAndSecond(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, byhour=(6, 18), byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrYearlyBySetPos(self): self._rrulestr_reverse_test(rrule(YEARLY, count=3, bymonthday=15, byhour=(6, 18), bysetpos=(3, -3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthly(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyInterval(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, interval=2, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyIntervalLarge(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, interval=18, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByMonth(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, bymonth=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByMonthDay(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, bymonthday=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByMonthAndMonthDay(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, bymonth=(1, 3), bymonthday=(5, 7), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByWeekDay(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) # Third Monday of the month self.assertEqual(rrule(MONTHLY, byweekday=(MO(+3)), dtstart=datetime(1997, 9, 1)).between(datetime(1997, 9, 1), datetime(1997, 12, 1)), [datetime(1997, 9, 15, 0, 0), datetime(1997, 10, 20, 0, 0), datetime(1997, 11, 17, 0, 0)]) def testToStrMonthlyByNWeekDay(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByNWeekDayLarge(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byweekday=(TU(3), TH(-3)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByMonthAndWeekDay(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, bymonth=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByMonthAndNWeekDay(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, bymonth=(1, 3), byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByMonthAndNWeekDayLarge(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, bymonth=(1, 3), byweekday=(TU(3), TH(-3)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByMonthDayAndWeekDay(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByMonthAndMonthDayAndWeekDay(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, bymonth=(1, 3), bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByYearDay(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=4, byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByYearDayNeg(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=4, byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByMonthAndYearDay(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=4, bymonth=(4, 7), byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByMonthAndYearDayNeg(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=4, bymonth=(4, 7), byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByWeekNo(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byweekno=20, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByWeekNoAndWeekDay(self): # That's a nice one. The first days of week number one # may be in the last year. self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byweekno=1, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByWeekNoAndWeekDayLarge(self): # Another nice test. The last days of week number 52/53 # may be in the next year. self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byweekno=52, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByWeekNoAndWeekDayLast(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byweekno=-1, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByWeekNoAndWeekDay53(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byweekno=53, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByEaster(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byeaster=0, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByEasterPos(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byeaster=1, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByEasterNeg(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byeaster=-1, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByHour(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byhour=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByMinute(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyBySecond(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByHourAndMinute(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byhour=(6, 18), byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByHourAndSecond(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byhour=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByMinuteAndSecond(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyByHourAndMinuteAndSecond(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, byhour=(6, 18), byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMonthlyBySetPos(self): self._rrulestr_reverse_test(rrule(MONTHLY, count=3, bymonthday=(13, 17), byhour=(6, 18), bysetpos=(3, -3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeekly(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyInterval(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, interval=2, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyIntervalLarge(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, interval=20, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByMonth(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, bymonth=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByMonthDay(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, bymonthday=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByMonthAndMonthDay(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, bymonth=(1, 3), bymonthday=(5, 7), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByWeekDay(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByNWeekDay(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByMonthAndWeekDay(self): # This test is interesting, because it crosses the year # boundary in a weekly period to find day '1' as a # valid recurrence. self._rrulestr_reverse_test(rrule(WEEKLY, count=3, bymonth=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByMonthAndNWeekDay(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, bymonth=(1, 3), byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByMonthDayAndWeekDay(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByMonthAndMonthDayAndWeekDay(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, bymonth=(1, 3), bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByYearDay(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=4, byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByYearDayNeg(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=4, byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByMonthAndYearDay(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=4, bymonth=(1, 7), byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByMonthAndYearDayNeg(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=4, bymonth=(1, 7), byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByWeekNo(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byweekno=20, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByWeekNoAndWeekDay(self): # That's a nice one. The first days of week number one # may be in the last year. self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byweekno=1, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByWeekNoAndWeekDayLarge(self): # Another nice test. The last days of week number 52/53 # may be in the next year. self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byweekno=52, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByWeekNoAndWeekDayLast(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byweekno=-1, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByWeekNoAndWeekDay53(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byweekno=53, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByEaster(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byeaster=0, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByEasterPos(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byeaster=1, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByEasterNeg(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byeaster=-1, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByHour(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byhour=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByMinute(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyBySecond(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByHourAndMinute(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byhour=(6, 18), byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByHourAndSecond(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byhour=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByMinuteAndSecond(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyByHourAndMinuteAndSecond(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byhour=(6, 18), byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrWeeklyBySetPos(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, byweekday=(TU, TH), byhour=(6, 18), bysetpos=(3, -3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDaily(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyInterval(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, interval=2, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyIntervalLarge(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, interval=92, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByMonth(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, bymonth=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByMonthDay(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, bymonthday=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByMonthAndMonthDay(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, bymonth=(1, 3), bymonthday=(5, 7), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByWeekDay(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByNWeekDay(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByMonthAndWeekDay(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, bymonth=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByMonthAndNWeekDay(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, bymonth=(1, 3), byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByMonthDayAndWeekDay(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByMonthAndMonthDayAndWeekDay(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, bymonth=(1, 3), bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByYearDay(self): self._rrulestr_reverse_test(rrule(DAILY, count=4, byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByYearDayNeg(self): self._rrulestr_reverse_test(rrule(DAILY, count=4, byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByMonthAndYearDay(self): self._rrulestr_reverse_test(rrule(DAILY, count=4, bymonth=(1, 7), byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByMonthAndYearDayNeg(self): self._rrulestr_reverse_test(rrule(DAILY, count=4, bymonth=(1, 7), byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByWeekNo(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byweekno=20, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByWeekNoAndWeekDay(self): # That's a nice one. The first days of week number one # may be in the last year. self._rrulestr_reverse_test(rrule(DAILY, count=3, byweekno=1, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByWeekNoAndWeekDayLarge(self): # Another nice test. The last days of week number 52/53 # may be in the next year. self._rrulestr_reverse_test(rrule(DAILY, count=3, byweekno=52, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByWeekNoAndWeekDayLast(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byweekno=-1, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByWeekNoAndWeekDay53(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byweekno=53, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByEaster(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byeaster=0, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByEasterPos(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byeaster=1, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByEasterNeg(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byeaster=-1, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByHour(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byhour=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByMinute(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyBySecond(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByHourAndMinute(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byhour=(6, 18), byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByHourAndSecond(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byhour=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByMinuteAndSecond(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyByHourAndMinuteAndSecond(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byhour=(6, 18), byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrDailyBySetPos(self): self._rrulestr_reverse_test(rrule(DAILY, count=3, byhour=(6, 18), byminute=(15, 45), bysetpos=(3, -3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourly(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyInterval(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, interval=2, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyIntervalLarge(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, interval=769, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByMonth(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, bymonth=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByMonthDay(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, bymonthday=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByMonthAndMonthDay(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, bymonth=(1, 3), bymonthday=(5, 7), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByWeekDay(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByNWeekDay(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByMonthAndWeekDay(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, bymonth=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByMonthAndNWeekDay(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, bymonth=(1, 3), byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByMonthDayAndWeekDay(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByMonthAndMonthDayAndWeekDay(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, bymonth=(1, 3), bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByYearDay(self): self._rrulestr_reverse_test(rrule(HOURLY, count=4, byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByYearDayNeg(self): self._rrulestr_reverse_test(rrule(HOURLY, count=4, byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByMonthAndYearDay(self): self._rrulestr_reverse_test(rrule(HOURLY, count=4, bymonth=(4, 7), byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByMonthAndYearDayNeg(self): self._rrulestr_reverse_test(rrule(HOURLY, count=4, bymonth=(4, 7), byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByWeekNo(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byweekno=20, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByWeekNoAndWeekDay(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byweekno=1, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByWeekNoAndWeekDayLarge(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byweekno=52, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByWeekNoAndWeekDayLast(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byweekno=-1, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByWeekNoAndWeekDay53(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byweekno=53, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByEaster(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byeaster=0, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByEasterPos(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byeaster=1, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByEasterNeg(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byeaster=-1, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByHour(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byhour=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByMinute(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyBySecond(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByHourAndMinute(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byhour=(6, 18), byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByHourAndSecond(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byhour=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByMinuteAndSecond(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyByHourAndMinuteAndSecond(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byhour=(6, 18), byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrHourlyBySetPos(self): self._rrulestr_reverse_test(rrule(HOURLY, count=3, byminute=(15, 45), bysecond=(15, 45), bysetpos=(3, -3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutely(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyInterval(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, interval=2, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyIntervalLarge(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, interval=1501, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByMonth(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, bymonth=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByMonthDay(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, bymonthday=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByMonthAndMonthDay(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, bymonth=(1, 3), bymonthday=(5, 7), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByWeekDay(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByNWeekDay(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByMonthAndWeekDay(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, bymonth=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByMonthAndNWeekDay(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, bymonth=(1, 3), byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByMonthDayAndWeekDay(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByMonthAndMonthDayAndWeekDay(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, bymonth=(1, 3), bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByYearDay(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=4, byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByYearDayNeg(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=4, byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByMonthAndYearDay(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=4, bymonth=(4, 7), byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByMonthAndYearDayNeg(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=4, bymonth=(4, 7), byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByWeekNo(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byweekno=20, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByWeekNoAndWeekDay(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byweekno=1, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByWeekNoAndWeekDayLarge(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byweekno=52, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByWeekNoAndWeekDayLast(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byweekno=-1, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByWeekNoAndWeekDay53(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byweekno=53, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByEaster(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byeaster=0, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByEasterPos(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byeaster=1, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByEasterNeg(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byeaster=-1, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByHour(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byhour=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByMinute(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyBySecond(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByHourAndMinute(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byhour=(6, 18), byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByHourAndSecond(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byhour=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByMinuteAndSecond(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyByHourAndMinuteAndSecond(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, byhour=(6, 18), byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrMinutelyBySetPos(self): self._rrulestr_reverse_test(rrule(MINUTELY, count=3, bysecond=(15, 30, 45), bysetpos=(3, -3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondly(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyInterval(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, interval=2, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyIntervalLarge(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, interval=90061, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByMonth(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, bymonth=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByMonthDay(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, bymonthday=(1, 3), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByMonthAndMonthDay(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, bymonth=(1, 3), bymonthday=(5, 7), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByWeekDay(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByNWeekDay(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByMonthAndWeekDay(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, bymonth=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByMonthAndNWeekDay(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, bymonth=(1, 3), byweekday=(TU(1), TH(-1)), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByMonthDayAndWeekDay(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByMonthAndMonthDayAndWeekDay(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, bymonth=(1, 3), bymonthday=(1, 3), byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByYearDay(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=4, byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByYearDayNeg(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=4, byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByMonthAndYearDay(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=4, bymonth=(4, 7), byyearday=(1, 100, 200, 365), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByMonthAndYearDayNeg(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=4, bymonth=(4, 7), byyearday=(-365, -266, -166, -1), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByWeekNo(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byweekno=20, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByWeekNoAndWeekDay(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byweekno=1, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByWeekNoAndWeekDayLarge(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byweekno=52, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByWeekNoAndWeekDayLast(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byweekno=-1, byweekday=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByWeekNoAndWeekDay53(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byweekno=53, byweekday=MO, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByEaster(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byeaster=0, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByEasterPos(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byeaster=1, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByEasterNeg(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byeaster=-1, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByHour(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byhour=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByMinute(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyBySecond(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByHourAndMinute(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byhour=(6, 18), byminute=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByHourAndSecond(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byhour=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByMinuteAndSecond(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByHourAndMinuteAndSecond(self): self._rrulestr_reverse_test(rrule(SECONDLY, count=3, byhour=(6, 18), byminute=(6, 18), bysecond=(6, 18), dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrSecondlyByHourAndMinuteAndSecondBug(self): # This explores a bug found by Mathieu Bridon. self._rrulestr_reverse_test(rrule(SECONDLY, count=3, bysecond=(0,), byminute=(1,), dtstart=datetime(2010, 3, 22, 12, 1))) def testToStrWithWkSt(self): self._rrulestr_reverse_test(rrule(WEEKLY, count=3, wkst=SU, dtstart=datetime(1997, 9, 2, 9, 0))) def testToStrLongIntegers(self): if PY2: # There are no longs in python3 self._rrulestr_reverse_test(rrule(MINUTELY, count=long(2), interval=long(2), bymonth=long(2), byweekday=long(3), byhour=long(6), byminute=long(6), bysecond=long(6), dtstart=datetime(1997, 9, 2, 9, 0))) self._rrulestr_reverse_test(rrule(YEARLY, count=long(2), bymonthday=long(5), byweekno=long(2), dtstart=datetime(1997, 9, 2, 9, 0))) def testReplaceIfSet(self): rr = rrule(YEARLY, count=1, bymonthday=5, dtstart=datetime(1997, 1, 1)) newrr = rr.replace(bymonthday=6) self.assertEqual(list(rr), [datetime(1997, 1, 5)]) self.assertEqual(list(newrr), [datetime(1997, 1, 6)]) def testReplaceIfNotSet(self): rr = rrule(YEARLY, count=1, dtstart=datetime(1997, 1, 1)) newrr = rr.replace(bymonthday=6) self.assertEqual(list(rr), [datetime(1997, 1, 1)]) self.assertEqual(list(newrr), [datetime(1997, 1, 6)]) @pytest.mark.rrule @freeze_time(datetime(2018, 3, 6, 5, 36, tzinfo=tz.UTC)) def test_generated_aware_dtstart(): dtstart_exp = datetime(2018, 3, 6, 5, 36, tzinfo=tz.UTC) UNTIL = datetime(2018, 3, 6, 8, 0, tzinfo=tz.UTC) rule_without_dtstart = rrule(freq=HOURLY, until=UNTIL) rule_with_dtstart = rrule(freq=HOURLY, dtstart=dtstart_exp, until=UNTIL) assert list(rule_without_dtstart) == list(rule_with_dtstart) @pytest.mark.rrule @pytest.mark.rrulestr @pytest.mark.xfail(reason="rrulestr loses time zone, gh issue #637") @freeze_time(datetime(2018, 3, 6, 5, 36, tzinfo=tz.UTC)) def test_generated_aware_dtstart_rrulestr(): rrule_without_dtstart = rrule(freq=HOURLY, until=datetime(2018, 3, 6, 8, 0, tzinfo=tz.UTC)) rrule_r = rrulestr(str(rrule_without_dtstart)) assert list(rrule_r) == list(rrule_without_dtstart) @pytest.mark.rruleset class RRuleSetTest(unittest.TestCase): def testSet(self): rrset = rruleset() rrset.rrule(rrule(YEARLY, count=2, byweekday=TU, dtstart=datetime(1997, 9, 2, 9, 0))) rrset.rrule(rrule(YEARLY, count=1, byweekday=TH, dtstart=datetime(1997, 9, 2, 9, 0))) self.assertEqual(list(rrset), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 9, 9, 0)]) def testSetDate(self): rrset = rruleset() rrset.rrule(rrule(YEARLY, count=1, byweekday=TU, dtstart=datetime(1997, 9, 2, 9, 0))) rrset.rdate(datetime(1997, 9, 4, 9)) rrset.rdate(datetime(1997, 9, 9, 9)) self.assertEqual(list(rrset), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 9, 9, 0)]) def testSetExRule(self): rrset = rruleset() rrset.rrule(rrule(YEARLY, count=6, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) rrset.exrule(rrule(YEARLY, count=3, byweekday=TH, dtstart=datetime(1997, 9, 2, 9, 0))) self.assertEqual(list(rrset), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 16, 9, 0)]) def testSetExDate(self): rrset = rruleset() rrset.rrule(rrule(YEARLY, count=6, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) rrset.exdate(datetime(1997, 9, 4, 9)) rrset.exdate(datetime(1997, 9, 11, 9)) rrset.exdate(datetime(1997, 9, 18, 9)) self.assertEqual(list(rrset), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 16, 9, 0)]) def testSetExDateRevOrder(self): rrset = rruleset() rrset.rrule(rrule(MONTHLY, count=5, bymonthday=10, dtstart=datetime(2004, 1, 1, 9, 0))) rrset.exdate(datetime(2004, 4, 10, 9, 0)) rrset.exdate(datetime(2004, 2, 10, 9, 0)) self.assertEqual(list(rrset), [datetime(2004, 1, 10, 9, 0), datetime(2004, 3, 10, 9, 0), datetime(2004, 5, 10, 9, 0)]) def testSetDateAndExDate(self): rrset = rruleset() rrset.rdate(datetime(1997, 9, 2, 9)) rrset.rdate(datetime(1997, 9, 4, 9)) rrset.rdate(datetime(1997, 9, 9, 9)) rrset.rdate(datetime(1997, 9, 11, 9)) rrset.rdate(datetime(1997, 9, 16, 9)) rrset.rdate(datetime(1997, 9, 18, 9)) rrset.exdate(datetime(1997, 9, 4, 9)) rrset.exdate(datetime(1997, 9, 11, 9)) rrset.exdate(datetime(1997, 9, 18, 9)) self.assertEqual(list(rrset), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 16, 9, 0)]) def testSetDateAndExRule(self): rrset = rruleset() rrset.rdate(datetime(1997, 9, 2, 9)) rrset.rdate(datetime(1997, 9, 4, 9)) rrset.rdate(datetime(1997, 9, 9, 9)) rrset.rdate(datetime(1997, 9, 11, 9)) rrset.rdate(datetime(1997, 9, 16, 9)) rrset.rdate(datetime(1997, 9, 18, 9)) rrset.exrule(rrule(YEARLY, count=3, byweekday=TH, dtstart=datetime(1997, 9, 2, 9, 0))) self.assertEqual(list(rrset), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 9, 9, 0), datetime(1997, 9, 16, 9, 0)]) def testSetCount(self): rrset = rruleset() rrset.rrule(rrule(YEARLY, count=6, byweekday=(TU, TH), dtstart=datetime(1997, 9, 2, 9, 0))) rrset.exrule(rrule(YEARLY, count=3, byweekday=TH, dtstart=datetime(1997, 9, 2, 9, 0))) self.assertEqual(rrset.count(), 3) def testSetCachePre(self): rrset = rruleset() rrset.rrule(rrule(YEARLY, count=2, byweekday=TU, dtstart=datetime(1997, 9, 2, 9, 0))) rrset.rrule(rrule(YEARLY, count=1, byweekday=TH, dtstart=datetime(1997, 9, 2, 9, 0))) self.assertEqual(list(rrset), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 9, 9, 0)]) def testSetCachePost(self): rrset = rruleset(cache=True) rrset.rrule(rrule(YEARLY, count=2, byweekday=TU, dtstart=datetime(1997, 9, 2, 9, 0))) rrset.rrule(rrule(YEARLY, count=1, byweekday=TH, dtstart=datetime(1997, 9, 2, 9, 0))) for x in rrset: pass self.assertEqual(list(rrset), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 9, 9, 0)]) def testSetCachePostInternal(self): rrset = rruleset(cache=True) rrset.rrule(rrule(YEARLY, count=2, byweekday=TU, dtstart=datetime(1997, 9, 2, 9, 0))) rrset.rrule(rrule(YEARLY, count=1, byweekday=TH, dtstart=datetime(1997, 9, 2, 9, 0))) for x in rrset: pass self.assertEqual(list(rrset._cache), [datetime(1997, 9, 2, 9, 0), datetime(1997, 9, 4, 9, 0), datetime(1997, 9, 9, 9, 0)]) def testSetRRuleCount(self): # Test that the count is updated when an rrule is added rrset = rruleset(cache=False) for cache in (True, False): rrset = rruleset(cache=cache) rrset.rrule(rrule(YEARLY, count=2, byweekday=TH, dtstart=datetime(1983, 4, 1))) rrset.rrule(rrule(WEEKLY, count=4, byweekday=FR, dtstart=datetime(1991, 6, 3))) # Check the length twice - first one sets a cache, second reads it self.assertEqual(rrset.count(), 6) self.assertEqual(rrset.count(), 6) # This should invalidate the cache and force an update rrset.rrule(rrule(MONTHLY, count=3, dtstart=datetime(1994, 1, 3))) self.assertEqual(rrset.count(), 9) self.assertEqual(rrset.count(), 9) def testSetRDateCount(self): # Test that the count is updated when an rdate is added rrset = rruleset(cache=False) for cache in (True, False): rrset = rruleset(cache=cache) rrset.rrule(rrule(YEARLY, count=2, byweekday=TH, dtstart=datetime(1983, 4, 1))) rrset.rrule(rrule(WEEKLY, count=4, byweekday=FR, dtstart=datetime(1991, 6, 3))) # Check the length twice - first one sets a cache, second reads it self.assertEqual(rrset.count(), 6) self.assertEqual(rrset.count(), 6) # This should invalidate the cache and force an update rrset.rdate(datetime(1993, 2, 14)) self.assertEqual(rrset.count(), 7) self.assertEqual(rrset.count(), 7) def testSetExRuleCount(self): # Test that the count is updated when an exrule is added rrset = rruleset(cache=False) for cache in (True, False): rrset = rruleset(cache=cache) rrset.rrule(rrule(YEARLY, count=2, byweekday=TH, dtstart=datetime(1983, 4, 1))) rrset.rrule(rrule(WEEKLY, count=4, byweekday=FR, dtstart=datetime(1991, 6, 3))) # Check the length twice - first one sets a cache, second reads it self.assertEqual(rrset.count(), 6) self.assertEqual(rrset.count(), 6) # This should invalidate the cache and force an update rrset.exrule(rrule(WEEKLY, count=2, interval=2, dtstart=datetime(1991, 6, 14))) self.assertEqual(rrset.count(), 4) self.assertEqual(rrset.count(), 4) def testSetExDateCount(self): # Test that the count is updated when an rdate is added for cache in (True, False): rrset = rruleset(cache=cache) rrset.rrule(rrule(YEARLY, count=2, byweekday=TH, dtstart=datetime(1983, 4, 1))) rrset.rrule(rrule(WEEKLY, count=4, byweekday=FR, dtstart=datetime(1991, 6, 3))) # Check the length twice - first one sets a cache, second reads it self.assertEqual(rrset.count(), 6) self.assertEqual(rrset.count(), 6) # This should invalidate the cache and force an update rrset.exdate(datetime(1991, 6, 28)) self.assertEqual(rrset.count(), 5) self.assertEqual(rrset.count(), 5) class WeekdayTest(unittest.TestCase): def testInvalidNthWeekday(self): with self.assertRaises(ValueError): FR(0) def testWeekdayCallable(self): # Calling a weekday instance generates a new weekday instance with the # value of n changed. from dateutil.rrule import weekday self.assertEqual(MO(1), weekday(0, 1)) # Calling a weekday instance with the identical n returns the original # object FR_3 = weekday(4, 3) self.assertIs(FR_3(3), FR_3) def testWeekdayEquality(self): # Two weekday objects are not equal if they have different values for n self.assertNotEqual(TH, TH(-1)) self.assertNotEqual(SA(3), SA(2)) def testWeekdayEqualitySubclass(self): # Two weekday objects equal if their "weekday" and "n" attributes are # available and the same class BasicWeekday(object): def __init__(self, weekday): self.weekday = weekday class BasicNWeekday(BasicWeekday): def __init__(self, weekday, n=None): super(BasicNWeekday, self).__init__(weekday) self.n = n MO_Basic = BasicWeekday(0) self.assertNotEqual(MO, MO_Basic) self.assertNotEqual(MO(1), MO_Basic) TU_BasicN = BasicNWeekday(1) self.assertEqual(TU, TU_BasicN) self.assertNotEqual(TU(3), TU_BasicN) WE_Basic3 = BasicNWeekday(2, 3) self.assertEqual(WE(3), WE_Basic3) self.assertNotEqual(WE(2), WE_Basic3) def testWeekdayReprNoN(self): no_n_reprs = ('MO', 'TU', 'WE', 'TH', 'FR', 'SA', 'SU') no_n_wdays = (MO, TU, WE, TH, FR, SA, SU) for repstr, wday in zip(no_n_reprs, no_n_wdays): self.assertEqual(repr(wday), repstr) def testWeekdayReprWithN(self): with_n_reprs = ('WE(+1)', 'TH(-2)', 'SU(+3)') with_n_wdays = (WE(1), TH(-2), SU(+3)) for repstr, wday in zip(with_n_reprs, with_n_wdays): self.assertEqual(repr(wday), repstr) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/test_tz.py0000644000175100001710000030410400000000000021057 0ustar00runnerdocker# -*- coding: utf-8 -*- from __future__ import unicode_literals from ._common import PicklableMixin from ._common import TZEnvContext, TZWinContext from ._common import ComparesEqual from datetime import datetime, timedelta from datetime import time as dt_time from datetime import tzinfo from six import PY2 from io import BytesIO, StringIO import unittest import sys import base64 import copy import gc import weakref from functools import partial IS_WIN = sys.platform.startswith('win') import pytest # dateutil imports from dateutil.relativedelta import relativedelta, SU, TH from dateutil.parser import parse from dateutil import tz as tz from dateutil import zoneinfo try: from dateutil import tzwin except ImportError as e: if IS_WIN: raise e else: pass MISSING_TARBALL = ("This test fails if you don't have the dateutil " "timezone file installed. Please read the README") TZFILE_EST5EDT = b""" VFppZgAAAAAAAAAAAAAAAAAAAAAAAAAEAAAABAAAAAAAAADrAAAABAAAABCeph5wn7rrYKCGAHCh ms1gomXicKOD6eCkaq5wpTWnYKZTyvCnFYlgqDOs8Kj+peCqE47wqt6H4KvzcPCsvmngrdNS8K6e S+CvszTwsH4t4LGcUXCyZ0pgs3wzcLRHLGC1XBVwticOYLc793C4BvBguRvZcLnm0mC7BPXwu8a0 YLzk1/C9r9DgvsS58L+PsuDApJvwwW+U4MKEffDDT3bgxGRf8MUvWODGTXxwxw864MgtXnDI+Fdg yg1AcMrYOWDLiPBw0iP0cNJg++DTdeTw1EDd4NVVxvDWIL/g1zWo8NgAoeDZFYrw2eCD4Nr+p3Db wGXg3N6JcN2pgmDevmtw34lkYOCeTXDhaUZg4n4vcONJKGDkXhFw5Vcu4OZHLfDnNxDg6CcP8OkW 8uDqBvHw6vbU4Ovm0/Ds1rbg7ca18O6/02Dvr9Jw8J+1YPGPtHDyf5dg82+WcPRfeWD1T3hw9j9b YPcvWnD4KHfg+Q88cPoIWeD6+Fjw++g74PzYOvD9yB3g/rgc8P+n/+AAl/7wAYfh4AJ34PADcP5g BGD9cAVQ4GAGQN9wBzDCYAeNGXAJEKRgCa2U8ArwhmAL4IVwDNmi4A3AZ3AOuYTgD6mD8BCZZuAR iWXwEnlI4BNpR/AUWSrgFUkp8BY5DOAXKQvwGCIpYBkI7fAaAgtgGvIKcBvh7WAc0exwHcHPYB6x znAfobFgIHYA8CGBk2AiVeLwI2qv4CQ1xPAlSpHgJhWm8Ccqc+An/sNwKQpV4CnepXAq6jfgK76H cCzTVGAtnmlwLrM2YC9+S3AwkxhgMWdn8DJy+mAzR0nwNFLcYDUnK/A2Mr5gNwcN8Dgb2uA45u/w Ofu84DrG0fA7257gPK/ucD27gOA+j9BwP5ti4EBvsnBBhH9gQk+UcENkYWBEL3ZwRURDYEYPWHBH JCVgR/h08EkEB2BJ2FbwSuPpYEu4OPBMzQXgTZga8E6s5+BPd/zwUIzJ4FFhGXBSbKvgU0D7cFRM jeBVIN1wVixv4FcAv3BYFYxgWOChcFn1bmBawINwW9VQYFypn/BdtTJgXomB8F+VFGBgaWPwYX4w 4GJJRfBjXhLgZCkn8GU99OBmEkRwZx3W4GfyJnBo/bjgadIIcGrdmuBrsepwbMa3YG2RzHBupplg b3GucHCGe2BxWsrwcmZdYHM6rPB0Rj9gdRqO8HYvW+B2+nDweA894HjaUvB57x/gero08HvPAeB8 o1Fwfa7j4H6DM3B/jsXgAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQAB AAEAAQABAgMBAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQAB AAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEA AQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQAB AAEAAQABAAEAAQABAAEAAQABAAEAAf//x8ABAP//ubAABP//x8ABCP//x8ABDEVEVABFU1QARVdU AEVQVAAAAAABAAAAAQ== """ EUROPE_HELSINKI = b""" VFppZgAAAAAAAAAAAAAAAAAAAAAAAAAFAAAABQAAAAAAAAB1AAAABQAAAA2kc28Yy85RYMy/hdAV I+uQFhPckBcDzZAX876QGOOvkBnToJAaw5GQG7y9EBysrhAdnJ8QHoyQEB98gRAgbHIQIVxjECJM VBAjPEUQJCw2ECUcJxAmDBgQJwVDkCf1NJAo5SWQKdUWkCrFB5ArtPiQLKTpkC2U2pAuhMuQL3S8 kDBkrZAxXdkQMnK0EDM9uxA0UpYQNR2dEDYyeBA2/X8QOBuUkDjdYRA5+3aQOr1DEDvbWJA8pl+Q Pbs6kD6GQZA/mxyQQGYjkEGEORBCRgWQQ2QbEEQl55BFQ/0QRgXJkEcj3xBH7uYQSQPBEEnOyBBK 46MQS66qEEzMv5BNjowQTqyhkE9ubhBQjIOQUVeKkFJsZZBTN2yQVExHkFUXTpBWLCmQVvcwkFgV RhBY1xKQWfUoEFq29JBb1QoQXKAREF207BBef/MQX5TOEGBf1RBhfeqQYj+3EGNdzJBkH5kQZT2u kGYItZBnHZCQZ+iXkGj9cpBpyHmQat1UkGuoW5BsxnEQbYg9kG6mUxBvaB+QcIY1EHFRPBByZhcQ czEeEHRF+RB1EQAQdi8VkHbw4hB4DveQeNDEEHnu2ZB6sKYQe867kHyZwpB9rp2QfnmkkH+Of5AC AQIDBAMEAwQDBAMEAwQDBAMEAwQDBAMEAwQDBAMEAwQDBAMEAwQDBAMEAwQDBAMEAwQDBAMEAwQD BAMEAwQDBAMEAwQDBAMEAwQDBAMEAwQDBAMEAwQDBAMEAwQDBAMEAwQDBAMEAwQDBAMEAwQDBAME AwQAABdoAAAAACowAQQAABwgAAkAACowAQQAABwgAAlITVQARUVTVABFRVQAAAAAAQEAAAABAQ== """ NEW_YORK = b""" VFppZgAAAAAAAAAAAAAAAAAAAAAAAAAEAAAABAAAABcAAADrAAAABAAAABCeph5wn7rrYKCGAHCh ms1gomXicKOD6eCkaq5wpTWnYKZTyvCnFYlgqDOs8Kj+peCqE47wqt6H4KvzcPCsvmngrdNS8K6e S+CvszTwsH4t4LGcUXCyZ0pgs3wzcLRHLGC1XBVwticOYLc793C4BvBguRvZcLnm0mC7BPXwu8a0 YLzk1/C9r9DgvsS58L+PsuDApJvwwW+U4MKEffDDT3bgxGRf8MUvWODGTXxwxw864MgtXnDI+Fdg yg1AcMrYOWDLiPBw0iP0cNJg++DTdeTw1EDd4NVVxvDWIL/g1zWo8NgAoeDZFYrw2eCD4Nr+p3Db wGXg3N6JcN2pgmDevmtw34lkYOCeTXDhaUZg4n4vcONJKGDkXhFw5Vcu4OZHLfDnNxDg6CcP8OkW 8uDqBvHw6vbU4Ovm0/Ds1rbg7ca18O6/02Dvr9Jw8J+1YPGPtHDyf5dg82+WcPRfeWD1T3hw9j9b YPcvWnD4KHfg+Q88cPoIWeD6+Fjw++g74PzYOvD9yB3g/rgc8P+n/+AAl/7wAYfh4AJ34PADcP5g BGD9cAVQ4GEGQN9yBzDCYgeNGXMJEKRjCa2U9ArwhmQL4IV1DNmi5Q3AZ3YOuYTmD6mD9xCZZucR iWX4EnlI6BNpR/kUWSrpFUkp+RY5DOoXKQv6GCIpaxkI7fsaAgtsGvIKfBvh7Wwc0ex8HcHPbR6x zn0fobFtIHYA/SGBk20iVeL+I2qv7iQ1xP4lSpHuJhWm/ycqc+8n/sOAKQpV8CnepYAq6jfxK76H gSzTVHItnmmCLrM2cy9+S4MwkxhzMWdoBDJy+nQzR0oENFLcdTUnLAU2Mr51NwcOBjgb2vY45vAG Ofu89jrG0gY72572PK/uhj27gPY+j9CGP5ti9kBvsoZBhH92Qk+UhkNkYXZEL3aHRURDd0XzqQdH LV/3R9OLB0kNQfdJs20HSu0j90uciYdM1kB3TXxrh062IndPXE2HUJYEd1E8L4dSdeZ3UxwRh1RV yHdU+/OHVjWqd1blEAdYHsb3WMTyB1n+qPdapNQHW96K91yEtgddvmz3XmSYB1+eTvdgTbSHYYdr d2ItlodjZ013ZA14h2VHL3dl7VqHZycRd2fNPIdpBvN3aa0eh2rm1XdrljsHbM/x9212HQdur9P3 b1X/B3CPtfdxNeEHcm+X93MVwwd0T3n3dP7fh3Y4lnd23sGHeBh4d3i+o4d5+Fp3ep6Fh3vYPHd8 fmeHfbged35eSYd/mAB3AAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQAB AAEAAQABAgMBAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQAB AAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEA AQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQABAAEAAQAB AAEAAQABAAEAAQABAAEAAQABAAEAAf//x8ABAP//ubAABP//x8ABCP//x8ABDEVEVABFU1QARVdU AEVQVAAEslgAAAAAAQWk7AEAAAACB4YfggAAAAMJZ1MDAAAABAtIhoQAAAAFDSsLhQAAAAYPDD8G AAAABxDtcocAAAAIEs6mCAAAAAkVn8qJAAAACheA/goAAAALGWIxiwAAAAwdJeoMAAAADSHa5Q0A AAAOJZ6djgAAAA8nf9EPAAAAECpQ9ZAAAAARLDIpEQAAABIuE1ySAAAAEzDnJBMAAAAUM7hIlAAA ABU2jBAVAAAAFkO3G5YAAAAXAAAAAQAAAAE= """ TZICAL_EST5EDT = """ BEGIN:VTIMEZONE TZID:US-Eastern LAST-MODIFIED:19870101T000000Z TZURL:http://zones.stds_r_us.net/tz/US-Eastern BEGIN:STANDARD DTSTART:19671029T020000 RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=10 TZOFFSETFROM:-0400 TZOFFSETTO:-0500 TZNAME:EST END:STANDARD BEGIN:DAYLIGHT DTSTART:19870405T020000 RRULE:FREQ=YEARLY;BYDAY=1SU;BYMONTH=4 TZOFFSETFROM:-0500 TZOFFSETTO:-0400 TZNAME:EDT END:DAYLIGHT END:VTIMEZONE """ TZICAL_PST8PDT = """ BEGIN:VTIMEZONE TZID:US-Pacific LAST-MODIFIED:19870101T000000Z BEGIN:STANDARD DTSTART:19671029T020000 RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=10 TZOFFSETFROM:-0700 TZOFFSETTO:-0800 TZNAME:PST END:STANDARD BEGIN:DAYLIGHT DTSTART:19870405T020000 RRULE:FREQ=YEARLY;BYDAY=1SU;BYMONTH=4 TZOFFSETFROM:-0800 TZOFFSETTO:-0700 TZNAME:PDT END:DAYLIGHT END:VTIMEZONE """ EST_TUPLE = ('EST', timedelta(hours=-5), timedelta(hours=0)) EDT_TUPLE = ('EDT', timedelta(hours=-4), timedelta(hours=1)) SUPPORTS_SUB_MINUTE_OFFSETS = sys.version_info >= (3, 6) ### # Helper functions def get_timezone_tuple(dt): """Retrieve a (tzname, utcoffset, dst) tuple for a given DST""" return dt.tzname(), dt.utcoffset(), dt.dst() ### # Mix-ins class context_passthrough(object): def __init__(*args, **kwargs): pass def __enter__(*args, **kwargs): pass def __exit__(*args, **kwargs): pass class TzFoldMixin(object): """ Mix-in class for testing ambiguous times """ def gettz(self, tzname): raise NotImplementedError def _get_tzname(self, tzname): return tzname def _gettz_context(self, tzname): return context_passthrough() def testFoldPositiveUTCOffset(self): # Test that we can resolve ambiguous times tzname = self._get_tzname('Australia/Sydney') with self._gettz_context(tzname): SYD = self.gettz(tzname) t0_u = datetime(2012, 3, 31, 15, 30, tzinfo=tz.UTC) # AEST t1_u = datetime(2012, 3, 31, 16, 30, tzinfo=tz.UTC) # AEDT t0_syd0 = t0_u.astimezone(SYD) t1_syd1 = t1_u.astimezone(SYD) self.assertEqual(t0_syd0.replace(tzinfo=None), datetime(2012, 4, 1, 2, 30)) self.assertEqual(t1_syd1.replace(tzinfo=None), datetime(2012, 4, 1, 2, 30)) self.assertEqual(t0_syd0.utcoffset(), timedelta(hours=11)) self.assertEqual(t1_syd1.utcoffset(), timedelta(hours=10)) def testGapPositiveUTCOffset(self): # Test that we don't have a problem around gaps. tzname = self._get_tzname('Australia/Sydney') with self._gettz_context(tzname): SYD = self.gettz(tzname) t0_u = datetime(2012, 10, 6, 15, 30, tzinfo=tz.UTC) # AEST t1_u = datetime(2012, 10, 6, 16, 30, tzinfo=tz.UTC) # AEDT t0 = t0_u.astimezone(SYD) t1 = t1_u.astimezone(SYD) self.assertEqual(t0.replace(tzinfo=None), datetime(2012, 10, 7, 1, 30)) self.assertEqual(t1.replace(tzinfo=None), datetime(2012, 10, 7, 3, 30)) self.assertEqual(t0.utcoffset(), timedelta(hours=10)) self.assertEqual(t1.utcoffset(), timedelta(hours=11)) def testFoldNegativeUTCOffset(self): # Test that we can resolve ambiguous times tzname = self._get_tzname('America/Toronto') with self._gettz_context(tzname): TOR = self.gettz(tzname) t0_u = datetime(2011, 11, 6, 5, 30, tzinfo=tz.UTC) t1_u = datetime(2011, 11, 6, 6, 30, tzinfo=tz.UTC) t0_tor = t0_u.astimezone(TOR) t1_tor = t1_u.astimezone(TOR) self.assertEqual(t0_tor.replace(tzinfo=None), datetime(2011, 11, 6, 1, 30)) self.assertEqual(t1_tor.replace(tzinfo=None), datetime(2011, 11, 6, 1, 30)) self.assertNotEqual(t0_tor.tzname(), t1_tor.tzname()) self.assertEqual(t0_tor.utcoffset(), timedelta(hours=-4.0)) self.assertEqual(t1_tor.utcoffset(), timedelta(hours=-5.0)) def testGapNegativeUTCOffset(self): # Test that we don't have a problem around gaps. tzname = self._get_tzname('America/Toronto') with self._gettz_context(tzname): TOR = self.gettz(tzname) t0_u = datetime(2011, 3, 13, 6, 30, tzinfo=tz.UTC) t1_u = datetime(2011, 3, 13, 7, 30, tzinfo=tz.UTC) t0 = t0_u.astimezone(TOR) t1 = t1_u.astimezone(TOR) self.assertEqual(t0.replace(tzinfo=None), datetime(2011, 3, 13, 1, 30)) self.assertEqual(t1.replace(tzinfo=None), datetime(2011, 3, 13, 3, 30)) self.assertNotEqual(t0, t1) self.assertEqual(t0.utcoffset(), timedelta(hours=-5.0)) self.assertEqual(t1.utcoffset(), timedelta(hours=-4.0)) def testFoldLondon(self): tzname = self._get_tzname('Europe/London') with self._gettz_context(tzname): LON = self.gettz(tzname) UTC = tz.UTC t0_u = datetime(2013, 10, 27, 0, 30, tzinfo=UTC) # BST t1_u = datetime(2013, 10, 27, 1, 30, tzinfo=UTC) # GMT t0 = t0_u.astimezone(LON) t1 = t1_u.astimezone(LON) self.assertEqual(t0.replace(tzinfo=None), datetime(2013, 10, 27, 1, 30)) self.assertEqual(t1.replace(tzinfo=None), datetime(2013, 10, 27, 1, 30)) self.assertEqual(t0.utcoffset(), timedelta(hours=1)) self.assertEqual(t1.utcoffset(), timedelta(hours=0)) def testFoldIndependence(self): tzname = self._get_tzname('America/New_York') with self._gettz_context(tzname): NYC = self.gettz(tzname) UTC = tz.UTC hour = timedelta(hours=1) # Firmly 2015-11-01 0:30 EDT-4 pre_dst = datetime(2015, 11, 1, 0, 30, tzinfo=NYC) # Ambiguous between 2015-11-01 1:30 EDT-4 and 2015-11-01 1:30 EST-5 in_dst = pre_dst + hour in_dst_tzname_0 = in_dst.tzname() # Stash the tzname - EDT # Doing the arithmetic in UTC creates a date that is unambiguously # 2015-11-01 1:30 EDT-5 in_dst_via_utc = (pre_dst.astimezone(UTC) + 2*hour).astimezone(NYC) # Make sure the dates are actually ambiguous self.assertEqual(in_dst, in_dst_via_utc) # Make sure we got the right folding behavior self.assertNotEqual(in_dst_via_utc.tzname(), in_dst_tzname_0) # Now check to make sure in_dst's tzname hasn't changed self.assertEqual(in_dst_tzname_0, in_dst.tzname()) def testInZoneFoldEquality(self): # Two datetimes in the same zone are considered to be equal if their # wall times are equal, even if they have different absolute times. tzname = self._get_tzname('America/New_York') with self._gettz_context(tzname): NYC = self.gettz(tzname) UTC = tz.UTC dt0 = datetime(2011, 11, 6, 1, 30, tzinfo=NYC) dt1 = tz.enfold(dt0, fold=1) # Make sure these actually represent different times self.assertNotEqual(dt0.astimezone(UTC), dt1.astimezone(UTC)) # Test that they compare equal self.assertEqual(dt0, dt1) def _test_ambiguous_time(self, dt, tzid, ambiguous): # This is a test to check that the individual is_ambiguous values # on the _tzinfo subclasses work. tzname = self._get_tzname(tzid) with self._gettz_context(tzname): tzi = self.gettz(tzname) self.assertEqual(tz.datetime_ambiguous(dt, tz=tzi), ambiguous) def testAmbiguousNegativeUTCOffset(self): self._test_ambiguous_time(datetime(2015, 11, 1, 1, 30), 'America/New_York', True) def testAmbiguousPositiveUTCOffset(self): self._test_ambiguous_time(datetime(2012, 4, 1, 2, 30), 'Australia/Sydney', True) def testUnambiguousNegativeUTCOffset(self): self._test_ambiguous_time(datetime(2015, 11, 1, 2, 30), 'America/New_York', False) def testUnambiguousPositiveUTCOffset(self): self._test_ambiguous_time(datetime(2012, 4, 1, 3, 30), 'Australia/Sydney', False) def testUnambiguousGapNegativeUTCOffset(self): # Imaginary time self._test_ambiguous_time(datetime(2011, 3, 13, 2, 30), 'America/New_York', False) def testUnambiguousGapPositiveUTCOffset(self): # Imaginary time self._test_ambiguous_time(datetime(2012, 10, 7, 2, 30), 'Australia/Sydney', False) def _test_imaginary_time(self, dt, tzid, exists): tzname = self._get_tzname(tzid) with self._gettz_context(tzname): tzi = self.gettz(tzname) self.assertEqual(tz.datetime_exists(dt, tz=tzi), exists) def testImaginaryNegativeUTCOffset(self): self._test_imaginary_time(datetime(2011, 3, 13, 2, 30), 'America/New_York', False) def testNotImaginaryNegativeUTCOffset(self): self._test_imaginary_time(datetime(2011, 3, 13, 1, 30), 'America/New_York', True) def testImaginaryPositiveUTCOffset(self): self._test_imaginary_time(datetime(2012, 10, 7, 2, 30), 'Australia/Sydney', False) def testNotImaginaryPositiveUTCOffset(self): self._test_imaginary_time(datetime(2012, 10, 7, 1, 30), 'Australia/Sydney', True) def testNotImaginaryFoldNegativeUTCOffset(self): self._test_imaginary_time(datetime(2015, 11, 1, 1, 30), 'America/New_York', True) def testNotImaginaryFoldPositiveUTCOffset(self): self._test_imaginary_time(datetime(2012, 4, 1, 3, 30), 'Australia/Sydney', True) @unittest.skip("Known failure in Python 3.6.") def testEqualAmbiguousComparison(self): tzname = self._get_tzname('Australia/Sydney') with self._gettz_context(tzname): SYD0 = self.gettz(tzname) SYD1 = self.gettz(tzname) t0_u = datetime(2012, 3, 31, 14, 30, tzinfo=tz.UTC) # AEST t0_syd0 = t0_u.astimezone(SYD0) t0_syd1 = t0_u.astimezone(SYD1) # This is considered an "inter-zone comparison" because it's an # ambiguous datetime. self.assertEqual(t0_syd0, t0_syd1) class TzWinFoldMixin(object): def get_args(self, tzname): return (tzname, ) class context(object): def __init__(*args, **kwargs): pass def __enter__(*args, **kwargs): pass def __exit__(*args, **kwargs): pass def get_utc_transitions(self, tzi, year, gap): dston, dstoff = tzi.transitions(year) if gap: t_n = dston - timedelta(minutes=30) t0_u = t_n.replace(tzinfo=tzi).astimezone(tz.UTC) t1_u = t0_u + timedelta(hours=1) else: # Get 1 hour before the first ambiguous date t_n = dstoff - timedelta(minutes=30) t0_u = t_n.replace(tzinfo=tzi).astimezone(tz.UTC) t_n += timedelta(hours=1) # Naive ambiguous date t0_u = t0_u + timedelta(hours=1) # First ambiguous date t1_u = t0_u + timedelta(hours=1) # Second ambiguous date return t_n, t0_u, t1_u def testFoldPositiveUTCOffset(self): # Test that we can resolve ambiguous times tzname = 'AUS Eastern Standard Time' args = self.get_args(tzname) with self.context(tzname): # Calling fromutc() alters the tzfile object SYD = self.tzclass(*args) # Get the transition time in UTC from the object, because # Windows doesn't store historical info t_n, t0_u, t1_u = self.get_utc_transitions(SYD, 2012, False) # Using fresh tzfiles t0_syd = t0_u.astimezone(SYD) t1_syd = t1_u.astimezone(SYD) self.assertEqual(t0_syd.replace(tzinfo=None), t_n) self.assertEqual(t1_syd.replace(tzinfo=None), t_n) self.assertEqual(t0_syd.utcoffset(), timedelta(hours=11)) self.assertEqual(t1_syd.utcoffset(), timedelta(hours=10)) self.assertNotEqual(t0_syd.tzname(), t1_syd.tzname()) def testGapPositiveUTCOffset(self): # Test that we don't have a problem around gaps. tzname = 'AUS Eastern Standard Time' args = self.get_args(tzname) with self.context(tzname): SYD = self.tzclass(*args) t_n, t0_u, t1_u = self.get_utc_transitions(SYD, 2012, True) t0 = t0_u.astimezone(SYD) t1 = t1_u.astimezone(SYD) self.assertEqual(t0.replace(tzinfo=None), t_n) self.assertEqual(t1.replace(tzinfo=None), t_n + timedelta(hours=2)) self.assertEqual(t0.utcoffset(), timedelta(hours=10)) self.assertEqual(t1.utcoffset(), timedelta(hours=11)) def testFoldNegativeUTCOffset(self): # Test that we can resolve ambiguous times tzname = 'Eastern Standard Time' args = self.get_args(tzname) with self.context(tzname): TOR = self.tzclass(*args) t_n, t0_u, t1_u = self.get_utc_transitions(TOR, 2011, False) t0_tor = t0_u.astimezone(TOR) t1_tor = t1_u.astimezone(TOR) self.assertEqual(t0_tor.replace(tzinfo=None), t_n) self.assertEqual(t1_tor.replace(tzinfo=None), t_n) self.assertNotEqual(t0_tor.tzname(), t1_tor.tzname()) self.assertEqual(t0_tor.utcoffset(), timedelta(hours=-4.0)) self.assertEqual(t1_tor.utcoffset(), timedelta(hours=-5.0)) def testGapNegativeUTCOffset(self): # Test that we don't have a problem around gaps. tzname = 'Eastern Standard Time' args = self.get_args(tzname) with self.context(tzname): TOR = self.tzclass(*args) t_n, t0_u, t1_u = self.get_utc_transitions(TOR, 2011, True) t0 = t0_u.astimezone(TOR) t1 = t1_u.astimezone(TOR) self.assertEqual(t0.replace(tzinfo=None), t_n) self.assertEqual(t1.replace(tzinfo=None), t_n + timedelta(hours=2)) self.assertNotEqual(t0.tzname(), t1.tzname()) self.assertEqual(t0.utcoffset(), timedelta(hours=-5.0)) self.assertEqual(t1.utcoffset(), timedelta(hours=-4.0)) def testFoldIndependence(self): tzname = 'Eastern Standard Time' args = self.get_args(tzname) with self.context(tzname): NYC = self.tzclass(*args) UTC = tz.UTC hour = timedelta(hours=1) # Firmly 2015-11-01 0:30 EDT-4 t_n, t0_u, t1_u = self.get_utc_transitions(NYC, 2015, False) pre_dst = (t_n - hour).replace(tzinfo=NYC) # Currently, there's no way around the fact that this resolves to an # ambiguous date, which defaults to EST. I'm not hard-coding in the # answer, though, because the preferred behavior would be that this # results in a time on the EDT side. # Ambiguous between 2015-11-01 1:30 EDT-4 and 2015-11-01 1:30 EST-5 in_dst = pre_dst + hour in_dst_tzname_0 = in_dst.tzname() # Stash the tzname - EDT # Doing the arithmetic in UTC creates a date that is unambiguously # 2015-11-01 1:30 EDT-5 in_dst_via_utc = (pre_dst.astimezone(UTC) + 2*hour).astimezone(NYC) # Make sure we got the right folding behavior self.assertNotEqual(in_dst_via_utc.tzname(), in_dst_tzname_0) # Now check to make sure in_dst's tzname hasn't changed self.assertEqual(in_dst_tzname_0, in_dst.tzname()) def testInZoneFoldEquality(self): # Two datetimes in the same zone are considered to be equal if their # wall times are equal, even if they have different absolute times. tzname = 'Eastern Standard Time' args = self.get_args(tzname) with self.context(tzname): NYC = self.tzclass(*args) UTC = tz.UTC t_n, t0_u, t1_u = self.get_utc_transitions(NYC, 2011, False) dt0 = t_n.replace(tzinfo=NYC) dt1 = tz.enfold(dt0, fold=1) # Make sure these actually represent different times self.assertNotEqual(dt0.astimezone(UTC), dt1.astimezone(UTC)) # Test that they compare equal self.assertEqual(dt0, dt1) ### # Test Cases class TzUTCTest(unittest.TestCase): def testSingleton(self): UTC_0 = tz.tzutc() UTC_1 = tz.tzutc() self.assertIs(UTC_0, UTC_1) def testOffset(self): ct = datetime(2009, 4, 1, 12, 11, 13, tzinfo=tz.tzutc()) self.assertEqual(ct.utcoffset(), timedelta(seconds=0)) def testDst(self): ct = datetime(2009, 4, 1, 12, 11, 13, tzinfo=tz.tzutc()) self.assertEqual(ct.dst(), timedelta(seconds=0)) def testTzName(self): ct = datetime(2009, 4, 1, 12, 11, 13, tzinfo=tz.tzutc()) self.assertEqual(ct.tzname(), 'UTC') def testEquality(self): UTC0 = tz.tzutc() UTC1 = tz.tzutc() self.assertEqual(UTC0, UTC1) def testInequality(self): UTC = tz.tzutc() UTCp4 = tz.tzoffset('UTC+4', 14400) self.assertNotEqual(UTC, UTCp4) def testInequalityInteger(self): self.assertFalse(tz.tzutc() == 7) self.assertNotEqual(tz.tzutc(), 7) def testInequalityUnsupported(self): self.assertEqual(tz.tzutc(), ComparesEqual) def testRepr(self): UTC = tz.tzutc() self.assertEqual(repr(UTC), 'tzutc()') def testTimeOnlyUTC(self): # https://github.com/dateutil/dateutil/issues/132 # tzutc doesn't care tz_utc = tz.tzutc() self.assertEqual(dt_time(13, 20, tzinfo=tz_utc).utcoffset(), timedelta(0)) def testAmbiguity(self): # Pick an arbitrary datetime, this should always return False. dt = datetime(2011, 9, 1, 2, 30, tzinfo=tz.tzutc()) self.assertFalse(tz.datetime_ambiguous(dt)) @pytest.mark.tzoffset class TzOffsetTest(unittest.TestCase): def testTimedeltaOffset(self): est = tz.tzoffset('EST', timedelta(hours=-5)) est_s = tz.tzoffset('EST', -18000) self.assertEqual(est, est_s) def testTzNameNone(self): gmt5 = tz.tzoffset(None, -18000) # -5:00 self.assertIs(datetime(2003, 10, 26, 0, 0, tzinfo=gmt5).tzname(), None) def testTimeOnlyOffset(self): # tzoffset doesn't care tz_offset = tz.tzoffset('+3', 3600) self.assertEqual(dt_time(13, 20, tzinfo=tz_offset).utcoffset(), timedelta(seconds=3600)) def testTzOffsetRepr(self): tname = 'EST' tzo = tz.tzoffset(tname, -5 * 3600) self.assertEqual(repr(tzo), "tzoffset(" + repr(tname) + ", -18000)") def testEquality(self): utc = tz.tzoffset('UTC', 0) gmt = tz.tzoffset('GMT', 0) self.assertEqual(utc, gmt) def testUTCEquality(self): utc = tz.UTC o_utc = tz.tzoffset('UTC', 0) self.assertEqual(utc, o_utc) self.assertEqual(o_utc, utc) def testInequalityInvalid(self): tzo = tz.tzoffset('-3', -3 * 3600) self.assertFalse(tzo == -3) self.assertNotEqual(tzo, -3) def testInequalityUnsupported(self): tzo = tz.tzoffset('-5', -5 * 3600) self.assertTrue(tzo == ComparesEqual) self.assertFalse(tzo != ComparesEqual) self.assertEqual(tzo, ComparesEqual) def testAmbiguity(self): # Pick an arbitrary datetime, this should always return False. dt = datetime(2011, 9, 1, 2, 30, tzinfo=tz.tzoffset("EST", -5 * 3600)) self.assertFalse(tz.datetime_ambiguous(dt)) def testTzOffsetInstance(self): tz1 = tz.tzoffset.instance('EST', timedelta(hours=-5)) tz2 = tz.tzoffset.instance('EST', timedelta(hours=-5)) assert tz1 is not tz2 def testTzOffsetSingletonDifferent(self): tz1 = tz.tzoffset('EST', timedelta(hours=-5)) tz2 = tz.tzoffset('EST', -18000) assert tz1 is tz2 @pytest.mark.smoke @pytest.mark.tzoffset def test_tzoffset_weakref(): UTC1 = tz.tzoffset('UTC', 0) UTC_ref = weakref.ref(tz.tzoffset('UTC', 0)) UTC1 is UTC_ref() del UTC1 gc.collect() assert UTC_ref() is not None # Should be in the strong cache assert UTC_ref() is tz.tzoffset('UTC', 0) # Fill the strong cache with other items for offset in range(5,15): tz.tzoffset('RandomZone', offset) gc.collect() assert UTC_ref() is None assert UTC_ref() is not tz.tzoffset('UTC', 0) @pytest.mark.tzoffset @pytest.mark.parametrize('args', [ ('UTC', 0), ('EST', -18000), ('EST', timedelta(hours=-5)), (None, timedelta(hours=3)), ]) def test_tzoffset_singleton(args): tz1 = tz.tzoffset(*args) tz2 = tz.tzoffset(*args) assert tz1 is tz2 @pytest.mark.tzoffset @pytest.mark.skipif(not SUPPORTS_SUB_MINUTE_OFFSETS, reason='Sub-minute offsets not supported') def test_tzoffset_sub_minute(): delta = timedelta(hours=12, seconds=30) test_datetime = datetime(2000, 1, 1, tzinfo=tz.tzoffset(None, delta)) assert test_datetime.utcoffset() == delta @pytest.mark.tzoffset @pytest.mark.skipif(SUPPORTS_SUB_MINUTE_OFFSETS, reason='Sub-minute offsets supported') def test_tzoffset_sub_minute_rounding(): delta = timedelta(hours=12, seconds=30) test_date = datetime(2000, 1, 1, tzinfo=tz.tzoffset(None, delta)) assert test_date.utcoffset() == timedelta(hours=12, minutes=1) @pytest.mark.tzlocal class TzLocalTest(unittest.TestCase): def testEquality(self): tz1 = tz.tzlocal() tz2 = tz.tzlocal() # Explicitly calling == and != here to ensure the operators work self.assertTrue(tz1 == tz2) self.assertFalse(tz1 != tz2) def testInequalityFixedOffset(self): tzl = tz.tzlocal() tzos = tz.tzoffset('LST', tzl._std_offset.total_seconds()) tzod = tz.tzoffset('LDT', tzl._std_offset.total_seconds()) self.assertFalse(tzl == tzos) self.assertFalse(tzl == tzod) self.assertTrue(tzl != tzos) self.assertTrue(tzl != tzod) def testInequalityInvalid(self): tzl = tz.tzlocal() self.assertTrue(tzl != 1) self.assertFalse(tzl == 1) # TODO: Use some sort of universal local mocking so that it's clear # that we're expecting tzlocal to *not* be Pacific/Kiritimati LINT = tz.gettz('Pacific/Kiritimati') self.assertTrue(tzl != LINT) self.assertFalse(tzl == LINT) def testInequalityUnsupported(self): tzl = tz.tzlocal() self.assertTrue(tzl == ComparesEqual) self.assertFalse(tzl != ComparesEqual) def testRepr(self): tzl = tz.tzlocal() self.assertEqual(repr(tzl), 'tzlocal()') @pytest.mark.parametrize('args,kwargs', [ (('EST', -18000), {}), (('EST', timedelta(hours=-5)), {}), (('EST',), {'offset': -18000}), (('EST',), {'offset': timedelta(hours=-5)}), (tuple(), {'name': 'EST', 'offset': -18000}) ]) def test_tzoffset_is(args, kwargs): tz_ref = tz.tzoffset('EST', -18000) assert tz.tzoffset(*args, **kwargs) is tz_ref def test_tzoffset_is_not(): assert tz.tzoffset('EDT', -14400) is not tz.tzoffset('EST', -18000) @pytest.mark.tzlocal @unittest.skipIf(IS_WIN, "requires Unix") class TzLocalNixTest(unittest.TestCase, TzFoldMixin): # This is a set of tests for `tzlocal()` on *nix systems # POSIX string indicating change to summer time on the 2nd Sunday in March # at 2AM, and ending the 1st Sunday in November at 2AM. (valid >= 2007) TZ_EST = 'EST+5EDT,M3.2.0/2,M11.1.0/2' # POSIX string for AEST/AEDT (valid >= 2008) TZ_AEST = 'AEST-10AEDT,M10.1.0/2,M4.1.0/3' # POSIX string for BST/GMT TZ_LON = 'GMT0BST,M3.5.0,M10.5.0' # POSIX string for UTC UTC = 'UTC' def gettz(self, tzname): # Actual time zone changes are handled by the _gettz_context function return tz.tzlocal() def _gettz_context(self, tzname): tzname_map = {'Australia/Sydney': self.TZ_AEST, 'America/Toronto': self.TZ_EST, 'America/New_York': self.TZ_EST, 'Europe/London': self.TZ_LON} return TZEnvContext(tzname_map.get(tzname, tzname)) def _testTzFunc(self, tzval, func, std_val, dst_val): """ This generates tests about how the behavior of a function ``func`` changes between STD and DST (e.g. utcoffset, tzname, dst). It assume that DST starts the 2nd Sunday in March and ends the 1st Sunday in November """ with TZEnvContext(tzval): dt1 = datetime(2015, 2, 1, 12, 0, tzinfo=tz.tzlocal()) # STD dt2 = datetime(2015, 5, 1, 12, 0, tzinfo=tz.tzlocal()) # DST self.assertEqual(func(dt1), std_val) self.assertEqual(func(dt2), dst_val) def _testTzName(self, tzval, std_name, dst_name): func = datetime.tzname self._testTzFunc(tzval, func, std_name, dst_name) def testTzNameDST(self): # Test tzname in a zone with DST self._testTzName(self.TZ_EST, 'EST', 'EDT') def testTzNameUTC(self): # Test tzname in a zone without DST self._testTzName(self.UTC, 'UTC', 'UTC') def _testOffset(self, tzval, std_off, dst_off): func = datetime.utcoffset self._testTzFunc(tzval, func, std_off, dst_off) def testOffsetDST(self): self._testOffset(self.TZ_EST, timedelta(hours=-5), timedelta(hours=-4)) def testOffsetUTC(self): self._testOffset(self.UTC, timedelta(0), timedelta(0)) def _testDST(self, tzval, dst_dst): func = datetime.dst std_dst = timedelta(0) self._testTzFunc(tzval, func, std_dst, dst_dst) def testDSTDST(self): self._testDST(self.TZ_EST, timedelta(hours=1)) def testDSTUTC(self): self._testDST(self.UTC, timedelta(0)) def testTimeOnlyOffsetLocalUTC(self): with TZEnvContext(self.UTC): self.assertEqual(dt_time(13, 20, tzinfo=tz.tzlocal()).utcoffset(), timedelta(0)) def testTimeOnlyOffsetLocalDST(self): with TZEnvContext(self.TZ_EST): self.assertIs(dt_time(13, 20, tzinfo=tz.tzlocal()).utcoffset(), None) def testTimeOnlyDSTLocalUTC(self): with TZEnvContext(self.UTC): self.assertEqual(dt_time(13, 20, tzinfo=tz.tzlocal()).dst(), timedelta(0)) def testTimeOnlyDSTLocalDST(self): with TZEnvContext(self.TZ_EST): self.assertIs(dt_time(13, 20, tzinfo=tz.tzlocal()).dst(), None) def testUTCEquality(self): with TZEnvContext(self.UTC): assert tz.tzlocal() == tz.UTC # TODO: Maybe a better hack than this? def mark_tzlocal_nix(f): marks = [ pytest.mark.tzlocal, pytest.mark.skipif(IS_WIN, reason='requires Unix'), ] for mark in reversed(marks): f = mark(f) return f @mark_tzlocal_nix @pytest.mark.parametrize('tzvar', ['UTC', 'GMT0', 'UTC0']) def test_tzlocal_utc_equal(tzvar): with TZEnvContext(tzvar): assert tz.tzlocal() == tz.UTC @mark_tzlocal_nix @pytest.mark.parametrize('tzvar', [ 'Europe/London', 'America/New_York', 'GMT0BST', 'EST5EDT']) def test_tzlocal_utc_unequal(tzvar): with TZEnvContext(tzvar): assert tz.tzlocal() != tz.UTC @mark_tzlocal_nix def test_tzlocal_local_time_trim_colon(): with TZEnvContext(':/etc/localtime'): assert tz.gettz() is not None @mark_tzlocal_nix @pytest.mark.parametrize('tzvar, tzoff', [ ('EST5', tz.tzoffset('EST', -18000)), ('GMT0', tz.tzoffset('GMT', 0)), ('YAKT-9', tz.tzoffset('YAKT', timedelta(hours=9))), ('JST-9', tz.tzoffset('JST', timedelta(hours=9))), ]) def test_tzlocal_offset_equal(tzvar, tzoff): with TZEnvContext(tzvar): # Including both to test both __eq__ and __ne__ assert tz.tzlocal() == tzoff assert not (tz.tzlocal() != tzoff) @mark_tzlocal_nix @pytest.mark.parametrize('tzvar, tzoff', [ ('EST5EDT', tz.tzoffset('EST', -18000)), ('GMT0BST', tz.tzoffset('GMT', 0)), ('EST5', tz.tzoffset('EST', -14400)), ('YAKT-9', tz.tzoffset('JST', timedelta(hours=9))), ('JST-9', tz.tzoffset('YAKT', timedelta(hours=9))), ]) def test_tzlocal_offset_unequal(tzvar, tzoff): with TZEnvContext(tzvar): # Including both to test both __eq__ and __ne__ assert tz.tzlocal() != tzoff assert not (tz.tzlocal() == tzoff) @pytest.mark.gettz class GettzTest(unittest.TestCase, TzFoldMixin): gettz = staticmethod(tz.gettz) def testGettz(self): # bug 892569 str(self.gettz('UTC')) def testGetTzEquality(self): self.assertEqual(self.gettz('UTC'), self.gettz('UTC')) def testTimeOnlyGettz(self): # gettz returns None tz_get = self.gettz('Europe/Minsk') self.assertIs(dt_time(13, 20, tzinfo=tz_get).utcoffset(), None) def testTimeOnlyGettzDST(self): # gettz returns None tz_get = self.gettz('Europe/Minsk') self.assertIs(dt_time(13, 20, tzinfo=tz_get).dst(), None) def testTimeOnlyGettzTzName(self): tz_get = self.gettz('Europe/Minsk') self.assertIs(dt_time(13, 20, tzinfo=tz_get).tzname(), None) def testTimeOnlyFormatZ(self): tz_get = self.gettz('Europe/Minsk') t = dt_time(13, 20, tzinfo=tz_get) self.assertEqual(t.strftime('%H%M%Z'), '1320') def testPortugalDST(self): # In 1996, Portugal changed from CET to WET PORTUGAL = self.gettz('Portugal') t_cet = datetime(1996, 3, 31, 1, 59, tzinfo=PORTUGAL) self.assertEqual(t_cet.tzname(), 'CET') self.assertEqual(t_cet.utcoffset(), timedelta(hours=1)) self.assertEqual(t_cet.dst(), timedelta(0)) t_west = datetime(1996, 3, 31, 2, 1, tzinfo=PORTUGAL) self.assertEqual(t_west.tzname(), 'WEST') self.assertEqual(t_west.utcoffset(), timedelta(hours=1)) self.assertEqual(t_west.dst(), timedelta(hours=1)) def testGettzCacheTzFile(self): NYC1 = tz.gettz('America/New_York') NYC2 = tz.gettz('America/New_York') assert NYC1 is NYC2 def testGettzCacheTzLocal(self): local1 = tz.gettz() local2 = tz.gettz() assert local1 is not local2 @pytest.mark.gettz def test_gettz_same_result_for_none_and_empty_string(): local_from_none = tz.gettz() local_from_empty_string = tz.gettz("") assert local_from_none is not None assert local_from_empty_string is not None assert local_from_none == local_from_empty_string @pytest.mark.gettz @pytest.mark.parametrize('badzone', [ 'Fake.Region/Abcdefghijklmnop', # Violates several tz project name rules ]) def test_gettz_badzone(badzone): # Make sure passing a bad TZ string to gettz returns None (GH #800) tzi = tz.gettz(badzone) assert tzi is None @pytest.mark.gettz def test_gettz_badzone_unicode(): # Make sure a unicode string can be passed to TZ (GH #802) # When fixed, combine this with test_gettz_badzone tzi = tz.gettz('🐼') assert tzi is None @pytest.mark.gettz @pytest.mark.parametrize( "badzone,exc_reason", [ pytest.param( b"America/New_York", ".*should be str, not bytes.*", id="bytes on Python 3", marks=[ pytest.mark.skipif( PY2, reason="bytes arguments accepted in Python 2" ) ], ), pytest.param( object(), None, id="no startswith()", marks=[ pytest.mark.xfail(reason="AttributeError instead of TypeError", raises=AttributeError), ], ), ], ) def test_gettz_zone_wrong_type(badzone, exc_reason): with pytest.raises(TypeError, match=exc_reason): tz.gettz(badzone) @pytest.mark.gettz @pytest.mark.xfail(IS_WIN, reason='zoneinfo separately cached') def test_gettz_cache_clear(): NYC1 = tz.gettz('America/New_York') tz.gettz.cache_clear() NYC2 = tz.gettz('America/New_York') assert NYC1 is not NYC2 @pytest.mark.gettz @pytest.mark.xfail(IS_WIN, reason='zoneinfo separately cached') def test_gettz_set_cache_size(): tz.gettz.cache_clear() tz.gettz.set_cache_size(3) MONACO_ref = weakref.ref(tz.gettz('Europe/Monaco')) EASTER_ref = weakref.ref(tz.gettz('Pacific/Easter')) CURRIE_ref = weakref.ref(tz.gettz('Australia/Currie')) gc.collect() assert MONACO_ref() is not None assert EASTER_ref() is not None assert CURRIE_ref() is not None tz.gettz.set_cache_size(2) gc.collect() assert MONACO_ref() is None @pytest.mark.xfail(IS_WIN, reason="Windows does not use system zoneinfo") @pytest.mark.smoke @pytest.mark.gettz def test_gettz_weakref(): tz.gettz.cache_clear() tz.gettz.set_cache_size(2) NYC1 = tz.gettz('America/New_York') NYC_ref = weakref.ref(tz.gettz('America/New_York')) assert NYC1 is NYC_ref() del NYC1 gc.collect() assert NYC_ref() is not None # Should still be in the strong cache assert tz.gettz('America/New_York') is NYC_ref() # Populate strong cache with other timezones tz.gettz('Europe/Monaco') tz.gettz('Pacific/Easter') tz.gettz('Australia/Currie') gc.collect() assert NYC_ref() is None # Should have been pushed out assert tz.gettz('America/New_York') is not NYC_ref() class ZoneInfoGettzTest(GettzTest): def gettz(self, name): zoneinfo_file = zoneinfo.get_zonefile_instance() return zoneinfo_file.get(name) def testZoneInfoFileStart1(self): tz = self.gettz("EST5EDT") self.assertEqual(datetime(2003, 4, 6, 1, 59, tzinfo=tz).tzname(), "EST", MISSING_TARBALL) self.assertEqual(datetime(2003, 4, 6, 2, 00, tzinfo=tz).tzname(), "EDT") def testZoneInfoFileEnd1(self): tzc = self.gettz("EST5EDT") self.assertEqual(datetime(2003, 10, 26, 0, 59, tzinfo=tzc).tzname(), "EDT", MISSING_TARBALL) end_est = tz.enfold(datetime(2003, 10, 26, 1, 00, tzinfo=tzc), fold=1) self.assertEqual(end_est.tzname(), "EST") def testZoneInfoOffsetSignal(self): utc = self.gettz("UTC") nyc = self.gettz("America/New_York") self.assertNotEqual(utc, None, MISSING_TARBALL) self.assertNotEqual(nyc, None) t0 = datetime(2007, 11, 4, 0, 30, tzinfo=nyc) t1 = t0.astimezone(utc) t2 = t1.astimezone(nyc) self.assertEqual(t0, t2) self.assertEqual(nyc.dst(t0), timedelta(hours=1)) def testZoneInfoCopy(self): # copy.copy() called on a ZoneInfo file was returning the same instance CHI = self.gettz('America/Chicago') CHI_COPY = copy.copy(CHI) self.assertIsNot(CHI, CHI_COPY) self.assertEqual(CHI, CHI_COPY) def testZoneInfoDeepCopy(self): CHI = self.gettz('America/Chicago') CHI_COPY = copy.deepcopy(CHI) self.assertIsNot(CHI, CHI_COPY) self.assertEqual(CHI, CHI_COPY) def testZoneInfoInstanceCaching(self): zif_0 = zoneinfo.get_zonefile_instance() zif_1 = zoneinfo.get_zonefile_instance() self.assertIs(zif_0, zif_1) def testZoneInfoNewInstance(self): zif_0 = zoneinfo.get_zonefile_instance() zif_1 = zoneinfo.get_zonefile_instance(new_instance=True) zif_2 = zoneinfo.get_zonefile_instance() self.assertIsNot(zif_0, zif_1) self.assertIs(zif_1, zif_2) def testZoneInfoDeprecated(self): with pytest.warns(DeprecationWarning): zoneinfo.gettz('US/Eastern') def testZoneInfoMetadataDeprecated(self): with pytest.warns(DeprecationWarning): zoneinfo.gettz_db_metadata() class TZRangeTest(unittest.TestCase, TzFoldMixin): TZ_EST = tz.tzrange('EST', timedelta(hours=-5), 'EDT', timedelta(hours=-4), start=relativedelta(month=3, day=1, hour=2, weekday=SU(+2)), end=relativedelta(month=11, day=1, hour=1, weekday=SU(+1))) TZ_AEST = tz.tzrange('AEST', timedelta(hours=10), 'AEDT', timedelta(hours=11), start=relativedelta(month=10, day=1, hour=2, weekday=SU(+1)), end=relativedelta(month=4, day=1, hour=2, weekday=SU(+1))) TZ_LON = tz.tzrange('GMT', timedelta(hours=0), 'BST', timedelta(hours=1), start=relativedelta(month=3, day=31, weekday=SU(-1), hours=2), end=relativedelta(month=10, day=31, weekday=SU(-1), hours=1)) # POSIX string for UTC UTC = 'UTC' def gettz(self, tzname): tzname_map = {'Australia/Sydney': self.TZ_AEST, 'America/Toronto': self.TZ_EST, 'America/New_York': self.TZ_EST, 'Europe/London': self.TZ_LON} return tzname_map[tzname] def testRangeCmp1(self): self.assertEqual(tz.tzstr("EST5EDT"), tz.tzrange("EST", -18000, "EDT", -14400, relativedelta(hours=+2, month=4, day=1, weekday=SU(+1)), relativedelta(hours=+1, month=10, day=31, weekday=SU(-1)))) def testRangeCmp2(self): self.assertEqual(tz.tzstr("EST5EDT"), tz.tzrange("EST", -18000, "EDT")) def testRangeOffsets(self): TZR = tz.tzrange('EST', -18000, 'EDT', -14400, start=relativedelta(hours=2, month=4, day=1, weekday=SU(+2)), end=relativedelta(hours=1, month=10, day=31, weekday=SU(-1))) dt_std = datetime(2014, 4, 11, 12, 0, tzinfo=TZR) # STD dt_dst = datetime(2016, 4, 11, 12, 0, tzinfo=TZR) # DST dst_zero = timedelta(0) dst_hour = timedelta(hours=1) std_offset = timedelta(hours=-5) dst_offset = timedelta(hours=-4) # Check dst() self.assertEqual(dt_std.dst(), dst_zero) self.assertEqual(dt_dst.dst(), dst_hour) # Check utcoffset() self.assertEqual(dt_std.utcoffset(), std_offset) self.assertEqual(dt_dst.utcoffset(), dst_offset) # Check tzname self.assertEqual(dt_std.tzname(), 'EST') self.assertEqual(dt_dst.tzname(), 'EDT') def testTimeOnlyRangeFixed(self): # This is a fixed-offset zone, so tzrange allows this tz_range = tz.tzrange('dflt', stdoffset=timedelta(hours=-3)) self.assertEqual(dt_time(13, 20, tzinfo=tz_range).utcoffset(), timedelta(hours=-3)) def testTimeOnlyRange(self): # tzrange returns None because this zone has DST tz_range = tz.tzrange('EST', timedelta(hours=-5), 'EDT', timedelta(hours=-4)) self.assertIs(dt_time(13, 20, tzinfo=tz_range).utcoffset(), None) def testBrokenIsDstHandling(self): # tzrange._isdst() was using a date() rather than a datetime(). # Issue reported by Lennart Regebro. dt = datetime(2007, 8, 6, 4, 10, tzinfo=tz.UTC) self.assertEqual(dt.astimezone(tz=tz.gettz("GMT+2")), datetime(2007, 8, 6, 6, 10, tzinfo=tz.tzstr("GMT+2"))) def testRangeTimeDelta(self): # Test that tzrange can be specified with a timedelta instead of an int. EST5EDT_td = tz.tzrange('EST', timedelta(hours=-5), 'EDT', timedelta(hours=-4)) EST5EDT_sec = tz.tzrange('EST', -18000, 'EDT', -14400) self.assertEqual(EST5EDT_td, EST5EDT_sec) def testRangeEquality(self): TZR1 = tz.tzrange('EST', -18000, 'EDT', -14400) # Standard abbreviation different TZR2 = tz.tzrange('ET', -18000, 'EDT', -14400) self.assertNotEqual(TZR1, TZR2) # DST abbreviation different TZR3 = tz.tzrange('EST', -18000, 'EMT', -14400) self.assertNotEqual(TZR1, TZR3) # STD offset different TZR4 = tz.tzrange('EST', -14000, 'EDT', -14400) self.assertNotEqual(TZR1, TZR4) # DST offset different TZR5 = tz.tzrange('EST', -18000, 'EDT', -18000) self.assertNotEqual(TZR1, TZR5) # Start delta different TZR6 = tz.tzrange('EST', -18000, 'EDT', -14400, start=relativedelta(hours=+1, month=3, day=1, weekday=SU(+2))) self.assertNotEqual(TZR1, TZR6) # End delta different TZR7 = tz.tzrange('EST', -18000, 'EDT', -14400, end=relativedelta(hours=+1, month=11, day=1, weekday=SU(+2))) self.assertNotEqual(TZR1, TZR7) def testRangeInequalityUnsupported(self): TZR = tz.tzrange('EST', -18000, 'EDT', -14400) self.assertFalse(TZR == 4) self.assertTrue(TZR == ComparesEqual) self.assertFalse(TZR != ComparesEqual) @pytest.mark.tzstr class TZStrTest(unittest.TestCase, TzFoldMixin): # POSIX string indicating change to summer time on the 2nd Sunday in March # at 2AM, and ending the 1st Sunday in November at 2AM. (valid >= 2007) TZ_EST = 'EST+5EDT,M3.2.0/2,M11.1.0/2' # POSIX string for AEST/AEDT (valid >= 2008) TZ_AEST = 'AEST-10AEDT,M10.1.0/2,M4.1.0/3' # POSIX string for GMT/BST TZ_LON = 'GMT0BST,M3.5.0,M10.5.0' def gettz(self, tzname): # Actual time zone changes are handled by the _gettz_context function tzname_map = {'Australia/Sydney': self.TZ_AEST, 'America/Toronto': self.TZ_EST, 'America/New_York': self.TZ_EST, 'Europe/London': self.TZ_LON} return tz.tzstr(tzname_map[tzname]) def testStrStr(self): # Test that tz.tzstr() won't throw an error if given a str instead # of a unicode literal. self.assertEqual(datetime(2003, 4, 6, 1, 59, tzinfo=tz.tzstr(str("EST5EDT"))).tzname(), "EST") self.assertEqual(datetime(2003, 4, 6, 2, 00, tzinfo=tz.tzstr(str("EST5EDT"))).tzname(), "EDT") def testStrInequality(self): TZS1 = tz.tzstr('EST5EDT4') # Standard abbreviation different TZS2 = tz.tzstr('ET5EDT4') self.assertNotEqual(TZS1, TZS2) # DST abbreviation different TZS3 = tz.tzstr('EST5EMT') self.assertNotEqual(TZS1, TZS3) # STD offset different TZS4 = tz.tzstr('EST4EDT4') self.assertNotEqual(TZS1, TZS4) # DST offset different TZS5 = tz.tzstr('EST5EDT3') self.assertNotEqual(TZS1, TZS5) def testStrInequalityStartEnd(self): TZS1 = tz.tzstr('EST5EDT4') # Start delta different TZS2 = tz.tzstr('EST5EDT4,M4.2.0/02:00:00,M10-5-0/02:00') self.assertNotEqual(TZS1, TZS2) # End delta different TZS3 = tz.tzstr('EST5EDT4,M4.2.0/02:00:00,M11-5-0/02:00') self.assertNotEqual(TZS1, TZS3) def testPosixOffset(self): TZ1 = tz.tzstr('UTC-3') self.assertEqual(datetime(2015, 1, 1, tzinfo=TZ1).utcoffset(), timedelta(hours=-3)) TZ2 = tz.tzstr('UTC-3', posix_offset=True) self.assertEqual(datetime(2015, 1, 1, tzinfo=TZ2).utcoffset(), timedelta(hours=+3)) def testStrInequalityUnsupported(self): TZS = tz.tzstr('EST5EDT') self.assertFalse(TZS == 4) self.assertTrue(TZS == ComparesEqual) self.assertFalse(TZS != ComparesEqual) def testTzStrRepr(self): TZS1 = tz.tzstr('EST5EDT4') TZS2 = tz.tzstr('EST') self.assertEqual(repr(TZS1), "tzstr(" + repr('EST5EDT4') + ")") self.assertEqual(repr(TZS2), "tzstr(" + repr('EST') + ")") def testTzStrFailure(self): with self.assertRaises(ValueError): tz.tzstr('InvalidString;439999') def testTzStrSingleton(self): tz1 = tz.tzstr('EST5EDT') tz2 = tz.tzstr('CST4CST') tz3 = tz.tzstr('EST5EDT') self.assertIsNot(tz1, tz2) self.assertIs(tz1, tz3) def testTzStrSingletonPosix(self): tz_t1 = tz.tzstr('GMT+3', posix_offset=True) tz_f1 = tz.tzstr('GMT+3', posix_offset=False) tz_t2 = tz.tzstr('GMT+3', posix_offset=True) tz_f2 = tz.tzstr('GMT+3', posix_offset=False) self.assertIs(tz_t1, tz_t2) self.assertIsNot(tz_t1, tz_f1) self.assertIs(tz_f1, tz_f2) def testTzStrInstance(self): tz1 = tz.tzstr('EST5EDT') tz2 = tz.tzstr.instance('EST5EDT') tz3 = tz.tzstr.instance('EST5EDT') assert tz1 is not tz2 assert tz2 is not tz3 # Ensure that these still are all the same zone assert tz1 == tz2 == tz3 @pytest.mark.smoke @pytest.mark.tzstr def test_tzstr_weakref(): tz_t1 = tz.tzstr('EST5EDT') tz_t2_ref = weakref.ref(tz.tzstr('EST5EDT')) assert tz_t1 is tz_t2_ref() del tz_t1 gc.collect() assert tz_t2_ref() is not None assert tz.tzstr('EST5EDT') is tz_t2_ref() for offset in range(5,15): tz.tzstr('GMT+{}'.format(offset)) gc.collect() assert tz_t2_ref() is None assert tz.tzstr('EST5EDT') is not tz_t2_ref() @pytest.mark.tzstr @pytest.mark.parametrize('tz_str,expected', [ # From https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html ('', tz.tzrange(None)), # TODO: Should change this so tz.tzrange('') works ('EST+5EDT,M3.2.0/2,M11.1.0/12', tz.tzrange('EST', -18000, 'EDT', -14400, start=relativedelta(month=3, day=1, weekday=SU(2), hours=2), end=relativedelta(month=11, day=1, weekday=SU(1), hours=11))), ('WART4WARST,J1/0,J365/25', # This is DST all year, Western Argentina Summer Time tz.tzrange('WART', timedelta(hours=-4), 'WARST', start=relativedelta(month=1, day=1, hours=0), end=relativedelta(month=12, day=31, days=1))), ('IST-2IDT,M3.4.4/26,M10.5.0', # Israel Standard / Daylight Time tz.tzrange('IST', timedelta(hours=2), 'IDT', start=relativedelta(month=3, day=1, weekday=TH(4), days=1, hours=2), end=relativedelta(month=10, day=31, weekday=SU(-1), hours=1))), ('WGT3WGST,M3.5.0/2,M10.5.0/1', tz.tzrange('WGT', timedelta(hours=-3), 'WGST', start=relativedelta(month=3, day=31, weekday=SU(-1), hours=2), end=relativedelta(month=10, day=31, weekday=SU(-1), hours=0))), # Different offset specifications ('WGT0300WGST', tz.tzrange('WGT', timedelta(hours=-3), 'WGST')), ('WGT03:00WGST', tz.tzrange('WGT', timedelta(hours=-3), 'WGST')), ('AEST-1100AEDT', tz.tzrange('AEST', timedelta(hours=11), 'AEDT')), ('AEST-11:00AEDT', tz.tzrange('AEST', timedelta(hours=11), 'AEDT')), # Different time formats ('EST5EDT,M3.2.0/4:00,M11.1.0/3:00', tz.tzrange('EST', timedelta(hours=-5), 'EDT', start=relativedelta(month=3, day=1, weekday=SU(2), hours=4), end=relativedelta(month=11, day=1, weekday=SU(1), hours=2))), ('EST5EDT,M3.2.0/04:00,M11.1.0/03:00', tz.tzrange('EST', timedelta(hours=-5), 'EDT', start=relativedelta(month=3, day=1, weekday=SU(2), hours=4), end=relativedelta(month=11, day=1, weekday=SU(1), hours=2))), ('EST5EDT,M3.2.0/0400,M11.1.0/0300', tz.tzrange('EST', timedelta(hours=-5), 'EDT', start=relativedelta(month=3, day=1, weekday=SU(2), hours=4), end=relativedelta(month=11, day=1, weekday=SU(1), hours=2))), ]) def test_valid_GNU_tzstr(tz_str, expected): tzi = tz.tzstr(tz_str) assert tzi == expected @pytest.mark.tzstr @pytest.mark.parametrize('tz_str, expected', [ ('EST5EDT,5,4,0,7200,11,3,0,7200', tz.tzrange('EST', timedelta(hours=-5), 'EDT', start=relativedelta(month=5, day=1, weekday=SU(+4), hours=+2), end=relativedelta(month=11, day=1, weekday=SU(+3), hours=+1))), ('EST5EDT,5,-4,0,7200,11,3,0,7200', tz.tzrange('EST', timedelta(hours=-5), 'EDT', start=relativedelta(hours=+2, month=5, day=31, weekday=SU(-4)), end=relativedelta(hours=+1, month=11, day=1, weekday=SU(+3)))), ('EST5EDT,5,4,0,7200,11,-3,0,7200', tz.tzrange('EST', timedelta(hours=-5), 'EDT', start=relativedelta(hours=+2, month=5, day=1, weekday=SU(+4)), end=relativedelta(hours=+1, month=11, day=31, weekday=SU(-3)))), ('EST5EDT,5,4,0,7200,11,-3,0,7200,3600', tz.tzrange('EST', timedelta(hours=-5), 'EDT', start=relativedelta(hours=+2, month=5, day=1, weekday=SU(+4)), end=relativedelta(hours=+1, month=11, day=31, weekday=SU(-3)))), ('EST5EDT,5,4,0,7200,11,-3,0,7200,3600', tz.tzrange('EST', timedelta(hours=-5), 'EDT', start=relativedelta(hours=+2, month=5, day=1, weekday=SU(+4)), end=relativedelta(hours=+1, month=11, day=31, weekday=SU(-3)))), ('EST5EDT,5,4,0,7200,11,-3,0,7200,-3600', tz.tzrange('EST', timedelta(hours=-5), 'EDT', timedelta(hours=-6), start=relativedelta(hours=+2, month=5, day=1, weekday=SU(+4)), end=relativedelta(hours=+3, month=11, day=31, weekday=SU(-3)))), ('EST5EDT,5,4,0,7200,11,-3,0,7200,+7200', tz.tzrange('EST', timedelta(hours=-5), 'EDT', timedelta(hours=-3), start=relativedelta(hours=+2, month=5, day=1, weekday=SU(+4)), end=relativedelta(hours=0, month=11, day=31, weekday=SU(-3)))), ('EST5EDT,5,4,0,7200,11,-3,0,7200,+3600', tz.tzrange('EST', timedelta(hours=-5), 'EDT', start=relativedelta(hours=+2, month=5, day=1, weekday=SU(+4)), end=relativedelta(hours=+1, month=11, day=31, weekday=SU(-3)))), ]) def test_valid_dateutil_format(tz_str, expected): # This tests the dateutil-specific format that is used widely in the tests # and examples. It is unclear where this format originated from. with pytest.warns(tz.DeprecatedTzFormatWarning): tzi = tz.tzstr.instance(tz_str) assert tzi == expected @pytest.mark.tzstr @pytest.mark.parametrize('tz_str', [ 'hdfiughdfuig,dfughdfuigpu87ñ::', ',dfughdfuigpu87ñ::', '-1:WART4WARST,J1,J365/25', 'WART4WARST,J1,J365/-25', 'IST-2IDT,M3.4.-1/26,M10.5.0', 'IST-2IDT,M3,2000,1/26,M10,5,0' ]) def test_invalid_GNU_tzstr(tz_str): with pytest.raises(ValueError): tz.tzstr(tz_str) # Different representations of the same default rule set DEFAULT_TZSTR_RULES_EQUIV_2003 = [ 'EST5EDT', 'EST5EDT4,M4.1.0/02:00:00,M10-5-0/02:00', 'EST5EDT4,95/02:00:00,298/02:00', 'EST5EDT4,J96/02:00:00,J299/02:00', 'EST5EDT4,J96/02:00:00,J299/02' ] @pytest.mark.tzstr @pytest.mark.parametrize('tz_str', DEFAULT_TZSTR_RULES_EQUIV_2003) def test_tzstr_default_start(tz_str): tzi = tz.tzstr(tz_str) dt_std = datetime(2003, 4, 6, 1, 59, tzinfo=tzi) dt_dst = datetime(2003, 4, 6, 2, 00, tzinfo=tzi) assert get_timezone_tuple(dt_std) == EST_TUPLE assert get_timezone_tuple(dt_dst) == EDT_TUPLE @pytest.mark.tzstr @pytest.mark.parametrize('tz_str', DEFAULT_TZSTR_RULES_EQUIV_2003) def test_tzstr_default_end(tz_str): tzi = tz.tzstr(tz_str) dt_dst = datetime(2003, 10, 26, 0, 59, tzinfo=tzi) dt_dst_ambig = datetime(2003, 10, 26, 1, 00, tzinfo=tzi) dt_std_ambig = tz.enfold(dt_dst_ambig, fold=1) dt_std = datetime(2003, 10, 26, 2, 00, tzinfo=tzi) assert get_timezone_tuple(dt_dst) == EDT_TUPLE assert get_timezone_tuple(dt_dst_ambig) == EDT_TUPLE assert get_timezone_tuple(dt_std_ambig) == EST_TUPLE assert get_timezone_tuple(dt_std) == EST_TUPLE @pytest.mark.tzstr @pytest.mark.parametrize('tzstr_1', ['EST5EDT', 'EST5EDT4,M4.1.0/02:00:00,M10-5-0/02:00']) @pytest.mark.parametrize('tzstr_2', ['EST5EDT', 'EST5EDT4,M4.1.0/02:00:00,M10-5-0/02:00']) def test_tzstr_default_cmp(tzstr_1, tzstr_2): tz1 = tz.tzstr(tzstr_1) tz2 = tz.tzstr(tzstr_2) assert tz1 == tz2 class TZICalTest(unittest.TestCase, TzFoldMixin): def _gettz_str_tuple(self, tzname): TZ_EST = ( 'BEGIN:VTIMEZONE', 'TZID:US-Eastern', 'BEGIN:STANDARD', 'DTSTART:19971029T020000', 'RRULE:FREQ=YEARLY;BYDAY=+1SU;BYMONTH=11', 'TZOFFSETFROM:-0400', 'TZOFFSETTO:-0500', 'TZNAME:EST', 'END:STANDARD', 'BEGIN:DAYLIGHT', 'DTSTART:19980301T020000', 'RRULE:FREQ=YEARLY;BYDAY=+2SU;BYMONTH=03', 'TZOFFSETFROM:-0500', 'TZOFFSETTO:-0400', 'TZNAME:EDT', 'END:DAYLIGHT', 'END:VTIMEZONE' ) TZ_PST = ( 'BEGIN:VTIMEZONE', 'TZID:US-Pacific', 'BEGIN:STANDARD', 'DTSTART:19971029T020000', 'RRULE:FREQ=YEARLY;BYDAY=+1SU;BYMONTH=11', 'TZOFFSETFROM:-0700', 'TZOFFSETTO:-0800', 'TZNAME:PST', 'END:STANDARD', 'BEGIN:DAYLIGHT', 'DTSTART:19980301T020000', 'RRULE:FREQ=YEARLY;BYDAY=+2SU;BYMONTH=03', 'TZOFFSETFROM:-0800', 'TZOFFSETTO:-0700', 'TZNAME:PDT', 'END:DAYLIGHT', 'END:VTIMEZONE' ) TZ_AEST = ( 'BEGIN:VTIMEZONE', 'TZID:Australia-Sydney', 'BEGIN:STANDARD', 'DTSTART:19980301T030000', 'RRULE:FREQ=YEARLY;BYDAY=+1SU;BYMONTH=04', 'TZOFFSETFROM:+1100', 'TZOFFSETTO:+1000', 'TZNAME:AEST', 'END:STANDARD', 'BEGIN:DAYLIGHT', 'DTSTART:19971029T020000', 'RRULE:FREQ=YEARLY;BYDAY=+1SU;BYMONTH=10', 'TZOFFSETFROM:+1000', 'TZOFFSETTO:+1100', 'TZNAME:AEDT', 'END:DAYLIGHT', 'END:VTIMEZONE' ) TZ_LON = ( 'BEGIN:VTIMEZONE', 'TZID:Europe-London', 'BEGIN:STANDARD', 'DTSTART:19810301T030000', 'RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=10;BYHOUR=02', 'TZOFFSETFROM:+0100', 'TZOFFSETTO:+0000', 'TZNAME:GMT', 'END:STANDARD', 'BEGIN:DAYLIGHT', 'DTSTART:19961001T030000', 'RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=03;BYHOUR=01', 'TZOFFSETFROM:+0000', 'TZOFFSETTO:+0100', 'TZNAME:BST', 'END:DAYLIGHT', 'END:VTIMEZONE' ) tzname_map = {'Australia/Sydney': TZ_AEST, 'America/Toronto': TZ_EST, 'America/New_York': TZ_EST, 'America/Los_Angeles': TZ_PST, 'Europe/London': TZ_LON} return tzname_map[tzname] def _gettz_str(self, tzname): return '\n'.join(self._gettz_str_tuple(tzname)) def _tzstr_dtstart_with_params(self, tzname, param_str): # Adds parameters to the DTSTART values of a given tzstr tz_str_tuple = self._gettz_str_tuple(tzname) out_tz = [] for line in tz_str_tuple: if line.startswith('DTSTART'): name, value = line.split(':', 1) line = name + ';' + param_str + ':' + value out_tz.append(line) return '\n'.join(out_tz) def gettz(self, tzname): tz_str = self._gettz_str(tzname) tzc = tz.tzical(StringIO(tz_str)).get() return tzc def testRepr(self): instr = StringIO(TZICAL_PST8PDT) instr.name = 'StringIO(PST8PDT)' tzc = tz.tzical(instr) self.assertEqual(repr(tzc), "tzical(" + repr(instr.name) + ")") # Test performance def _test_us_zone(self, tzc, func, values, start): if start: dt1 = datetime(2003, 3, 9, 1, 59) dt2 = datetime(2003, 3, 9, 2, 00) fold = [0, 0] else: dt1 = datetime(2003, 11, 2, 0, 59) dt2 = datetime(2003, 11, 2, 1, 00) fold = [0, 1] dts = (tz.enfold(dt.replace(tzinfo=tzc), fold=f) for dt, f in zip((dt1, dt2), fold)) for value, dt in zip(values, dts): self.assertEqual(func(dt), value) def _test_multi_zones(self, tzstrs, tzids, func, values, start): tzic = tz.tzical(StringIO('\n'.join(tzstrs))) for tzid, vals in zip(tzids, values): tzc = tzic.get(tzid) self._test_us_zone(tzc, func, vals, start) def _prepare_EST(self): tz_str = self._gettz_str('America/New_York') return tz.tzical(StringIO(tz_str)).get() def _testEST(self, start, test_type, tzc=None): if tzc is None: tzc = self._prepare_EST() argdict = { 'name': (datetime.tzname, ('EST', 'EDT')), 'offset': (datetime.utcoffset, (timedelta(hours=-5), timedelta(hours=-4))), 'dst': (datetime.dst, (timedelta(hours=0), timedelta(hours=1))) } func, values = argdict[test_type] if not start: values = reversed(values) self._test_us_zone(tzc, func, values, start=start) def testESTStartName(self): self._testEST(start=True, test_type='name') def testESTEndName(self): self._testEST(start=False, test_type='name') def testESTStartOffset(self): self._testEST(start=True, test_type='offset') def testESTEndOffset(self): self._testEST(start=False, test_type='offset') def testESTStartDST(self): self._testEST(start=True, test_type='dst') def testESTEndDST(self): self._testEST(start=False, test_type='dst') def testESTValueDatetime(self): # Violating one-test-per-test rule because we're not set up to do # parameterized tests and the manual proliferation is getting a bit # out of hand. tz_str = self._tzstr_dtstart_with_params('America/New_York', 'VALUE=DATE-TIME') tzc = tz.tzical(StringIO(tz_str)).get() for start in (True, False): for test_type in ('name', 'offset', 'dst'): self._testEST(start=start, test_type=test_type, tzc=tzc) def _testMultizone(self, start, test_type): tzstrs = (self._gettz_str('America/New_York'), self._gettz_str('America/Los_Angeles')) tzids = ('US-Eastern', 'US-Pacific') argdict = { 'name': (datetime.tzname, (('EST', 'EDT'), ('PST', 'PDT'))), 'offset': (datetime.utcoffset, ((timedelta(hours=-5), timedelta(hours=-4)), (timedelta(hours=-8), timedelta(hours=-7)))), 'dst': (datetime.dst, ((timedelta(hours=0), timedelta(hours=1)), (timedelta(hours=0), timedelta(hours=1)))) } func, values = argdict[test_type] if not start: values = map(reversed, values) self._test_multi_zones(tzstrs, tzids, func, values, start) def testMultiZoneStartName(self): self._testMultizone(start=True, test_type='name') def testMultiZoneEndName(self): self._testMultizone(start=False, test_type='name') def testMultiZoneStartOffset(self): self._testMultizone(start=True, test_type='offset') def testMultiZoneEndOffset(self): self._testMultizone(start=False, test_type='offset') def testMultiZoneStartDST(self): self._testMultizone(start=True, test_type='dst') def testMultiZoneEndDST(self): self._testMultizone(start=False, test_type='dst') def testMultiZoneKeys(self): est_str = self._gettz_str('America/New_York') pst_str = self._gettz_str('America/Los_Angeles') tzic = tz.tzical(StringIO('\n'.join((est_str, pst_str)))) # Sort keys because they are in a random order, being dictionary keys keys = sorted(tzic.keys()) self.assertEqual(keys, ['US-Eastern', 'US-Pacific']) # Test error conditions def testEmptyString(self): with self.assertRaises(ValueError): tz.tzical(StringIO("")) def testMultiZoneGet(self): tzic = tz.tzical(StringIO(TZICAL_EST5EDT + TZICAL_PST8PDT)) with self.assertRaises(ValueError): tzic.get() def testDtstartDate(self): tz_str = self._tzstr_dtstart_with_params('America/New_York', 'VALUE=DATE') with self.assertRaises(ValueError): tz.tzical(StringIO(tz_str)) def testDtstartTzid(self): tz_str = self._tzstr_dtstart_with_params('America/New_York', 'TZID=UTC') with self.assertRaises(ValueError): tz.tzical(StringIO(tz_str)) def testDtstartBadParam(self): tz_str = self._tzstr_dtstart_with_params('America/New_York', 'FOO=BAR') with self.assertRaises(ValueError): tz.tzical(StringIO(tz_str)) # Test Parsing def testGap(self): tzic = tz.tzical(StringIO('\n'.join((TZICAL_EST5EDT, TZICAL_PST8PDT)))) keys = sorted(tzic.keys()) self.assertEqual(keys, ['US-Eastern', 'US-Pacific']) class TZTest(unittest.TestCase): def testFileStart1(self): tzc = tz.tzfile(BytesIO(base64.b64decode(TZFILE_EST5EDT))) self.assertEqual(datetime(2003, 4, 6, 1, 59, tzinfo=tzc).tzname(), "EST") self.assertEqual(datetime(2003, 4, 6, 2, 00, tzinfo=tzc).tzname(), "EDT") def testFileEnd1(self): tzc = tz.tzfile(BytesIO(base64.b64decode(TZFILE_EST5EDT))) self.assertEqual(datetime(2003, 10, 26, 0, 59, tzinfo=tzc).tzname(), "EDT") end_est = tz.enfold(datetime(2003, 10, 26, 1, 00, tzinfo=tzc)) self.assertEqual(end_est.tzname(), "EST") def testFileLastTransition(self): # After the last transition, it goes to standard time in perpetuity tzc = tz.tzfile(BytesIO(base64.b64decode(TZFILE_EST5EDT))) self.assertEqual(datetime(2037, 10, 25, 0, 59, tzinfo=tzc).tzname(), "EDT") last_date = tz.enfold(datetime(2037, 10, 25, 1, 00, tzinfo=tzc), fold=1) self.assertEqual(last_date.tzname(), "EST") self.assertEqual(datetime(2038, 5, 25, 12, 0, tzinfo=tzc).tzname(), "EST") def testInvalidFile(self): # Should throw a ValueError if an invalid file is passed with self.assertRaises(ValueError): tz.tzfile(BytesIO(b'BadFile')) def testFilestreamWithNameRepr(self): # If fileobj is a filestream with a "name" attribute this name should # be reflected in the tz object's repr fileobj = BytesIO(base64.b64decode(TZFILE_EST5EDT)) fileobj.name = 'foo' tzc = tz.tzfile(fileobj) self.assertEqual(repr(tzc), 'tzfile(' + repr('foo') + ')') def testLeapCountDecodesProperly(self): # This timezone has leapcnt, and failed to decode until # Eugene Oden notified about the issue. # As leap information is currently unused (and unstored) by tzfile() we # can only indirectly test this: Take advantage of tzfile() not closing # the input file if handed in as an opened file and assert that the # full file content has been read by tzfile(). Note: For this test to # work NEW_YORK must be in TZif version 1 format i.e. no more data # after TZif v1 header + data has been read fileobj = BytesIO(base64.b64decode(NEW_YORK)) tz.tzfile(fileobj) # we expect no remaining file content now, i.e. zero-length; if there's # still data we haven't read the file format correctly remaining_tzfile_content = fileobj.read() self.assertEqual(len(remaining_tzfile_content), 0) def testIsStd(self): # NEW_YORK tzfile contains this isstd information: isstd_expected = (0, 0, 0, 1) tzc = tz.tzfile(BytesIO(base64.b64decode(NEW_YORK))) # gather the actual information as parsed by the tzfile class isstd = [] for ttinfo in tzc._ttinfo_list: # ttinfo objects contain boolean values isstd.append(int(ttinfo.isstd)) # ttinfo list may contain more entries than isstd file content isstd = tuple(isstd[:len(isstd_expected)]) self.assertEqual( isstd_expected, isstd, "isstd UTC/local indicators parsed: %s != tzfile contents: %s" % (isstd, isstd_expected)) def testGMTHasNoDaylight(self): # tz.tzstr("GMT+2") improperly considered daylight saving time. # Issue reported by Lennart Regebro. dt = datetime(2007, 8, 6, 4, 10) self.assertEqual(tz.gettz("GMT+2").dst(dt), timedelta(0)) def testGMTOffset(self): # GMT and UTC offsets have inverted signal when compared to the # usual TZ variable handling. dt = datetime(2007, 8, 6, 4, 10, tzinfo=tz.UTC) self.assertEqual(dt.astimezone(tz=tz.tzstr("GMT+2")), datetime(2007, 8, 6, 6, 10, tzinfo=tz.tzstr("GMT+2"))) self.assertEqual(dt.astimezone(tz=tz.gettz("UTC-2")), datetime(2007, 8, 6, 2, 10, tzinfo=tz.tzstr("UTC-2"))) @unittest.skipIf(IS_WIN, "requires Unix") def testTZSetDoesntCorrupt(self): # if we start in non-UTC then tzset UTC make sure parse doesn't get # confused with TZEnvContext('UTC'): # this should parse to UTC timezone not the original timezone dt = parse('2014-07-20T12:34:56+00:00') self.assertEqual(str(dt), '2014-07-20 12:34:56+00:00') @pytest.mark.tzfile @pytest.mark.skipif(not SUPPORTS_SUB_MINUTE_OFFSETS, reason='Sub-minute offsets not supported') def test_tzfile_sub_minute_offset(): # If user running python 3.6 or newer, exact offset is used tzc = tz.tzfile(BytesIO(base64.b64decode(EUROPE_HELSINKI))) offset = timedelta(hours=1, minutes=39, seconds=52) assert datetime(1900, 1, 1, 0, 0, tzinfo=tzc).utcoffset() == offset @pytest.mark.tzfile @pytest.mark.skipif(SUPPORTS_SUB_MINUTE_OFFSETS, reason='Sub-minute offsets supported.') def test_sub_minute_rounding_tzfile(): # This timezone has an offset of 5992 seconds in 1900-01-01. # For python version pre-3.6, this will be rounded tzc = tz.tzfile(BytesIO(base64.b64decode(EUROPE_HELSINKI))) offset = timedelta(hours=1, minutes=40) assert datetime(1900, 1, 1, 0, 0, tzinfo=tzc).utcoffset() == offset @pytest.mark.tzfile def test_samoa_transition(): # utcoffset() was erroneously returning +14:00 an hour early (GH #812) APIA = tz.gettz('Pacific/Apia') dt = datetime(2011, 12, 29, 23, 59, tzinfo=APIA) assert dt.utcoffset() == timedelta(hours=-10) # Make sure the transition actually works, too dt_after = (dt.astimezone(tz.UTC) + timedelta(minutes=1)).astimezone(APIA) assert dt_after == datetime(2011, 12, 31, tzinfo=APIA) assert dt_after.utcoffset() == timedelta(hours=14) @unittest.skipUnless(IS_WIN, "Requires Windows") class TzWinTest(unittest.TestCase, TzWinFoldMixin): def setUp(self): self.tzclass = tzwin.tzwin def testTzResLoadName(self): # This may not work right on non-US locales. tzr = tzwin.tzres() self.assertEqual(tzr.load_name(112), "Eastern Standard Time") def testTzResNameFromString(self): tzr = tzwin.tzres() self.assertEqual(tzr.name_from_string('@tzres.dll,-221'), 'Alaskan Daylight Time') self.assertEqual(tzr.name_from_string('Samoa Daylight Time'), 'Samoa Daylight Time') with self.assertRaises(ValueError): tzr.name_from_string('@tzres.dll,100') def testIsdstZoneWithNoDaylightSaving(self): tz = tzwin.tzwin("UTC") dt = parse("2013-03-06 19:08:15") self.assertFalse(tz._isdst(dt)) def testOffset(self): tz = tzwin.tzwin("Cape Verde Standard Time") self.assertEqual(tz.utcoffset(datetime(1995, 5, 21, 12, 9, 13)), timedelta(-1, 82800)) def testTzwinName(self): # https://github.com/dateutil/dateutil/issues/143 tw = tz.tzwin('Eastern Standard Time') # Cover the transitions for at least two years. ESTs = 'Eastern Standard Time' EDTs = 'Eastern Daylight Time' transition_dates = [(datetime(2015, 3, 8, 0, 59), ESTs), (datetime(2015, 3, 8, 3, 1), EDTs), (datetime(2015, 11, 1, 0, 59), EDTs), (datetime(2015, 11, 1, 3, 1), ESTs), (datetime(2016, 3, 13, 0, 59), ESTs), (datetime(2016, 3, 13, 3, 1), EDTs), (datetime(2016, 11, 6, 0, 59), EDTs), (datetime(2016, 11, 6, 3, 1), ESTs)] for t_date, expected in transition_dates: self.assertEqual(t_date.replace(tzinfo=tw).tzname(), expected) def testTzwinRepr(self): tw = tz.tzwin('Yakutsk Standard Time') self.assertEqual(repr(tw), 'tzwin(' + repr('Yakutsk Standard Time') + ')') def testTzWinEquality(self): # https://github.com/dateutil/dateutil/issues/151 tzwin_names = ('Eastern Standard Time', 'West Pacific Standard Time', 'Yakutsk Standard Time', 'Iran Standard Time', 'UTC') for tzwin_name in tzwin_names: # Get two different instances to compare tw1 = tz.tzwin(tzwin_name) tw2 = tz.tzwin(tzwin_name) self.assertEqual(tw1, tw2) def testTzWinInequality(self): # https://github.com/dateutil/dateutil/issues/151 # Note these last two currently differ only in their name. tzwin_names = (('Eastern Standard Time', 'Yakutsk Standard Time'), ('Greenwich Standard Time', 'GMT Standard Time'), ('GMT Standard Time', 'UTC'), ('E. South America Standard Time', 'Argentina Standard Time')) for tzwn1, tzwn2 in tzwin_names: # Get two different instances to compare tw1 = tz.tzwin(tzwn1) tw2 = tz.tzwin(tzwn2) self.assertNotEqual(tw1, tw2) def testTzWinEqualityInvalid(self): # Compare to objects that do not implement comparison with this # (should default to False) UTC = tz.UTC EST = tz.tzwin('Eastern Standard Time') self.assertFalse(EST == UTC) self.assertFalse(EST == 1) self.assertFalse(UTC == EST) self.assertTrue(EST != UTC) self.assertTrue(EST != 1) def testTzWinInequalityUnsupported(self): # Compare it to an object that is promiscuous about equality, but for # which tzwin does not implement an equality operator. EST = tz.tzwin('Eastern Standard Time') self.assertTrue(EST == ComparesEqual) self.assertFalse(EST != ComparesEqual) def testTzwinTimeOnlyDST(self): # For zones with DST, .dst() should return None tw_est = tz.tzwin('Eastern Standard Time') self.assertIs(dt_time(14, 10, tzinfo=tw_est).dst(), None) # This zone has no DST, so .dst() can return 0 tw_sast = tz.tzwin('South Africa Standard Time') self.assertEqual(dt_time(14, 10, tzinfo=tw_sast).dst(), timedelta(0)) def testTzwinTimeOnlyUTCOffset(self): # For zones with DST, .utcoffset() should return None tw_est = tz.tzwin('Eastern Standard Time') self.assertIs(dt_time(14, 10, tzinfo=tw_est).utcoffset(), None) # This zone has no DST, so .utcoffset() returns standard offset tw_sast = tz.tzwin('South Africa Standard Time') self.assertEqual(dt_time(14, 10, tzinfo=tw_sast).utcoffset(), timedelta(hours=2)) def testTzwinTimeOnlyTZName(self): # For zones with DST, the name defaults to standard time tw_est = tz.tzwin('Eastern Standard Time') self.assertEqual(dt_time(14, 10, tzinfo=tw_est).tzname(), 'Eastern Standard Time') # For zones with no DST, this should work normally. tw_sast = tz.tzwin('South Africa Standard Time') self.assertEqual(dt_time(14, 10, tzinfo=tw_sast).tzname(), 'South Africa Standard Time') @unittest.skipUnless(IS_WIN, "Requires Windows") class TzWinLocalTest(unittest.TestCase, TzWinFoldMixin): def setUp(self): self.tzclass = tzwin.tzwinlocal self.context = TZWinContext def get_args(self, tzname): return () def testLocal(self): # Not sure how to pin a local time zone, so for now we're just going # to run this and make sure it doesn't raise an error # See GitHub Issue #135: https://github.com/dateutil/dateutil/issues/135 datetime.now(tzwin.tzwinlocal()) def testTzwinLocalUTCOffset(self): with TZWinContext('Eastern Standard Time'): tzwl = tzwin.tzwinlocal() self.assertEqual(datetime(2014, 3, 11, tzinfo=tzwl).utcoffset(), timedelta(hours=-4)) def testTzwinLocalName(self): # https://github.com/dateutil/dateutil/issues/143 ESTs = 'Eastern Standard Time' EDTs = 'Eastern Daylight Time' transition_dates = [(datetime(2015, 3, 8, 0, 59), ESTs), (datetime(2015, 3, 8, 3, 1), EDTs), (datetime(2015, 11, 1, 0, 59), EDTs), (datetime(2015, 11, 1, 3, 1), ESTs), (datetime(2016, 3, 13, 0, 59), ESTs), (datetime(2016, 3, 13, 3, 1), EDTs), (datetime(2016, 11, 6, 0, 59), EDTs), (datetime(2016, 11, 6, 3, 1), ESTs)] with TZWinContext('Eastern Standard Time'): tw = tz.tzwinlocal() for t_date, expected in transition_dates: self.assertEqual(t_date.replace(tzinfo=tw).tzname(), expected) def testTzWinLocalRepr(self): tw = tz.tzwinlocal() self.assertEqual(repr(tw), 'tzwinlocal()') def testTzwinLocalRepr(self): # https://github.com/dateutil/dateutil/issues/143 with TZWinContext('Eastern Standard Time'): tw = tz.tzwinlocal() self.assertEqual(str(tw), 'tzwinlocal(' + repr('Eastern Standard Time') + ')') with TZWinContext('Pacific Standard Time'): tw = tz.tzwinlocal() self.assertEqual(str(tw), 'tzwinlocal(' + repr('Pacific Standard Time') + ')') def testTzwinLocalEquality(self): tw_est = tz.tzwin('Eastern Standard Time') tw_pst = tz.tzwin('Pacific Standard Time') with TZWinContext('Eastern Standard Time'): twl1 = tz.tzwinlocal() twl2 = tz.tzwinlocal() self.assertEqual(twl1, twl2) self.assertEqual(twl1, tw_est) self.assertNotEqual(twl1, tw_pst) with TZWinContext('Pacific Standard Time'): twl1 = tz.tzwinlocal() twl2 = tz.tzwinlocal() tw = tz.tzwin('Pacific Standard Time') self.assertEqual(twl1, twl2) self.assertEqual(twl1, tw) self.assertEqual(twl1, tw_pst) self.assertNotEqual(twl1, tw_est) def testTzwinLocalTimeOnlyDST(self): # For zones with DST, .dst() should return None with TZWinContext('Eastern Standard Time'): twl = tz.tzwinlocal() self.assertIs(dt_time(14, 10, tzinfo=twl).dst(), None) # This zone has no DST, so .dst() can return 0 with TZWinContext('South Africa Standard Time'): twl = tz.tzwinlocal() self.assertEqual(dt_time(14, 10, tzinfo=twl).dst(), timedelta(0)) def testTzwinLocalTimeOnlyUTCOffset(self): # For zones with DST, .utcoffset() should return None with TZWinContext('Eastern Standard Time'): twl = tz.tzwinlocal() self.assertIs(dt_time(14, 10, tzinfo=twl).utcoffset(), None) # This zone has no DST, so .utcoffset() returns standard offset with TZWinContext('South Africa Standard Time'): twl = tz.tzwinlocal() self.assertEqual(dt_time(14, 10, tzinfo=twl).utcoffset(), timedelta(hours=2)) def testTzwinLocalTimeOnlyTZName(self): # For zones with DST, the name defaults to standard time with TZWinContext('Eastern Standard Time'): twl = tz.tzwinlocal() self.assertEqual(dt_time(14, 10, tzinfo=twl).tzname(), 'Eastern Standard Time') # For zones with no DST, this should work normally. with TZWinContext('South Africa Standard Time'): twl = tz.tzwinlocal() self.assertEqual(dt_time(14, 10, tzinfo=twl).tzname(), 'South Africa Standard Time') class TzPickleTest(PicklableMixin, unittest.TestCase): _asfile = False def setUp(self): self.assertPicklable = partial(self.assertPicklable, asfile=self._asfile) def testPickleTzUTC(self): self.assertPicklable(tz.tzutc(), singleton=True) def testPickleTzOffsetZero(self): self.assertPicklable(tz.tzoffset('UTC', 0), singleton=True) def testPickleTzOffsetPos(self): self.assertPicklable(tz.tzoffset('UTC+1', 3600), singleton=True) def testPickleTzOffsetNeg(self): self.assertPicklable(tz.tzoffset('UTC-1', -3600), singleton=True) @pytest.mark.tzlocal def testPickleTzLocal(self): self.assertPicklable(tz.tzlocal()) def testPickleTzFileEST5EDT(self): tzc = tz.tzfile(BytesIO(base64.b64decode(TZFILE_EST5EDT))) self.assertPicklable(tzc) def testPickleTzFileEurope_Helsinki(self): tzc = tz.tzfile(BytesIO(base64.b64decode(EUROPE_HELSINKI))) self.assertPicklable(tzc) def testPickleTzFileNew_York(self): tzc = tz.tzfile(BytesIO(base64.b64decode(NEW_YORK))) self.assertPicklable(tzc) @unittest.skip("Known failure") def testPickleTzICal(self): tzc = tz.tzical(StringIO(TZICAL_EST5EDT)).get() self.assertPicklable(tzc) def testPickleTzGettz(self): self.assertPicklable(tz.gettz('America/New_York')) def testPickleZoneFileGettz(self): zoneinfo_file = zoneinfo.get_zonefile_instance() tzi = zoneinfo_file.get('America/New_York') self.assertIsNot(tzi, None) self.assertPicklable(tzi) class TzPickleFileTest(TzPickleTest): """ Run all the TzPickleTest tests, using a temporary file """ _asfile = True class DatetimeAmbiguousTest(unittest.TestCase): """ Test the datetime_exists / datetime_ambiguous functions """ def testNoTzSpecified(self): with self.assertRaises(ValueError): tz.datetime_ambiguous(datetime(2016, 4, 1, 2, 9)) def _get_no_support_tzinfo_class(self, dt_start, dt_end, dst_only=False): # Generates a class of tzinfo with no support for is_ambiguous # where dates between dt_start and dt_end are ambiguous. class FoldingTzInfo(tzinfo): def utcoffset(self, dt): if not dst_only: dt_n = dt.replace(tzinfo=None) if dt_start <= dt_n < dt_end and getattr(dt_n, 'fold', 0): return timedelta(hours=-1) return timedelta(hours=0) def dst(self, dt): dt_n = dt.replace(tzinfo=None) if dt_start <= dt_n < dt_end and getattr(dt_n, 'fold', 0): return timedelta(hours=1) else: return timedelta(0) return FoldingTzInfo def _get_no_support_tzinfo(self, dt_start, dt_end, dst_only=False): return self._get_no_support_tzinfo_class(dt_start, dt_end, dst_only)() def testNoSupportAmbiguityFoldNaive(self): dt_start = datetime(2018, 9, 1, 1, 0) dt_end = datetime(2018, 9, 1, 2, 0) tzi = self._get_no_support_tzinfo(dt_start, dt_end) self.assertTrue(tz.datetime_ambiguous(datetime(2018, 9, 1, 1, 30), tz=tzi)) def testNoSupportAmbiguityFoldAware(self): dt_start = datetime(2018, 9, 1, 1, 0) dt_end = datetime(2018, 9, 1, 2, 0) tzi = self._get_no_support_tzinfo(dt_start, dt_end) self.assertTrue(tz.datetime_ambiguous(datetime(2018, 9, 1, 1, 30, tzinfo=tzi))) def testNoSupportAmbiguityUnambiguousNaive(self): dt_start = datetime(2018, 9, 1, 1, 0) dt_end = datetime(2018, 9, 1, 2, 0) tzi = self._get_no_support_tzinfo(dt_start, dt_end) self.assertFalse(tz.datetime_ambiguous(datetime(2018, 10, 1, 12, 30), tz=tzi)) def testNoSupportAmbiguityUnambiguousAware(self): dt_start = datetime(2018, 9, 1, 1, 0) dt_end = datetime(2018, 9, 1, 2, 0) tzi = self._get_no_support_tzinfo(dt_start, dt_end) self.assertFalse(tz.datetime_ambiguous(datetime(2018, 10, 1, 12, 30, tzinfo=tzi))) def testNoSupportAmbiguityFoldDSTOnly(self): dt_start = datetime(2018, 9, 1, 1, 0) dt_end = datetime(2018, 9, 1, 2, 0) tzi = self._get_no_support_tzinfo(dt_start, dt_end, dst_only=True) self.assertTrue(tz.datetime_ambiguous(datetime(2018, 9, 1, 1, 30), tz=tzi)) def testNoSupportAmbiguityUnambiguousDSTOnly(self): dt_start = datetime(2018, 9, 1, 1, 0) dt_end = datetime(2018, 9, 1, 2, 0) tzi = self._get_no_support_tzinfo(dt_start, dt_end, dst_only=True) self.assertFalse(tz.datetime_ambiguous(datetime(2018, 10, 1, 12, 30), tz=tzi)) def testSupportAmbiguityFoldNaive(self): tzi = tz.gettz('US/Eastern') dt = datetime(2011, 11, 6, 1, 30) self.assertTrue(tz.datetime_ambiguous(dt, tz=tzi)) def testSupportAmbiguityFoldAware(self): tzi = tz.gettz('US/Eastern') dt = datetime(2011, 11, 6, 1, 30, tzinfo=tzi) self.assertTrue(tz.datetime_ambiguous(dt)) def testSupportAmbiguityUnambiguousAware(self): tzi = tz.gettz('US/Eastern') dt = datetime(2011, 11, 6, 4, 30) self.assertFalse(tz.datetime_ambiguous(dt, tz=tzi)) def testSupportAmbiguityUnambiguousNaive(self): tzi = tz.gettz('US/Eastern') dt = datetime(2011, 11, 6, 4, 30, tzinfo=tzi) self.assertFalse(tz.datetime_ambiguous(dt)) def _get_ambig_error_tzinfo(self, dt_start, dt_end, dst_only=False): cTzInfo = self._get_no_support_tzinfo_class(dt_start, dt_end, dst_only) # Takes the wrong number of arguments and raises an error anyway. class FoldTzInfoRaises(cTzInfo): def is_ambiguous(self, dt, other_arg): raise NotImplementedError('This is not implemented') return FoldTzInfoRaises() def testIncompatibleAmbiguityFoldNaive(self): dt_start = datetime(2018, 9, 1, 1, 0) dt_end = datetime(2018, 9, 1, 2, 0) tzi = self._get_ambig_error_tzinfo(dt_start, dt_end) self.assertTrue(tz.datetime_ambiguous(datetime(2018, 9, 1, 1, 30), tz=tzi)) def testIncompatibleAmbiguityFoldAware(self): dt_start = datetime(2018, 9, 1, 1, 0) dt_end = datetime(2018, 9, 1, 2, 0) tzi = self._get_ambig_error_tzinfo(dt_start, dt_end) self.assertTrue(tz.datetime_ambiguous(datetime(2018, 9, 1, 1, 30, tzinfo=tzi))) def testIncompatibleAmbiguityUnambiguousNaive(self): dt_start = datetime(2018, 9, 1, 1, 0) dt_end = datetime(2018, 9, 1, 2, 0) tzi = self._get_ambig_error_tzinfo(dt_start, dt_end) self.assertFalse(tz.datetime_ambiguous(datetime(2018, 10, 1, 12, 30), tz=tzi)) def testIncompatibleAmbiguityUnambiguousAware(self): dt_start = datetime(2018, 9, 1, 1, 0) dt_end = datetime(2018, 9, 1, 2, 0) tzi = self._get_ambig_error_tzinfo(dt_start, dt_end) self.assertFalse(tz.datetime_ambiguous(datetime(2018, 10, 1, 12, 30, tzinfo=tzi))) def testIncompatibleAmbiguityFoldDSTOnly(self): dt_start = datetime(2018, 9, 1, 1, 0) dt_end = datetime(2018, 9, 1, 2, 0) tzi = self._get_ambig_error_tzinfo(dt_start, dt_end, dst_only=True) self.assertTrue(tz.datetime_ambiguous(datetime(2018, 9, 1, 1, 30), tz=tzi)) def testIncompatibleAmbiguityUnambiguousDSTOnly(self): dt_start = datetime(2018, 9, 1, 1, 0) dt_end = datetime(2018, 9, 1, 2, 0) tzi = self._get_ambig_error_tzinfo(dt_start, dt_end, dst_only=True) self.assertFalse(tz.datetime_ambiguous(datetime(2018, 10, 1, 12, 30), tz=tzi)) def testSpecifiedTzOverridesAttached(self): # If a tz is specified, the datetime will be treated as naive. # This is not ambiguous in the local zone dt = datetime(2011, 11, 6, 1, 30, tzinfo=tz.gettz('Australia/Sydney')) self.assertFalse(tz.datetime_ambiguous(dt)) tzi = tz.gettz('US/Eastern') self.assertTrue(tz.datetime_ambiguous(dt, tz=tzi)) class DatetimeExistsTest(unittest.TestCase): def testNoTzSpecified(self): with self.assertRaises(ValueError): tz.datetime_exists(datetime(2016, 4, 1, 2, 9)) def testInGapNaive(self): tzi = tz.gettz('Australia/Sydney') dt = datetime(2012, 10, 7, 2, 30) self.assertFalse(tz.datetime_exists(dt, tz=tzi)) def testInGapAware(self): tzi = tz.gettz('Australia/Sydney') dt = datetime(2012, 10, 7, 2, 30, tzinfo=tzi) self.assertFalse(tz.datetime_exists(dt)) def testExistsNaive(self): tzi = tz.gettz('Australia/Sydney') dt = datetime(2012, 10, 7, 10, 30) self.assertTrue(tz.datetime_exists(dt, tz=tzi)) def testExistsAware(self): tzi = tz.gettz('Australia/Sydney') dt = datetime(2012, 10, 7, 10, 30, tzinfo=tzi) self.assertTrue(tz.datetime_exists(dt)) def testSpecifiedTzOverridesAttached(self): EST = tz.gettz('US/Eastern') AEST = tz.gettz('Australia/Sydney') dt = datetime(2012, 10, 7, 2, 30, tzinfo=EST) # This time exists self.assertFalse(tz.datetime_exists(dt, tz=AEST)) class TestEnfold: def test_enter_fold_default(self): dt = tz.enfold(datetime(2020, 1, 19, 3, 32)) assert dt.fold == 1 def test_enter_fold(self): dt = tz.enfold(datetime(2020, 1, 19, 3, 32), fold=1) assert dt.fold == 1 def test_exit_fold(self): dt = tz.enfold(datetime(2020, 1, 19, 3, 32), fold=0) # Before Python 3.6, dt.fold won't exist if fold is 0. assert getattr(dt, 'fold', 0) == 0 def test_defold(self): dt = tz.enfold(datetime(2020, 1, 19, 3, 32), fold=1) dt2 = tz.enfold(dt, fold=0) assert getattr(dt2, 'fold', 0) == 0 def test_fold_replace_args(self): # This test can be dropped when Python < 3.6 is dropped, since it # is mainly to cover the `replace` method on _DatetimeWithFold dt = tz.enfold(datetime(1950, 1, 2, 12, 30, 15, 8), fold=1) dt2 = dt.replace(1952, 2, 3, 13, 31, 16, 9) assert dt2 == tz.enfold(datetime(1952, 2, 3, 13, 31, 16, 9), fold=1) assert dt2.fold == 1 def test_fold_replace_exception_duplicate_args(self): dt = tz.enfold(datetime(1999, 1, 3), fold=1) with pytest.raises(TypeError): dt.replace(1950, year=2000) @pytest.mark.tz_resolve_imaginary class ImaginaryDateTest(unittest.TestCase): def testCanberraForward(self): tzi = tz.gettz('Australia/Canberra') dt = datetime(2018, 10, 7, 2, 30, tzinfo=tzi) dt_act = tz.resolve_imaginary(dt) dt_exp = datetime(2018, 10, 7, 3, 30, tzinfo=tzi) self.assertEqual(dt_act, dt_exp) def testLondonForward(self): tzi = tz.gettz('Europe/London') dt = datetime(2018, 3, 25, 1, 30, tzinfo=tzi) dt_act = tz.resolve_imaginary(dt) dt_exp = datetime(2018, 3, 25, 2, 30, tzinfo=tzi) self.assertEqual(dt_act, dt_exp) def testKeivForward(self): tzi = tz.gettz('Europe/Kiev') dt = datetime(2018, 3, 25, 3, 30, tzinfo=tzi) dt_act = tz.resolve_imaginary(dt) dt_exp = datetime(2018, 3, 25, 4, 30, tzinfo=tzi) self.assertEqual(dt_act, dt_exp) @pytest.mark.tz_resolve_imaginary @pytest.mark.parametrize('dt', [ datetime(2017, 11, 5, 1, 30, tzinfo=tz.gettz('America/New_York')), datetime(2018, 10, 28, 1, 30, tzinfo=tz.gettz('Europe/London')), datetime(2017, 4, 2, 2, 30, tzinfo=tz.gettz('Australia/Sydney')), ]) def test_resolve_imaginary_ambiguous(dt): assert tz.resolve_imaginary(dt) is dt dt_f = tz.enfold(dt) assert dt is not dt_f assert tz.resolve_imaginary(dt_f) is dt_f @pytest.mark.tz_resolve_imaginary @pytest.mark.parametrize('dt', [ datetime(2017, 6, 2, 12, 30, tzinfo=tz.gettz('America/New_York')), datetime(2018, 4, 2, 9, 30, tzinfo=tz.gettz('Europe/London')), datetime(2017, 2, 2, 16, 30, tzinfo=tz.gettz('Australia/Sydney')), datetime(2017, 12, 2, 12, 30, tzinfo=tz.gettz('America/New_York')), datetime(2018, 12, 2, 9, 30, tzinfo=tz.gettz('Europe/London')), datetime(2017, 6, 2, 16, 30, tzinfo=tz.gettz('Australia/Sydney')), datetime(2025, 9, 25, 1, 17, tzinfo=tz.UTC), datetime(2025, 9, 25, 1, 17, tzinfo=tz.tzoffset('EST', -18000)), datetime(2019, 3, 4, tzinfo=None) ]) def test_resolve_imaginary_existing(dt): assert tz.resolve_imaginary(dt) is dt def __get_kiritimati_resolve_imaginary_test(): # In the 2018d release of the IANA database, the Kiritimati "imaginary day" # data was corrected, so if the system zoneinfo is older than 2018d, the # Kiritimati test will fail. tzi = tz.gettz('Pacific/Kiritimati') new_version = False if not tz.datetime_exists(datetime(1995, 1, 1, 12, 30), tzi): zif = zoneinfo.get_zonefile_instance() if zif.metadata is not None: new_version = zif.metadata['tzversion'] >= '2018d' if new_version: tzi = zif.get('Pacific/Kiritimati') else: new_version = True if new_version: dates = (datetime(1994, 12, 31, 12, 30), datetime(1995, 1, 1, 12, 30)) else: dates = (datetime(1995, 1, 1, 12, 30), datetime(1995, 1, 2, 12, 30)) return (tzi, ) + dates resolve_imaginary_tests = [ (tz.gettz('Europe/London'), datetime(2018, 3, 25, 1, 30), datetime(2018, 3, 25, 2, 30)), (tz.gettz('America/New_York'), datetime(2017, 3, 12, 2, 30), datetime(2017, 3, 12, 3, 30)), (tz.gettz('Australia/Sydney'), datetime(2014, 10, 5, 2, 0), datetime(2014, 10, 5, 3, 0)), __get_kiritimati_resolve_imaginary_test(), ] if SUPPORTS_SUB_MINUTE_OFFSETS: resolve_imaginary_tests.append( (tz.gettz('Africa/Monrovia'), datetime(1972, 1, 7, 0, 30), datetime(1972, 1, 7, 1, 14, 30))) @pytest.mark.tz_resolve_imaginary @pytest.mark.parametrize('tzi, dt, dt_exp', resolve_imaginary_tests) def test_resolve_imaginary(tzi, dt, dt_exp): dt = dt.replace(tzinfo=tzi) dt_exp = dt_exp.replace(tzinfo=tzi) dt_r = tz.resolve_imaginary(dt) assert dt_r == dt_exp assert dt_r.tzname() == dt_exp.tzname() assert dt_r.utcoffset() == dt_exp.utcoffset() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/test/test_utils.py0000644000175100001710000000266100000000000021565 0ustar00runnerdocker# -*- coding: utf-8 -*- from __future__ import unicode_literals from datetime import timedelta, datetime from dateutil import tz from dateutil import utils from dateutil.tz import UTC from dateutil.utils import within_delta from freezegun import freeze_time NYC = tz.gettz("America/New_York") @freeze_time(datetime(2014, 12, 15, 1, 21, 33, 4003)) def test_utils_today(): assert utils.today() == datetime(2014, 12, 15, 0, 0, 0) @freeze_time(datetime(2014, 12, 15, 12), tz_offset=5) def test_utils_today_tz_info(): assert utils.today(NYC) == datetime(2014, 12, 15, 0, 0, 0, tzinfo=NYC) @freeze_time(datetime(2014, 12, 15, 23), tz_offset=5) def test_utils_today_tz_info_different_day(): assert utils.today(UTC) == datetime(2014, 12, 16, 0, 0, 0, tzinfo=UTC) def test_utils_default_tz_info_naive(): dt = datetime(2014, 9, 14, 9, 30) assert utils.default_tzinfo(dt, NYC).tzinfo is NYC def test_utils_default_tz_info_aware(): dt = datetime(2014, 9, 14, 9, 30, tzinfo=UTC) assert utils.default_tzinfo(dt, NYC).tzinfo is UTC def test_utils_within_delta(): d1 = datetime(2016, 1, 1, 12, 14, 1, 9) d2 = d1.replace(microsecond=15) assert within_delta(d1, d2, timedelta(seconds=1)) assert not within_delta(d1, d2, timedelta(microseconds=1)) def test_utils_within_delta_with_negative_delta(): d1 = datetime(2016, 1, 1) d2 = datetime(2015, 12, 31) assert within_delta(d2, d1, timedelta(days=-1)) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1618729 python-dateutil-2.8.2/dateutil/tz/0000755000175100001710000000000000000000000016465 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/tz/__init__.py0000644000175100001710000000067400000000000020605 0ustar00runnerdocker# -*- coding: utf-8 -*- from .tz import * from .tz import __doc__ __all__ = ["tzutc", "tzoffset", "tzlocal", "tzfile", "tzrange", "tzstr", "tzical", "tzwin", "tzwinlocal", "gettz", "enfold", "datetime_ambiguous", "datetime_exists", "resolve_imaginary", "UTC", "DeprecatedTzFormatWarning"] class DeprecatedTzFormatWarning(Warning): """Warning raised when time zones are parsed from deprecated formats.""" ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/tz/_common.py0000644000175100001710000003126100000000000020471 0ustar00runnerdockerfrom six import PY2 from functools import wraps from datetime import datetime, timedelta, tzinfo ZERO = timedelta(0) __all__ = ['tzname_in_python2', 'enfold'] def tzname_in_python2(namefunc): """Change unicode output into bytestrings in Python 2 tzname() API changed in Python 3. It used to return bytes, but was changed to unicode strings """ if PY2: @wraps(namefunc) def adjust_encoding(*args, **kwargs): name = namefunc(*args, **kwargs) if name is not None: name = name.encode() return name return adjust_encoding else: return namefunc # The following is adapted from Alexander Belopolsky's tz library # https://github.com/abalkin/tz if hasattr(datetime, 'fold'): # This is the pre-python 3.6 fold situation def enfold(dt, fold=1): """ Provides a unified interface for assigning the ``fold`` attribute to datetimes both before and after the implementation of PEP-495. :param fold: The value for the ``fold`` attribute in the returned datetime. This should be either 0 or 1. :return: Returns an object for which ``getattr(dt, 'fold', 0)`` returns ``fold`` for all versions of Python. In versions prior to Python 3.6, this is a ``_DatetimeWithFold`` object, which is a subclass of :py:class:`datetime.datetime` with the ``fold`` attribute added, if ``fold`` is 1. .. versionadded:: 2.6.0 """ return dt.replace(fold=fold) else: class _DatetimeWithFold(datetime): """ This is a class designed to provide a PEP 495-compliant interface for Python versions before 3.6. It is used only for dates in a fold, so the ``fold`` attribute is fixed at ``1``. .. versionadded:: 2.6.0 """ __slots__ = () def replace(self, *args, **kwargs): """ Return a datetime with the same attributes, except for those attributes given new values by whichever keyword arguments are specified. Note that tzinfo=None can be specified to create a naive datetime from an aware datetime with no conversion of date and time data. This is reimplemented in ``_DatetimeWithFold`` because pypy3 will return a ``datetime.datetime`` even if ``fold`` is unchanged. """ argnames = ( 'year', 'month', 'day', 'hour', 'minute', 'second', 'microsecond', 'tzinfo' ) for arg, argname in zip(args, argnames): if argname in kwargs: raise TypeError('Duplicate argument: {}'.format(argname)) kwargs[argname] = arg for argname in argnames: if argname not in kwargs: kwargs[argname] = getattr(self, argname) dt_class = self.__class__ if kwargs.get('fold', 1) else datetime return dt_class(**kwargs) @property def fold(self): return 1 def enfold(dt, fold=1): """ Provides a unified interface for assigning the ``fold`` attribute to datetimes both before and after the implementation of PEP-495. :param fold: The value for the ``fold`` attribute in the returned datetime. This should be either 0 or 1. :return: Returns an object for which ``getattr(dt, 'fold', 0)`` returns ``fold`` for all versions of Python. In versions prior to Python 3.6, this is a ``_DatetimeWithFold`` object, which is a subclass of :py:class:`datetime.datetime` with the ``fold`` attribute added, if ``fold`` is 1. .. versionadded:: 2.6.0 """ if getattr(dt, 'fold', 0) == fold: return dt args = dt.timetuple()[:6] args += (dt.microsecond, dt.tzinfo) if fold: return _DatetimeWithFold(*args) else: return datetime(*args) def _validate_fromutc_inputs(f): """ The CPython version of ``fromutc`` checks that the input is a ``datetime`` object and that ``self`` is attached as its ``tzinfo``. """ @wraps(f) def fromutc(self, dt): if not isinstance(dt, datetime): raise TypeError("fromutc() requires a datetime argument") if dt.tzinfo is not self: raise ValueError("dt.tzinfo is not self") return f(self, dt) return fromutc class _tzinfo(tzinfo): """ Base class for all ``dateutil`` ``tzinfo`` objects. """ def is_ambiguous(self, dt): """ Whether or not the "wall time" of a given datetime is ambiguous in this zone. :param dt: A :py:class:`datetime.datetime`, naive or time zone aware. :return: Returns ``True`` if ambiguous, ``False`` otherwise. .. versionadded:: 2.6.0 """ dt = dt.replace(tzinfo=self) wall_0 = enfold(dt, fold=0) wall_1 = enfold(dt, fold=1) same_offset = wall_0.utcoffset() == wall_1.utcoffset() same_dt = wall_0.replace(tzinfo=None) == wall_1.replace(tzinfo=None) return same_dt and not same_offset def _fold_status(self, dt_utc, dt_wall): """ Determine the fold status of a "wall" datetime, given a representation of the same datetime as a (naive) UTC datetime. This is calculated based on the assumption that ``dt.utcoffset() - dt.dst()`` is constant for all datetimes, and that this offset is the actual number of hours separating ``dt_utc`` and ``dt_wall``. :param dt_utc: Representation of the datetime as UTC :param dt_wall: Representation of the datetime as "wall time". This parameter must either have a `fold` attribute or have a fold-naive :class:`datetime.tzinfo` attached, otherwise the calculation may fail. """ if self.is_ambiguous(dt_wall): delta_wall = dt_wall - dt_utc _fold = int(delta_wall == (dt_utc.utcoffset() - dt_utc.dst())) else: _fold = 0 return _fold def _fold(self, dt): return getattr(dt, 'fold', 0) def _fromutc(self, dt): """ Given a timezone-aware datetime in a given timezone, calculates a timezone-aware datetime in a new timezone. Since this is the one time that we *know* we have an unambiguous datetime object, we take this opportunity to determine whether the datetime is ambiguous and in a "fold" state (e.g. if it's the first occurrence, chronologically, of the ambiguous datetime). :param dt: A timezone-aware :class:`datetime.datetime` object. """ # Re-implement the algorithm from Python's datetime.py dtoff = dt.utcoffset() if dtoff is None: raise ValueError("fromutc() requires a non-None utcoffset() " "result") # The original datetime.py code assumes that `dst()` defaults to # zero during ambiguous times. PEP 495 inverts this presumption, so # for pre-PEP 495 versions of python, we need to tweak the algorithm. dtdst = dt.dst() if dtdst is None: raise ValueError("fromutc() requires a non-None dst() result") delta = dtoff - dtdst dt += delta # Set fold=1 so we can default to being in the fold for # ambiguous dates. dtdst = enfold(dt, fold=1).dst() if dtdst is None: raise ValueError("fromutc(): dt.dst gave inconsistent " "results; cannot convert") return dt + dtdst @_validate_fromutc_inputs def fromutc(self, dt): """ Given a timezone-aware datetime in a given timezone, calculates a timezone-aware datetime in a new timezone. Since this is the one time that we *know* we have an unambiguous datetime object, we take this opportunity to determine whether the datetime is ambiguous and in a "fold" state (e.g. if it's the first occurrence, chronologically, of the ambiguous datetime). :param dt: A timezone-aware :class:`datetime.datetime` object. """ dt_wall = self._fromutc(dt) # Calculate the fold status given the two datetimes. _fold = self._fold_status(dt, dt_wall) # Set the default fold value for ambiguous dates return enfold(dt_wall, fold=_fold) class tzrangebase(_tzinfo): """ This is an abstract base class for time zones represented by an annual transition into and out of DST. Child classes should implement the following methods: * ``__init__(self, *args, **kwargs)`` * ``transitions(self, year)`` - this is expected to return a tuple of datetimes representing the DST on and off transitions in standard time. A fully initialized ``tzrangebase`` subclass should also provide the following attributes: * ``hasdst``: Boolean whether or not the zone uses DST. * ``_dst_offset`` / ``_std_offset``: :class:`datetime.timedelta` objects representing the respective UTC offsets. * ``_dst_abbr`` / ``_std_abbr``: Strings representing the timezone short abbreviations in DST and STD, respectively. * ``_hasdst``: Whether or not the zone has DST. .. versionadded:: 2.6.0 """ def __init__(self): raise NotImplementedError('tzrangebase is an abstract base class') def utcoffset(self, dt): isdst = self._isdst(dt) if isdst is None: return None elif isdst: return self._dst_offset else: return self._std_offset def dst(self, dt): isdst = self._isdst(dt) if isdst is None: return None elif isdst: return self._dst_base_offset else: return ZERO @tzname_in_python2 def tzname(self, dt): if self._isdst(dt): return self._dst_abbr else: return self._std_abbr def fromutc(self, dt): """ Given a datetime in UTC, return local time """ if not isinstance(dt, datetime): raise TypeError("fromutc() requires a datetime argument") if dt.tzinfo is not self: raise ValueError("dt.tzinfo is not self") # Get transitions - if there are none, fixed offset transitions = self.transitions(dt.year) if transitions is None: return dt + self.utcoffset(dt) # Get the transition times in UTC dston, dstoff = transitions dston -= self._std_offset dstoff -= self._std_offset utc_transitions = (dston, dstoff) dt_utc = dt.replace(tzinfo=None) isdst = self._naive_isdst(dt_utc, utc_transitions) if isdst: dt_wall = dt + self._dst_offset else: dt_wall = dt + self._std_offset _fold = int(not isdst and self.is_ambiguous(dt_wall)) return enfold(dt_wall, fold=_fold) def is_ambiguous(self, dt): """ Whether or not the "wall time" of a given datetime is ambiguous in this zone. :param dt: A :py:class:`datetime.datetime`, naive or time zone aware. :return: Returns ``True`` if ambiguous, ``False`` otherwise. .. versionadded:: 2.6.0 """ if not self.hasdst: return False start, end = self.transitions(dt.year) dt = dt.replace(tzinfo=None) return (end <= dt < end + self._dst_base_offset) def _isdst(self, dt): if not self.hasdst: return False elif dt is None: return None transitions = self.transitions(dt.year) if transitions is None: return False dt = dt.replace(tzinfo=None) isdst = self._naive_isdst(dt, transitions) # Handle ambiguous dates if not isdst and self.is_ambiguous(dt): return not self._fold(dt) else: return isdst def _naive_isdst(self, dt, transitions): dston, dstoff = transitions dt = dt.replace(tzinfo=None) if dston < dstoff: isdst = dston <= dt < dstoff else: isdst = not dstoff <= dt < dston return isdst @property def _dst_base_offset(self): return self._dst_offset - self._std_offset __hash__ = None def __ne__(self, other): return not (self == other) def __repr__(self): return "%s(...)" % self.__class__.__name__ __reduce__ = object.__reduce__ ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/tz/_factories.py0000644000175100001710000000501100000000000021152 0ustar00runnerdockerfrom datetime import timedelta import weakref from collections import OrderedDict from six.moves import _thread class _TzSingleton(type): def __init__(cls, *args, **kwargs): cls.__instance = None super(_TzSingleton, cls).__init__(*args, **kwargs) def __call__(cls): if cls.__instance is None: cls.__instance = super(_TzSingleton, cls).__call__() return cls.__instance class _TzFactory(type): def instance(cls, *args, **kwargs): """Alternate constructor that returns a fresh instance""" return type.__call__(cls, *args, **kwargs) class _TzOffsetFactory(_TzFactory): def __init__(cls, *args, **kwargs): cls.__instances = weakref.WeakValueDictionary() cls.__strong_cache = OrderedDict() cls.__strong_cache_size = 8 cls._cache_lock = _thread.allocate_lock() def __call__(cls, name, offset): if isinstance(offset, timedelta): key = (name, offset.total_seconds()) else: key = (name, offset) instance = cls.__instances.get(key, None) if instance is None: instance = cls.__instances.setdefault(key, cls.instance(name, offset)) # This lock may not be necessary in Python 3. See GH issue #901 with cls._cache_lock: cls.__strong_cache[key] = cls.__strong_cache.pop(key, instance) # Remove an item if the strong cache is overpopulated if len(cls.__strong_cache) > cls.__strong_cache_size: cls.__strong_cache.popitem(last=False) return instance class _TzStrFactory(_TzFactory): def __init__(cls, *args, **kwargs): cls.__instances = weakref.WeakValueDictionary() cls.__strong_cache = OrderedDict() cls.__strong_cache_size = 8 cls.__cache_lock = _thread.allocate_lock() def __call__(cls, s, posix_offset=False): key = (s, posix_offset) instance = cls.__instances.get(key, None) if instance is None: instance = cls.__instances.setdefault(key, cls.instance(s, posix_offset)) # This lock may not be necessary in Python 3. See GH issue #901 with cls.__cache_lock: cls.__strong_cache[key] = cls.__strong_cache.pop(key, instance) # Remove an item if the strong cache is overpopulated if len(cls.__strong_cache) > cls.__strong_cache_size: cls.__strong_cache.popitem(last=False) return instance ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/tz/tz.py0000644000175100001710000017261100000000000017504 0ustar00runnerdocker# -*- coding: utf-8 -*- """ This module offers timezone implementations subclassing the abstract :py:class:`datetime.tzinfo` type. There are classes to handle tzfile format files (usually are in :file:`/etc/localtime`, :file:`/usr/share/zoneinfo`, etc), TZ environment string (in all known formats), given ranges (with help from relative deltas), local machine timezone, fixed offset timezone, and UTC timezone. """ import datetime import struct import time import sys import os import bisect import weakref from collections import OrderedDict import six from six import string_types from six.moves import _thread from ._common import tzname_in_python2, _tzinfo from ._common import tzrangebase, enfold from ._common import _validate_fromutc_inputs from ._factories import _TzSingleton, _TzOffsetFactory from ._factories import _TzStrFactory try: from .win import tzwin, tzwinlocal except ImportError: tzwin = tzwinlocal = None # For warning about rounding tzinfo from warnings import warn ZERO = datetime.timedelta(0) EPOCH = datetime.datetime.utcfromtimestamp(0) EPOCHORDINAL = EPOCH.toordinal() @six.add_metaclass(_TzSingleton) class tzutc(datetime.tzinfo): """ This is a tzinfo object that represents the UTC time zone. **Examples:** .. doctest:: >>> from datetime import * >>> from dateutil.tz import * >>> datetime.now() datetime.datetime(2003, 9, 27, 9, 40, 1, 521290) >>> datetime.now(tzutc()) datetime.datetime(2003, 9, 27, 12, 40, 12, 156379, tzinfo=tzutc()) >>> datetime.now(tzutc()).tzname() 'UTC' .. versionchanged:: 2.7.0 ``tzutc()`` is now a singleton, so the result of ``tzutc()`` will always return the same object. .. doctest:: >>> from dateutil.tz import tzutc, UTC >>> tzutc() is tzutc() True >>> tzutc() is UTC True """ def utcoffset(self, dt): return ZERO def dst(self, dt): return ZERO @tzname_in_python2 def tzname(self, dt): return "UTC" def is_ambiguous(self, dt): """ Whether or not the "wall time" of a given datetime is ambiguous in this zone. :param dt: A :py:class:`datetime.datetime`, naive or time zone aware. :return: Returns ``True`` if ambiguous, ``False`` otherwise. .. versionadded:: 2.6.0 """ return False @_validate_fromutc_inputs def fromutc(self, dt): """ Fast track version of fromutc() returns the original ``dt`` object for any valid :py:class:`datetime.datetime` object. """ return dt def __eq__(self, other): if not isinstance(other, (tzutc, tzoffset)): return NotImplemented return (isinstance(other, tzutc) or (isinstance(other, tzoffset) and other._offset == ZERO)) __hash__ = None def __ne__(self, other): return not (self == other) def __repr__(self): return "%s()" % self.__class__.__name__ __reduce__ = object.__reduce__ #: Convenience constant providing a :class:`tzutc()` instance #: #: .. versionadded:: 2.7.0 UTC = tzutc() @six.add_metaclass(_TzOffsetFactory) class tzoffset(datetime.tzinfo): """ A simple class for representing a fixed offset from UTC. :param name: The timezone name, to be returned when ``tzname()`` is called. :param offset: The time zone offset in seconds, or (since version 2.6.0, represented as a :py:class:`datetime.timedelta` object). """ def __init__(self, name, offset): self._name = name try: # Allow a timedelta offset = offset.total_seconds() except (TypeError, AttributeError): pass self._offset = datetime.timedelta(seconds=_get_supported_offset(offset)) def utcoffset(self, dt): return self._offset def dst(self, dt): return ZERO @tzname_in_python2 def tzname(self, dt): return self._name @_validate_fromutc_inputs def fromutc(self, dt): return dt + self._offset def is_ambiguous(self, dt): """ Whether or not the "wall time" of a given datetime is ambiguous in this zone. :param dt: A :py:class:`datetime.datetime`, naive or time zone aware. :return: Returns ``True`` if ambiguous, ``False`` otherwise. .. versionadded:: 2.6.0 """ return False def __eq__(self, other): if not isinstance(other, tzoffset): return NotImplemented return self._offset == other._offset __hash__ = None def __ne__(self, other): return not (self == other) def __repr__(self): return "%s(%s, %s)" % (self.__class__.__name__, repr(self._name), int(self._offset.total_seconds())) __reduce__ = object.__reduce__ class tzlocal(_tzinfo): """ A :class:`tzinfo` subclass built around the ``time`` timezone functions. """ def __init__(self): super(tzlocal, self).__init__() self._std_offset = datetime.timedelta(seconds=-time.timezone) if time.daylight: self._dst_offset = datetime.timedelta(seconds=-time.altzone) else: self._dst_offset = self._std_offset self._dst_saved = self._dst_offset - self._std_offset self._hasdst = bool(self._dst_saved) self._tznames = tuple(time.tzname) def utcoffset(self, dt): if dt is None and self._hasdst: return None if self._isdst(dt): return self._dst_offset else: return self._std_offset def dst(self, dt): if dt is None and self._hasdst: return None if self._isdst(dt): return self._dst_offset - self._std_offset else: return ZERO @tzname_in_python2 def tzname(self, dt): return self._tznames[self._isdst(dt)] def is_ambiguous(self, dt): """ Whether or not the "wall time" of a given datetime is ambiguous in this zone. :param dt: A :py:class:`datetime.datetime`, naive or time zone aware. :return: Returns ``True`` if ambiguous, ``False`` otherwise. .. versionadded:: 2.6.0 """ naive_dst = self._naive_is_dst(dt) return (not naive_dst and (naive_dst != self._naive_is_dst(dt - self._dst_saved))) def _naive_is_dst(self, dt): timestamp = _datetime_to_timestamp(dt) return time.localtime(timestamp + time.timezone).tm_isdst def _isdst(self, dt, fold_naive=True): # We can't use mktime here. It is unstable when deciding if # the hour near to a change is DST or not. # # timestamp = time.mktime((dt.year, dt.month, dt.day, dt.hour, # dt.minute, dt.second, dt.weekday(), 0, -1)) # return time.localtime(timestamp).tm_isdst # # The code above yields the following result: # # >>> import tz, datetime # >>> t = tz.tzlocal() # >>> datetime.datetime(2003,2,15,23,tzinfo=t).tzname() # 'BRDT' # >>> datetime.datetime(2003,2,16,0,tzinfo=t).tzname() # 'BRST' # >>> datetime.datetime(2003,2,15,23,tzinfo=t).tzname() # 'BRST' # >>> datetime.datetime(2003,2,15,22,tzinfo=t).tzname() # 'BRDT' # >>> datetime.datetime(2003,2,15,23,tzinfo=t).tzname() # 'BRDT' # # Here is a more stable implementation: # if not self._hasdst: return False # Check for ambiguous times: dstval = self._naive_is_dst(dt) fold = getattr(dt, 'fold', None) if self.is_ambiguous(dt): if fold is not None: return not self._fold(dt) else: return True return dstval def __eq__(self, other): if isinstance(other, tzlocal): return (self._std_offset == other._std_offset and self._dst_offset == other._dst_offset) elif isinstance(other, tzutc): return (not self._hasdst and self._tznames[0] in {'UTC', 'GMT'} and self._std_offset == ZERO) elif isinstance(other, tzoffset): return (not self._hasdst and self._tznames[0] == other._name and self._std_offset == other._offset) else: return NotImplemented __hash__ = None def __ne__(self, other): return not (self == other) def __repr__(self): return "%s()" % self.__class__.__name__ __reduce__ = object.__reduce__ class _ttinfo(object): __slots__ = ["offset", "delta", "isdst", "abbr", "isstd", "isgmt", "dstoffset"] def __init__(self): for attr in self.__slots__: setattr(self, attr, None) def __repr__(self): l = [] for attr in self.__slots__: value = getattr(self, attr) if value is not None: l.append("%s=%s" % (attr, repr(value))) return "%s(%s)" % (self.__class__.__name__, ", ".join(l)) def __eq__(self, other): if not isinstance(other, _ttinfo): return NotImplemented return (self.offset == other.offset and self.delta == other.delta and self.isdst == other.isdst and self.abbr == other.abbr and self.isstd == other.isstd and self.isgmt == other.isgmt and self.dstoffset == other.dstoffset) __hash__ = None def __ne__(self, other): return not (self == other) def __getstate__(self): state = {} for name in self.__slots__: state[name] = getattr(self, name, None) return state def __setstate__(self, state): for name in self.__slots__: if name in state: setattr(self, name, state[name]) class _tzfile(object): """ Lightweight class for holding the relevant transition and time zone information read from binary tzfiles. """ attrs = ['trans_list', 'trans_list_utc', 'trans_idx', 'ttinfo_list', 'ttinfo_std', 'ttinfo_dst', 'ttinfo_before', 'ttinfo_first'] def __init__(self, **kwargs): for attr in self.attrs: setattr(self, attr, kwargs.get(attr, None)) class tzfile(_tzinfo): """ This is a ``tzinfo`` subclass that allows one to use the ``tzfile(5)`` format timezone files to extract current and historical zone information. :param fileobj: This can be an opened file stream or a file name that the time zone information can be read from. :param filename: This is an optional parameter specifying the source of the time zone information in the event that ``fileobj`` is a file object. If omitted and ``fileobj`` is a file stream, this parameter will be set either to ``fileobj``'s ``name`` attribute or to ``repr(fileobj)``. See `Sources for Time Zone and Daylight Saving Time Data `_ for more information. Time zone files can be compiled from the `IANA Time Zone database files `_ with the `zic time zone compiler `_ .. note:: Only construct a ``tzfile`` directly if you have a specific timezone file on disk that you want to read into a Python ``tzinfo`` object. If you want to get a ``tzfile`` representing a specific IANA zone, (e.g. ``'America/New_York'``), you should call :func:`dateutil.tz.gettz` with the zone identifier. **Examples:** Using the US Eastern time zone as an example, we can see that a ``tzfile`` provides time zone information for the standard Daylight Saving offsets: .. testsetup:: tzfile from dateutil.tz import gettz from datetime import datetime .. doctest:: tzfile >>> NYC = gettz('America/New_York') >>> NYC tzfile('/usr/share/zoneinfo/America/New_York') >>> print(datetime(2016, 1, 3, tzinfo=NYC)) # EST 2016-01-03 00:00:00-05:00 >>> print(datetime(2016, 7, 7, tzinfo=NYC)) # EDT 2016-07-07 00:00:00-04:00 The ``tzfile`` structure contains a fully history of the time zone, so historical dates will also have the right offsets. For example, before the adoption of the UTC standards, New York used local solar mean time: .. doctest:: tzfile >>> print(datetime(1901, 4, 12, tzinfo=NYC)) # LMT 1901-04-12 00:00:00-04:56 And during World War II, New York was on "Eastern War Time", which was a state of permanent daylight saving time: .. doctest:: tzfile >>> print(datetime(1944, 2, 7, tzinfo=NYC)) # EWT 1944-02-07 00:00:00-04:00 """ def __init__(self, fileobj, filename=None): super(tzfile, self).__init__() file_opened_here = False if isinstance(fileobj, string_types): self._filename = fileobj fileobj = open(fileobj, 'rb') file_opened_here = True elif filename is not None: self._filename = filename elif hasattr(fileobj, "name"): self._filename = fileobj.name else: self._filename = repr(fileobj) if fileobj is not None: if not file_opened_here: fileobj = _nullcontext(fileobj) with fileobj as file_stream: tzobj = self._read_tzfile(file_stream) self._set_tzdata(tzobj) def _set_tzdata(self, tzobj): """ Set the time zone data of this object from a _tzfile object """ # Copy the relevant attributes over as private attributes for attr in _tzfile.attrs: setattr(self, '_' + attr, getattr(tzobj, attr)) def _read_tzfile(self, fileobj): out = _tzfile() # From tzfile(5): # # The time zone information files used by tzset(3) # begin with the magic characters "TZif" to identify # them as time zone information files, followed by # sixteen bytes reserved for future use, followed by # six four-byte values of type long, written in a # ``standard'' byte order (the high-order byte # of the value is written first). if fileobj.read(4).decode() != "TZif": raise ValueError("magic not found") fileobj.read(16) ( # The number of UTC/local indicators stored in the file. ttisgmtcnt, # The number of standard/wall indicators stored in the file. ttisstdcnt, # The number of leap seconds for which data is # stored in the file. leapcnt, # The number of "transition times" for which data # is stored in the file. timecnt, # The number of "local time types" for which data # is stored in the file (must not be zero). typecnt, # The number of characters of "time zone # abbreviation strings" stored in the file. charcnt, ) = struct.unpack(">6l", fileobj.read(24)) # The above header is followed by tzh_timecnt four-byte # values of type long, sorted in ascending order. # These values are written in ``standard'' byte order. # Each is used as a transition time (as returned by # time(2)) at which the rules for computing local time # change. if timecnt: out.trans_list_utc = list(struct.unpack(">%dl" % timecnt, fileobj.read(timecnt*4))) else: out.trans_list_utc = [] # Next come tzh_timecnt one-byte values of type unsigned # char; each one tells which of the different types of # ``local time'' types described in the file is associated # with the same-indexed transition time. These values # serve as indices into an array of ttinfo structures that # appears next in the file. if timecnt: out.trans_idx = struct.unpack(">%dB" % timecnt, fileobj.read(timecnt)) else: out.trans_idx = [] # Each ttinfo structure is written as a four-byte value # for tt_gmtoff of type long, in a standard byte # order, followed by a one-byte value for tt_isdst # and a one-byte value for tt_abbrind. In each # structure, tt_gmtoff gives the number of # seconds to be added to UTC, tt_isdst tells whether # tm_isdst should be set by localtime(3), and # tt_abbrind serves as an index into the array of # time zone abbreviation characters that follow the # ttinfo structure(s) in the file. ttinfo = [] for i in range(typecnt): ttinfo.append(struct.unpack(">lbb", fileobj.read(6))) abbr = fileobj.read(charcnt).decode() # Then there are tzh_leapcnt pairs of four-byte # values, written in standard byte order; the # first value of each pair gives the time (as # returned by time(2)) at which a leap second # occurs; the second gives the total number of # leap seconds to be applied after the given time. # The pairs of values are sorted in ascending order # by time. # Not used, for now (but seek for correct file position) if leapcnt: fileobj.seek(leapcnt * 8, os.SEEK_CUR) # Then there are tzh_ttisstdcnt standard/wall # indicators, each stored as a one-byte value; # they tell whether the transition times associated # with local time types were specified as standard # time or wall clock time, and are used when # a time zone file is used in handling POSIX-style # time zone environment variables. if ttisstdcnt: isstd = struct.unpack(">%db" % ttisstdcnt, fileobj.read(ttisstdcnt)) # Finally, there are tzh_ttisgmtcnt UTC/local # indicators, each stored as a one-byte value; # they tell whether the transition times associated # with local time types were specified as UTC or # local time, and are used when a time zone file # is used in handling POSIX-style time zone envi- # ronment variables. if ttisgmtcnt: isgmt = struct.unpack(">%db" % ttisgmtcnt, fileobj.read(ttisgmtcnt)) # Build ttinfo list out.ttinfo_list = [] for i in range(typecnt): gmtoff, isdst, abbrind = ttinfo[i] gmtoff = _get_supported_offset(gmtoff) tti = _ttinfo() tti.offset = gmtoff tti.dstoffset = datetime.timedelta(0) tti.delta = datetime.timedelta(seconds=gmtoff) tti.isdst = isdst tti.abbr = abbr[abbrind:abbr.find('\x00', abbrind)] tti.isstd = (ttisstdcnt > i and isstd[i] != 0) tti.isgmt = (ttisgmtcnt > i and isgmt[i] != 0) out.ttinfo_list.append(tti) # Replace ttinfo indexes for ttinfo objects. out.trans_idx = [out.ttinfo_list[idx] for idx in out.trans_idx] # Set standard, dst, and before ttinfos. before will be # used when a given time is before any transitions, # and will be set to the first non-dst ttinfo, or to # the first dst, if all of them are dst. out.ttinfo_std = None out.ttinfo_dst = None out.ttinfo_before = None if out.ttinfo_list: if not out.trans_list_utc: out.ttinfo_std = out.ttinfo_first = out.ttinfo_list[0] else: for i in range(timecnt-1, -1, -1): tti = out.trans_idx[i] if not out.ttinfo_std and not tti.isdst: out.ttinfo_std = tti elif not out.ttinfo_dst and tti.isdst: out.ttinfo_dst = tti if out.ttinfo_std and out.ttinfo_dst: break else: if out.ttinfo_dst and not out.ttinfo_std: out.ttinfo_std = out.ttinfo_dst for tti in out.ttinfo_list: if not tti.isdst: out.ttinfo_before = tti break else: out.ttinfo_before = out.ttinfo_list[0] # Now fix transition times to become relative to wall time. # # I'm not sure about this. In my tests, the tz source file # is setup to wall time, and in the binary file isstd and # isgmt are off, so it should be in wall time. OTOH, it's # always in gmt time. Let me know if you have comments # about this. lastdst = None lastoffset = None lastdstoffset = None lastbaseoffset = None out.trans_list = [] for i, tti in enumerate(out.trans_idx): offset = tti.offset dstoffset = 0 if lastdst is not None: if tti.isdst: if not lastdst: dstoffset = offset - lastoffset if not dstoffset and lastdstoffset: dstoffset = lastdstoffset tti.dstoffset = datetime.timedelta(seconds=dstoffset) lastdstoffset = dstoffset # If a time zone changes its base offset during a DST transition, # then you need to adjust by the previous base offset to get the # transition time in local time. Otherwise you use the current # base offset. Ideally, I would have some mathematical proof of # why this is true, but I haven't really thought about it enough. baseoffset = offset - dstoffset adjustment = baseoffset if (lastbaseoffset is not None and baseoffset != lastbaseoffset and tti.isdst != lastdst): # The base DST has changed adjustment = lastbaseoffset lastdst = tti.isdst lastoffset = offset lastbaseoffset = baseoffset out.trans_list.append(out.trans_list_utc[i] + adjustment) out.trans_idx = tuple(out.trans_idx) out.trans_list = tuple(out.trans_list) out.trans_list_utc = tuple(out.trans_list_utc) return out def _find_last_transition(self, dt, in_utc=False): # If there's no list, there are no transitions to find if not self._trans_list: return None timestamp = _datetime_to_timestamp(dt) # Find where the timestamp fits in the transition list - if the # timestamp is a transition time, it's part of the "after" period. trans_list = self._trans_list_utc if in_utc else self._trans_list idx = bisect.bisect_right(trans_list, timestamp) # We want to know when the previous transition was, so subtract off 1 return idx - 1 def _get_ttinfo(self, idx): # For no list or after the last transition, default to _ttinfo_std if idx is None or (idx + 1) >= len(self._trans_list): return self._ttinfo_std # If there is a list and the time is before it, return _ttinfo_before if idx < 0: return self._ttinfo_before return self._trans_idx[idx] def _find_ttinfo(self, dt): idx = self._resolve_ambiguous_time(dt) return self._get_ttinfo(idx) def fromutc(self, dt): """ The ``tzfile`` implementation of :py:func:`datetime.tzinfo.fromutc`. :param dt: A :py:class:`datetime.datetime` object. :raises TypeError: Raised if ``dt`` is not a :py:class:`datetime.datetime` object. :raises ValueError: Raised if this is called with a ``dt`` which does not have this ``tzinfo`` attached. :return: Returns a :py:class:`datetime.datetime` object representing the wall time in ``self``'s time zone. """ # These isinstance checks are in datetime.tzinfo, so we'll preserve # them, even if we don't care about duck typing. if not isinstance(dt, datetime.datetime): raise TypeError("fromutc() requires a datetime argument") if dt.tzinfo is not self: raise ValueError("dt.tzinfo is not self") # First treat UTC as wall time and get the transition we're in. idx = self._find_last_transition(dt, in_utc=True) tti = self._get_ttinfo(idx) dt_out = dt + datetime.timedelta(seconds=tti.offset) fold = self.is_ambiguous(dt_out, idx=idx) return enfold(dt_out, fold=int(fold)) def is_ambiguous(self, dt, idx=None): """ Whether or not the "wall time" of a given datetime is ambiguous in this zone. :param dt: A :py:class:`datetime.datetime`, naive or time zone aware. :return: Returns ``True`` if ambiguous, ``False`` otherwise. .. versionadded:: 2.6.0 """ if idx is None: idx = self._find_last_transition(dt) # Calculate the difference in offsets from current to previous timestamp = _datetime_to_timestamp(dt) tti = self._get_ttinfo(idx) if idx is None or idx <= 0: return False od = self._get_ttinfo(idx - 1).offset - tti.offset tt = self._trans_list[idx] # Transition time return timestamp < tt + od def _resolve_ambiguous_time(self, dt): idx = self._find_last_transition(dt) # If we have no transitions, return the index _fold = self._fold(dt) if idx is None or idx == 0: return idx # If it's ambiguous and we're in a fold, shift to a different index. idx_offset = int(not _fold and self.is_ambiguous(dt, idx)) return idx - idx_offset def utcoffset(self, dt): if dt is None: return None if not self._ttinfo_std: return ZERO return self._find_ttinfo(dt).delta def dst(self, dt): if dt is None: return None if not self._ttinfo_dst: return ZERO tti = self._find_ttinfo(dt) if not tti.isdst: return ZERO # The documentation says that utcoffset()-dst() must # be constant for every dt. return tti.dstoffset @tzname_in_python2 def tzname(self, dt): if not self._ttinfo_std or dt is None: return None return self._find_ttinfo(dt).abbr def __eq__(self, other): if not isinstance(other, tzfile): return NotImplemented return (self._trans_list == other._trans_list and self._trans_idx == other._trans_idx and self._ttinfo_list == other._ttinfo_list) __hash__ = None def __ne__(self, other): return not (self == other) def __repr__(self): return "%s(%s)" % (self.__class__.__name__, repr(self._filename)) def __reduce__(self): return self.__reduce_ex__(None) def __reduce_ex__(self, protocol): return (self.__class__, (None, self._filename), self.__dict__) class tzrange(tzrangebase): """ The ``tzrange`` object is a time zone specified by a set of offsets and abbreviations, equivalent to the way the ``TZ`` variable can be specified in POSIX-like systems, but using Python delta objects to specify DST start, end and offsets. :param stdabbr: The abbreviation for standard time (e.g. ``'EST'``). :param stdoffset: An integer or :class:`datetime.timedelta` object or equivalent specifying the base offset from UTC. If unspecified, +00:00 is used. :param dstabbr: The abbreviation for DST / "Summer" time (e.g. ``'EDT'``). If specified, with no other DST information, DST is assumed to occur and the default behavior or ``dstoffset``, ``start`` and ``end`` is used. If unspecified and no other DST information is specified, it is assumed that this zone has no DST. If this is unspecified and other DST information is *is* specified, DST occurs in the zone but the time zone abbreviation is left unchanged. :param dstoffset: A an integer or :class:`datetime.timedelta` object or equivalent specifying the UTC offset during DST. If unspecified and any other DST information is specified, it is assumed to be the STD offset +1 hour. :param start: A :class:`relativedelta.relativedelta` object or equivalent specifying the time and time of year that daylight savings time starts. To specify, for example, that DST starts at 2AM on the 2nd Sunday in March, pass: ``relativedelta(hours=2, month=3, day=1, weekday=SU(+2))`` If unspecified and any other DST information is specified, the default value is 2 AM on the first Sunday in April. :param end: A :class:`relativedelta.relativedelta` object or equivalent representing the time and time of year that daylight savings time ends, with the same specification method as in ``start``. One note is that this should point to the first time in the *standard* zone, so if a transition occurs at 2AM in the DST zone and the clocks are set back 1 hour to 1AM, set the ``hours`` parameter to +1. **Examples:** .. testsetup:: tzrange from dateutil.tz import tzrange, tzstr .. doctest:: tzrange >>> tzstr('EST5EDT') == tzrange("EST", -18000, "EDT") True >>> from dateutil.relativedelta import * >>> range1 = tzrange("EST", -18000, "EDT") >>> range2 = tzrange("EST", -18000, "EDT", -14400, ... relativedelta(hours=+2, month=4, day=1, ... weekday=SU(+1)), ... relativedelta(hours=+1, month=10, day=31, ... weekday=SU(-1))) >>> tzstr('EST5EDT') == range1 == range2 True """ def __init__(self, stdabbr, stdoffset=None, dstabbr=None, dstoffset=None, start=None, end=None): global relativedelta from dateutil import relativedelta self._std_abbr = stdabbr self._dst_abbr = dstabbr try: stdoffset = stdoffset.total_seconds() except (TypeError, AttributeError): pass try: dstoffset = dstoffset.total_seconds() except (TypeError, AttributeError): pass if stdoffset is not None: self._std_offset = datetime.timedelta(seconds=stdoffset) else: self._std_offset = ZERO if dstoffset is not None: self._dst_offset = datetime.timedelta(seconds=dstoffset) elif dstabbr and stdoffset is not None: self._dst_offset = self._std_offset + datetime.timedelta(hours=+1) else: self._dst_offset = ZERO if dstabbr and start is None: self._start_delta = relativedelta.relativedelta( hours=+2, month=4, day=1, weekday=relativedelta.SU(+1)) else: self._start_delta = start if dstabbr and end is None: self._end_delta = relativedelta.relativedelta( hours=+1, month=10, day=31, weekday=relativedelta.SU(-1)) else: self._end_delta = end self._dst_base_offset_ = self._dst_offset - self._std_offset self.hasdst = bool(self._start_delta) def transitions(self, year): """ For a given year, get the DST on and off transition times, expressed always on the standard time side. For zones with no transitions, this function returns ``None``. :param year: The year whose transitions you would like to query. :return: Returns a :class:`tuple` of :class:`datetime.datetime` objects, ``(dston, dstoff)`` for zones with an annual DST transition, or ``None`` for fixed offset zones. """ if not self.hasdst: return None base_year = datetime.datetime(year, 1, 1) start = base_year + self._start_delta end = base_year + self._end_delta return (start, end) def __eq__(self, other): if not isinstance(other, tzrange): return NotImplemented return (self._std_abbr == other._std_abbr and self._dst_abbr == other._dst_abbr and self._std_offset == other._std_offset and self._dst_offset == other._dst_offset and self._start_delta == other._start_delta and self._end_delta == other._end_delta) @property def _dst_base_offset(self): return self._dst_base_offset_ @six.add_metaclass(_TzStrFactory) class tzstr(tzrange): """ ``tzstr`` objects are time zone objects specified by a time-zone string as it would be passed to a ``TZ`` variable on POSIX-style systems (see the `GNU C Library: TZ Variable`_ for more details). There is one notable exception, which is that POSIX-style time zones use an inverted offset format, so normally ``GMT+3`` would be parsed as an offset 3 hours *behind* GMT. The ``tzstr`` time zone object will parse this as an offset 3 hours *ahead* of GMT. If you would like to maintain the POSIX behavior, pass a ``True`` value to ``posix_offset``. The :class:`tzrange` object provides the same functionality, but is specified using :class:`relativedelta.relativedelta` objects. rather than strings. :param s: A time zone string in ``TZ`` variable format. This can be a :class:`bytes` (2.x: :class:`str`), :class:`str` (2.x: :class:`unicode`) or a stream emitting unicode characters (e.g. :class:`StringIO`). :param posix_offset: Optional. If set to ``True``, interpret strings such as ``GMT+3`` or ``UTC+3`` as being 3 hours *behind* UTC rather than ahead, per the POSIX standard. .. caution:: Prior to version 2.7.0, this function also supported time zones in the format: * ``EST5EDT,4,0,6,7200,10,0,26,7200,3600`` * ``EST5EDT,4,1,0,7200,10,-1,0,7200,3600`` This format is non-standard and has been deprecated; this function will raise a :class:`DeprecatedTZFormatWarning` until support is removed in a future version. .. _`GNU C Library: TZ Variable`: https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html """ def __init__(self, s, posix_offset=False): global parser from dateutil.parser import _parser as parser self._s = s res = parser._parsetz(s) if res is None or res.any_unused_tokens: raise ValueError("unknown string format") # Here we break the compatibility with the TZ variable handling. # GMT-3 actually *means* the timezone -3. if res.stdabbr in ("GMT", "UTC") and not posix_offset: res.stdoffset *= -1 # We must initialize it first, since _delta() needs # _std_offset and _dst_offset set. Use False in start/end # to avoid building it two times. tzrange.__init__(self, res.stdabbr, res.stdoffset, res.dstabbr, res.dstoffset, start=False, end=False) if not res.dstabbr: self._start_delta = None self._end_delta = None else: self._start_delta = self._delta(res.start) if self._start_delta: self._end_delta = self._delta(res.end, isend=1) self.hasdst = bool(self._start_delta) def _delta(self, x, isend=0): from dateutil import relativedelta kwargs = {} if x.month is not None: kwargs["month"] = x.month if x.weekday is not None: kwargs["weekday"] = relativedelta.weekday(x.weekday, x.week) if x.week > 0: kwargs["day"] = 1 else: kwargs["day"] = 31 elif x.day: kwargs["day"] = x.day elif x.yday is not None: kwargs["yearday"] = x.yday elif x.jyday is not None: kwargs["nlyearday"] = x.jyday if not kwargs: # Default is to start on first sunday of april, and end # on last sunday of october. if not isend: kwargs["month"] = 4 kwargs["day"] = 1 kwargs["weekday"] = relativedelta.SU(+1) else: kwargs["month"] = 10 kwargs["day"] = 31 kwargs["weekday"] = relativedelta.SU(-1) if x.time is not None: kwargs["seconds"] = x.time else: # Default is 2AM. kwargs["seconds"] = 7200 if isend: # Convert to standard time, to follow the documented way # of working with the extra hour. See the documentation # of the tzinfo class. delta = self._dst_offset - self._std_offset kwargs["seconds"] -= delta.seconds + delta.days * 86400 return relativedelta.relativedelta(**kwargs) def __repr__(self): return "%s(%s)" % (self.__class__.__name__, repr(self._s)) class _tzicalvtzcomp(object): def __init__(self, tzoffsetfrom, tzoffsetto, isdst, tzname=None, rrule=None): self.tzoffsetfrom = datetime.timedelta(seconds=tzoffsetfrom) self.tzoffsetto = datetime.timedelta(seconds=tzoffsetto) self.tzoffsetdiff = self.tzoffsetto - self.tzoffsetfrom self.isdst = isdst self.tzname = tzname self.rrule = rrule class _tzicalvtz(_tzinfo): def __init__(self, tzid, comps=[]): super(_tzicalvtz, self).__init__() self._tzid = tzid self._comps = comps self._cachedate = [] self._cachecomp = [] self._cache_lock = _thread.allocate_lock() def _find_comp(self, dt): if len(self._comps) == 1: return self._comps[0] dt = dt.replace(tzinfo=None) try: with self._cache_lock: return self._cachecomp[self._cachedate.index( (dt, self._fold(dt)))] except ValueError: pass lastcompdt = None lastcomp = None for comp in self._comps: compdt = self._find_compdt(comp, dt) if compdt and (not lastcompdt or lastcompdt < compdt): lastcompdt = compdt lastcomp = comp if not lastcomp: # RFC says nothing about what to do when a given # time is before the first onset date. We'll look for the # first standard component, or the first component, if # none is found. for comp in self._comps: if not comp.isdst: lastcomp = comp break else: lastcomp = comp[0] with self._cache_lock: self._cachedate.insert(0, (dt, self._fold(dt))) self._cachecomp.insert(0, lastcomp) if len(self._cachedate) > 10: self._cachedate.pop() self._cachecomp.pop() return lastcomp def _find_compdt(self, comp, dt): if comp.tzoffsetdiff < ZERO and self._fold(dt): dt -= comp.tzoffsetdiff compdt = comp.rrule.before(dt, inc=True) return compdt def utcoffset(self, dt): if dt is None: return None return self._find_comp(dt).tzoffsetto def dst(self, dt): comp = self._find_comp(dt) if comp.isdst: return comp.tzoffsetdiff else: return ZERO @tzname_in_python2 def tzname(self, dt): return self._find_comp(dt).tzname def __repr__(self): return "" % repr(self._tzid) __reduce__ = object.__reduce__ class tzical(object): """ This object is designed to parse an iCalendar-style ``VTIMEZONE`` structure as set out in `RFC 5545`_ Section 4.6.5 into one or more `tzinfo` objects. :param `fileobj`: A file or stream in iCalendar format, which should be UTF-8 encoded with CRLF endings. .. _`RFC 5545`: https://tools.ietf.org/html/rfc5545 """ def __init__(self, fileobj): global rrule from dateutil import rrule if isinstance(fileobj, string_types): self._s = fileobj # ical should be encoded in UTF-8 with CRLF fileobj = open(fileobj, 'r') else: self._s = getattr(fileobj, 'name', repr(fileobj)) fileobj = _nullcontext(fileobj) self._vtz = {} with fileobj as fobj: self._parse_rfc(fobj.read()) def keys(self): """ Retrieves the available time zones as a list. """ return list(self._vtz.keys()) def get(self, tzid=None): """ Retrieve a :py:class:`datetime.tzinfo` object by its ``tzid``. :param tzid: If there is exactly one time zone available, omitting ``tzid`` or passing :py:const:`None` value returns it. Otherwise a valid key (which can be retrieved from :func:`keys`) is required. :raises ValueError: Raised if ``tzid`` is not specified but there are either more or fewer than 1 zone defined. :returns: Returns either a :py:class:`datetime.tzinfo` object representing the relevant time zone or :py:const:`None` if the ``tzid`` was not found. """ if tzid is None: if len(self._vtz) == 0: raise ValueError("no timezones defined") elif len(self._vtz) > 1: raise ValueError("more than one timezone available") tzid = next(iter(self._vtz)) return self._vtz.get(tzid) def _parse_offset(self, s): s = s.strip() if not s: raise ValueError("empty offset") if s[0] in ('+', '-'): signal = (-1, +1)[s[0] == '+'] s = s[1:] else: signal = +1 if len(s) == 4: return (int(s[:2]) * 3600 + int(s[2:]) * 60) * signal elif len(s) == 6: return (int(s[:2]) * 3600 + int(s[2:4]) * 60 + int(s[4:])) * signal else: raise ValueError("invalid offset: " + s) def _parse_rfc(self, s): lines = s.splitlines() if not lines: raise ValueError("empty string") # Unfold i = 0 while i < len(lines): line = lines[i].rstrip() if not line: del lines[i] elif i > 0 and line[0] == " ": lines[i-1] += line[1:] del lines[i] else: i += 1 tzid = None comps = [] invtz = False comptype = None for line in lines: if not line: continue name, value = line.split(':', 1) parms = name.split(';') if not parms: raise ValueError("empty property name") name = parms[0].upper() parms = parms[1:] if invtz: if name == "BEGIN": if value in ("STANDARD", "DAYLIGHT"): # Process component pass else: raise ValueError("unknown component: "+value) comptype = value founddtstart = False tzoffsetfrom = None tzoffsetto = None rrulelines = [] tzname = None elif name == "END": if value == "VTIMEZONE": if comptype: raise ValueError("component not closed: "+comptype) if not tzid: raise ValueError("mandatory TZID not found") if not comps: raise ValueError( "at least one component is needed") # Process vtimezone self._vtz[tzid] = _tzicalvtz(tzid, comps) invtz = False elif value == comptype: if not founddtstart: raise ValueError("mandatory DTSTART not found") if tzoffsetfrom is None: raise ValueError( "mandatory TZOFFSETFROM not found") if tzoffsetto is None: raise ValueError( "mandatory TZOFFSETFROM not found") # Process component rr = None if rrulelines: rr = rrule.rrulestr("\n".join(rrulelines), compatible=True, ignoretz=True, cache=True) comp = _tzicalvtzcomp(tzoffsetfrom, tzoffsetto, (comptype == "DAYLIGHT"), tzname, rr) comps.append(comp) comptype = None else: raise ValueError("invalid component end: "+value) elif comptype: if name == "DTSTART": # DTSTART in VTIMEZONE takes a subset of valid RRULE # values under RFC 5545. for parm in parms: if parm != 'VALUE=DATE-TIME': msg = ('Unsupported DTSTART param in ' + 'VTIMEZONE: ' + parm) raise ValueError(msg) rrulelines.append(line) founddtstart = True elif name in ("RRULE", "RDATE", "EXRULE", "EXDATE"): rrulelines.append(line) elif name == "TZOFFSETFROM": if parms: raise ValueError( "unsupported %s parm: %s " % (name, parms[0])) tzoffsetfrom = self._parse_offset(value) elif name == "TZOFFSETTO": if parms: raise ValueError( "unsupported TZOFFSETTO parm: "+parms[0]) tzoffsetto = self._parse_offset(value) elif name == "TZNAME": if parms: raise ValueError( "unsupported TZNAME parm: "+parms[0]) tzname = value elif name == "COMMENT": pass else: raise ValueError("unsupported property: "+name) else: if name == "TZID": if parms: raise ValueError( "unsupported TZID parm: "+parms[0]) tzid = value elif name in ("TZURL", "LAST-MODIFIED", "COMMENT"): pass else: raise ValueError("unsupported property: "+name) elif name == "BEGIN" and value == "VTIMEZONE": tzid = None comps = [] invtz = True def __repr__(self): return "%s(%s)" % (self.__class__.__name__, repr(self._s)) if sys.platform != "win32": TZFILES = ["/etc/localtime", "localtime"] TZPATHS = ["/usr/share/zoneinfo", "/usr/lib/zoneinfo", "/usr/share/lib/zoneinfo", "/etc/zoneinfo"] else: TZFILES = [] TZPATHS = [] def __get_gettz(): tzlocal_classes = (tzlocal,) if tzwinlocal is not None: tzlocal_classes += (tzwinlocal,) class GettzFunc(object): """ Retrieve a time zone object from a string representation This function is intended to retrieve the :py:class:`tzinfo` subclass that best represents the time zone that would be used if a POSIX `TZ variable`_ were set to the same value. If no argument or an empty string is passed to ``gettz``, local time is returned: .. code-block:: python3 >>> gettz() tzfile('/etc/localtime') This function is also the preferred way to map IANA tz database keys to :class:`tzfile` objects: .. code-block:: python3 >>> gettz('Pacific/Kiritimati') tzfile('/usr/share/zoneinfo/Pacific/Kiritimati') On Windows, the standard is extended to include the Windows-specific zone names provided by the operating system: .. code-block:: python3 >>> gettz('Egypt Standard Time') tzwin('Egypt Standard Time') Passing a GNU ``TZ`` style string time zone specification returns a :class:`tzstr` object: .. code-block:: python3 >>> gettz('AEST-10AEDT-11,M10.1.0/2,M4.1.0/3') tzstr('AEST-10AEDT-11,M10.1.0/2,M4.1.0/3') :param name: A time zone name (IANA, or, on Windows, Windows keys), location of a ``tzfile(5)`` zoneinfo file or ``TZ`` variable style time zone specifier. An empty string, no argument or ``None`` is interpreted as local time. :return: Returns an instance of one of ``dateutil``'s :py:class:`tzinfo` subclasses. .. versionchanged:: 2.7.0 After version 2.7.0, any two calls to ``gettz`` using the same input strings will return the same object: .. code-block:: python3 >>> tz.gettz('America/Chicago') is tz.gettz('America/Chicago') True In addition to improving performance, this ensures that `"same zone" semantics`_ are used for datetimes in the same zone. .. _`TZ variable`: https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html .. _`"same zone" semantics`: https://blog.ganssle.io/articles/2018/02/aware-datetime-arithmetic.html """ def __init__(self): self.__instances = weakref.WeakValueDictionary() self.__strong_cache_size = 8 self.__strong_cache = OrderedDict() self._cache_lock = _thread.allocate_lock() def __call__(self, name=None): with self._cache_lock: rv = self.__instances.get(name, None) if rv is None: rv = self.nocache(name=name) if not (name is None or isinstance(rv, tzlocal_classes) or rv is None): # tzlocal is slightly more complicated than the other # time zone providers because it depends on environment # at construction time, so don't cache that. # # We also cannot store weak references to None, so we # will also not store that. self.__instances[name] = rv else: # No need for strong caching, return immediately return rv self.__strong_cache[name] = self.__strong_cache.pop(name, rv) if len(self.__strong_cache) > self.__strong_cache_size: self.__strong_cache.popitem(last=False) return rv def set_cache_size(self, size): with self._cache_lock: self.__strong_cache_size = size while len(self.__strong_cache) > size: self.__strong_cache.popitem(last=False) def cache_clear(self): with self._cache_lock: self.__instances = weakref.WeakValueDictionary() self.__strong_cache.clear() @staticmethod def nocache(name=None): """A non-cached version of gettz""" tz = None if not name: try: name = os.environ["TZ"] except KeyError: pass if name is None or name in ("", ":"): for filepath in TZFILES: if not os.path.isabs(filepath): filename = filepath for path in TZPATHS: filepath = os.path.join(path, filename) if os.path.isfile(filepath): break else: continue if os.path.isfile(filepath): try: tz = tzfile(filepath) break except (IOError, OSError, ValueError): pass else: tz = tzlocal() else: try: if name.startswith(":"): name = name[1:] except TypeError as e: if isinstance(name, bytes): new_msg = "gettz argument should be str, not bytes" six.raise_from(TypeError(new_msg), e) else: raise if os.path.isabs(name): if os.path.isfile(name): tz = tzfile(name) else: tz = None else: for path in TZPATHS: filepath = os.path.join(path, name) if not os.path.isfile(filepath): filepath = filepath.replace(' ', '_') if not os.path.isfile(filepath): continue try: tz = tzfile(filepath) break except (IOError, OSError, ValueError): pass else: tz = None if tzwin is not None: try: tz = tzwin(name) except (WindowsError, UnicodeEncodeError): # UnicodeEncodeError is for Python 2.7 compat tz = None if not tz: from dateutil.zoneinfo import get_zonefile_instance tz = get_zonefile_instance().get(name) if not tz: for c in name: # name is not a tzstr unless it has at least # one offset. For short values of "name", an # explicit for loop seems to be the fastest way # To determine if a string contains a digit if c in "0123456789": try: tz = tzstr(name) except ValueError: pass break else: if name in ("GMT", "UTC"): tz = UTC elif name in time.tzname: tz = tzlocal() return tz return GettzFunc() gettz = __get_gettz() del __get_gettz def datetime_exists(dt, tz=None): """ Given a datetime and a time zone, determine whether or not a given datetime would fall in a gap. :param dt: A :class:`datetime.datetime` (whose time zone will be ignored if ``tz`` is provided.) :param tz: A :class:`datetime.tzinfo` with support for the ``fold`` attribute. If ``None`` or not provided, the datetime's own time zone will be used. :return: Returns a boolean value whether or not the "wall time" exists in ``tz``. .. versionadded:: 2.7.0 """ if tz is None: if dt.tzinfo is None: raise ValueError('Datetime is naive and no time zone provided.') tz = dt.tzinfo dt = dt.replace(tzinfo=None) # This is essentially a test of whether or not the datetime can survive # a round trip to UTC. dt_rt = dt.replace(tzinfo=tz).astimezone(UTC).astimezone(tz) dt_rt = dt_rt.replace(tzinfo=None) return dt == dt_rt def datetime_ambiguous(dt, tz=None): """ Given a datetime and a time zone, determine whether or not a given datetime is ambiguous (i.e if there are two times differentiated only by their DST status). :param dt: A :class:`datetime.datetime` (whose time zone will be ignored if ``tz`` is provided.) :param tz: A :class:`datetime.tzinfo` with support for the ``fold`` attribute. If ``None`` or not provided, the datetime's own time zone will be used. :return: Returns a boolean value whether or not the "wall time" is ambiguous in ``tz``. .. versionadded:: 2.6.0 """ if tz is None: if dt.tzinfo is None: raise ValueError('Datetime is naive and no time zone provided.') tz = dt.tzinfo # If a time zone defines its own "is_ambiguous" function, we'll use that. is_ambiguous_fn = getattr(tz, 'is_ambiguous', None) if is_ambiguous_fn is not None: try: return tz.is_ambiguous(dt) except Exception: pass # If it doesn't come out and tell us it's ambiguous, we'll just check if # the fold attribute has any effect on this particular date and time. dt = dt.replace(tzinfo=tz) wall_0 = enfold(dt, fold=0) wall_1 = enfold(dt, fold=1) same_offset = wall_0.utcoffset() == wall_1.utcoffset() same_dst = wall_0.dst() == wall_1.dst() return not (same_offset and same_dst) def resolve_imaginary(dt): """ Given a datetime that may be imaginary, return an existing datetime. This function assumes that an imaginary datetime represents what the wall time would be in a zone had the offset transition not occurred, so it will always fall forward by the transition's change in offset. .. doctest:: >>> from dateutil import tz >>> from datetime import datetime >>> NYC = tz.gettz('America/New_York') >>> print(tz.resolve_imaginary(datetime(2017, 3, 12, 2, 30, tzinfo=NYC))) 2017-03-12 03:30:00-04:00 >>> KIR = tz.gettz('Pacific/Kiritimati') >>> print(tz.resolve_imaginary(datetime(1995, 1, 1, 12, 30, tzinfo=KIR))) 1995-01-02 12:30:00+14:00 As a note, :func:`datetime.astimezone` is guaranteed to produce a valid, existing datetime, so a round-trip to and from UTC is sufficient to get an extant datetime, however, this generally "falls back" to an earlier time rather than falling forward to the STD side (though no guarantees are made about this behavior). :param dt: A :class:`datetime.datetime` which may or may not exist. :return: Returns an existing :class:`datetime.datetime`. If ``dt`` was not imaginary, the datetime returned is guaranteed to be the same object passed to the function. .. versionadded:: 2.7.0 """ if dt.tzinfo is not None and not datetime_exists(dt): curr_offset = (dt + datetime.timedelta(hours=24)).utcoffset() old_offset = (dt - datetime.timedelta(hours=24)).utcoffset() dt += curr_offset - old_offset return dt def _datetime_to_timestamp(dt): """ Convert a :class:`datetime.datetime` object to an epoch timestamp in seconds since January 1, 1970, ignoring the time zone. """ return (dt.replace(tzinfo=None) - EPOCH).total_seconds() if sys.version_info >= (3, 6): def _get_supported_offset(second_offset): return second_offset else: def _get_supported_offset(second_offset): # For python pre-3.6, round to full-minutes if that's not the case. # Python's datetime doesn't accept sub-minute timezones. Check # http://python.org/sf/1447945 or https://bugs.python.org/issue5288 # for some information. old_offset = second_offset calculated_offset = 60 * ((second_offset + 30) // 60) return calculated_offset try: # Python 3.7 feature from contextlib import nullcontext as _nullcontext except ImportError: class _nullcontext(object): """ Class for wrapping contexts so that they are passed through in a with statement. """ def __init__(self, context): self.context = context def __enter__(self): return self.context def __exit__(*args, **kwargs): pass # vim:ts=4:sw=4:et ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/tz/win.py0000644000175100001710000003120700000000000017637 0ustar00runnerdocker# -*- coding: utf-8 -*- """ This module provides an interface to the native time zone data on Windows, including :py:class:`datetime.tzinfo` implementations. Attempting to import this module on a non-Windows platform will raise an :py:obj:`ImportError`. """ # This code was originally contributed by Jeffrey Harris. import datetime import struct from six.moves import winreg from six import text_type try: import ctypes from ctypes import wintypes except ValueError: # ValueError is raised on non-Windows systems for some horrible reason. raise ImportError("Running tzwin on non-Windows system") from ._common import tzrangebase __all__ = ["tzwin", "tzwinlocal", "tzres"] ONEWEEK = datetime.timedelta(7) TZKEYNAMENT = r"SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones" TZKEYNAME9X = r"SOFTWARE\Microsoft\Windows\CurrentVersion\Time Zones" TZLOCALKEYNAME = r"SYSTEM\CurrentControlSet\Control\TimeZoneInformation" def _settzkeyname(): handle = winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE) try: winreg.OpenKey(handle, TZKEYNAMENT).Close() TZKEYNAME = TZKEYNAMENT except WindowsError: TZKEYNAME = TZKEYNAME9X handle.Close() return TZKEYNAME TZKEYNAME = _settzkeyname() class tzres(object): """ Class for accessing ``tzres.dll``, which contains timezone name related resources. .. versionadded:: 2.5.0 """ p_wchar = ctypes.POINTER(wintypes.WCHAR) # Pointer to a wide char def __init__(self, tzres_loc='tzres.dll'): # Load the user32 DLL so we can load strings from tzres user32 = ctypes.WinDLL('user32') # Specify the LoadStringW function user32.LoadStringW.argtypes = (wintypes.HINSTANCE, wintypes.UINT, wintypes.LPWSTR, ctypes.c_int) self.LoadStringW = user32.LoadStringW self._tzres = ctypes.WinDLL(tzres_loc) self.tzres_loc = tzres_loc def load_name(self, offset): """ Load a timezone name from a DLL offset (integer). >>> from dateutil.tzwin import tzres >>> tzr = tzres() >>> print(tzr.load_name(112)) 'Eastern Standard Time' :param offset: A positive integer value referring to a string from the tzres dll. .. note:: Offsets found in the registry are generally of the form ``@tzres.dll,-114``. The offset in this case is 114, not -114. """ resource = self.p_wchar() lpBuffer = ctypes.cast(ctypes.byref(resource), wintypes.LPWSTR) nchar = self.LoadStringW(self._tzres._handle, offset, lpBuffer, 0) return resource[:nchar] def name_from_string(self, tzname_str): """ Parse strings as returned from the Windows registry into the time zone name as defined in the registry. >>> from dateutil.tzwin import tzres >>> tzr = tzres() >>> print(tzr.name_from_string('@tzres.dll,-251')) 'Dateline Daylight Time' >>> print(tzr.name_from_string('Eastern Standard Time')) 'Eastern Standard Time' :param tzname_str: A timezone name string as returned from a Windows registry key. :return: Returns the localized timezone string from tzres.dll if the string is of the form `@tzres.dll,-offset`, else returns the input string. """ if not tzname_str.startswith('@'): return tzname_str name_splt = tzname_str.split(',-') try: offset = int(name_splt[1]) except: raise ValueError("Malformed timezone string.") return self.load_name(offset) class tzwinbase(tzrangebase): """tzinfo class based on win32's timezones available in the registry.""" def __init__(self): raise NotImplementedError('tzwinbase is an abstract base class') def __eq__(self, other): # Compare on all relevant dimensions, including name. if not isinstance(other, tzwinbase): return NotImplemented return (self._std_offset == other._std_offset and self._dst_offset == other._dst_offset and self._stddayofweek == other._stddayofweek and self._dstdayofweek == other._dstdayofweek and self._stdweeknumber == other._stdweeknumber and self._dstweeknumber == other._dstweeknumber and self._stdhour == other._stdhour and self._dsthour == other._dsthour and self._stdminute == other._stdminute and self._dstminute == other._dstminute and self._std_abbr == other._std_abbr and self._dst_abbr == other._dst_abbr) @staticmethod def list(): """Return a list of all time zones known to the system.""" with winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE) as handle: with winreg.OpenKey(handle, TZKEYNAME) as tzkey: result = [winreg.EnumKey(tzkey, i) for i in range(winreg.QueryInfoKey(tzkey)[0])] return result def display(self): """ Return the display name of the time zone. """ return self._display def transitions(self, year): """ For a given year, get the DST on and off transition times, expressed always on the standard time side. For zones with no transitions, this function returns ``None``. :param year: The year whose transitions you would like to query. :return: Returns a :class:`tuple` of :class:`datetime.datetime` objects, ``(dston, dstoff)`` for zones with an annual DST transition, or ``None`` for fixed offset zones. """ if not self.hasdst: return None dston = picknthweekday(year, self._dstmonth, self._dstdayofweek, self._dsthour, self._dstminute, self._dstweeknumber) dstoff = picknthweekday(year, self._stdmonth, self._stddayofweek, self._stdhour, self._stdminute, self._stdweeknumber) # Ambiguous dates default to the STD side dstoff -= self._dst_base_offset return dston, dstoff def _get_hasdst(self): return self._dstmonth != 0 @property def _dst_base_offset(self): return self._dst_base_offset_ class tzwin(tzwinbase): """ Time zone object created from the zone info in the Windows registry These are similar to :py:class:`dateutil.tz.tzrange` objects in that the time zone data is provided in the format of a single offset rule for either 0 or 2 time zone transitions per year. :param: name The name of a Windows time zone key, e.g. "Eastern Standard Time". The full list of keys can be retrieved with :func:`tzwin.list`. """ def __init__(self, name): self._name = name with winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE) as handle: tzkeyname = text_type("{kn}\\{name}").format(kn=TZKEYNAME, name=name) with winreg.OpenKey(handle, tzkeyname) as tzkey: keydict = valuestodict(tzkey) self._std_abbr = keydict["Std"] self._dst_abbr = keydict["Dlt"] self._display = keydict["Display"] # See http://ww_winreg.jsiinc.com/SUBA/tip0300/rh0398.htm tup = struct.unpack("=3l16h", keydict["TZI"]) stdoffset = -tup[0]-tup[1] # Bias + StandardBias * -1 dstoffset = stdoffset-tup[2] # + DaylightBias * -1 self._std_offset = datetime.timedelta(minutes=stdoffset) self._dst_offset = datetime.timedelta(minutes=dstoffset) # for the meaning see the win32 TIME_ZONE_INFORMATION structure docs # http://msdn.microsoft.com/en-us/library/windows/desktop/ms725481(v=vs.85).aspx (self._stdmonth, self._stddayofweek, # Sunday = 0 self._stdweeknumber, # Last = 5 self._stdhour, self._stdminute) = tup[4:9] (self._dstmonth, self._dstdayofweek, # Sunday = 0 self._dstweeknumber, # Last = 5 self._dsthour, self._dstminute) = tup[12:17] self._dst_base_offset_ = self._dst_offset - self._std_offset self.hasdst = self._get_hasdst() def __repr__(self): return "tzwin(%s)" % repr(self._name) def __reduce__(self): return (self.__class__, (self._name,)) class tzwinlocal(tzwinbase): """ Class representing the local time zone information in the Windows registry While :class:`dateutil.tz.tzlocal` makes system calls (via the :mod:`time` module) to retrieve time zone information, ``tzwinlocal`` retrieves the rules directly from the Windows registry and creates an object like :class:`dateutil.tz.tzwin`. Because Windows does not have an equivalent of :func:`time.tzset`, on Windows, :class:`dateutil.tz.tzlocal` instances will always reflect the time zone settings *at the time that the process was started*, meaning changes to the machine's time zone settings during the run of a program on Windows will **not** be reflected by :class:`dateutil.tz.tzlocal`. Because ``tzwinlocal`` reads the registry directly, it is unaffected by this issue. """ def __init__(self): with winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE) as handle: with winreg.OpenKey(handle, TZLOCALKEYNAME) as tzlocalkey: keydict = valuestodict(tzlocalkey) self._std_abbr = keydict["StandardName"] self._dst_abbr = keydict["DaylightName"] try: tzkeyname = text_type('{kn}\\{sn}').format(kn=TZKEYNAME, sn=self._std_abbr) with winreg.OpenKey(handle, tzkeyname) as tzkey: _keydict = valuestodict(tzkey) self._display = _keydict["Display"] except OSError: self._display = None stdoffset = -keydict["Bias"]-keydict["StandardBias"] dstoffset = stdoffset-keydict["DaylightBias"] self._std_offset = datetime.timedelta(minutes=stdoffset) self._dst_offset = datetime.timedelta(minutes=dstoffset) # For reasons unclear, in this particular key, the day of week has been # moved to the END of the SYSTEMTIME structure. tup = struct.unpack("=8h", keydict["StandardStart"]) (self._stdmonth, self._stdweeknumber, # Last = 5 self._stdhour, self._stdminute) = tup[1:5] self._stddayofweek = tup[7] tup = struct.unpack("=8h", keydict["DaylightStart"]) (self._dstmonth, self._dstweeknumber, # Last = 5 self._dsthour, self._dstminute) = tup[1:5] self._dstdayofweek = tup[7] self._dst_base_offset_ = self._dst_offset - self._std_offset self.hasdst = self._get_hasdst() def __repr__(self): return "tzwinlocal()" def __str__(self): # str will return the standard name, not the daylight name. return "tzwinlocal(%s)" % repr(self._std_abbr) def __reduce__(self): return (self.__class__, ()) def picknthweekday(year, month, dayofweek, hour, minute, whichweek): """ dayofweek == 0 means Sunday, whichweek 5 means last instance """ first = datetime.datetime(year, month, 1, hour, minute) # This will work if dayofweek is ISO weekday (1-7) or Microsoft-style (0-6), # Because 7 % 7 = 0 weekdayone = first.replace(day=((dayofweek - first.isoweekday()) % 7) + 1) wd = weekdayone + ((whichweek - 1) * ONEWEEK) if (wd.month != month): wd -= ONEWEEK return wd def valuestodict(key): """Convert a registry key's values to a dictionary.""" dout = {} size = winreg.QueryInfoKey(key)[1] tz_res = None for i in range(size): key_name, value, dtype = winreg.EnumValue(key, i) if dtype == winreg.REG_DWORD or dtype == winreg.REG_DWORD_LITTLE_ENDIAN: # If it's a DWORD (32-bit integer), it's stored as unsigned - convert # that to a proper signed integer if value & (1 << 31): value = value - (1 << 32) elif dtype == winreg.REG_SZ: # If it's a reference to the tzres DLL, load the actual string if value.startswith('@tzres'): tz_res = tz_res or tzres() value = tz_res.name_from_string(value) value = value.rstrip('\x00') # Remove trailing nulls dout[key_name] = value return dout ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/tzwin.py0000644000175100001710000000007300000000000017555 0ustar00runnerdocker# tzwin has moved to dateutil.tz.win from .tz.win import * ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/utils.py0000644000175100001710000000365500000000000017553 0ustar00runnerdocker# -*- coding: utf-8 -*- """ This module offers general convenience and utility functions for dealing with datetimes. .. versionadded:: 2.7.0 """ from __future__ import unicode_literals from datetime import datetime, time def today(tzinfo=None): """ Returns a :py:class:`datetime` representing the current day at midnight :param tzinfo: The time zone to attach (also used to determine the current day). :return: A :py:class:`datetime.datetime` object representing the current day at midnight. """ dt = datetime.now(tzinfo) return datetime.combine(dt.date(), time(0, tzinfo=tzinfo)) def default_tzinfo(dt, tzinfo): """ Sets the ``tzinfo`` parameter on naive datetimes only This is useful for example when you are provided a datetime that may have either an implicit or explicit time zone, such as when parsing a time zone string. .. doctest:: >>> from dateutil.tz import tzoffset >>> from dateutil.parser import parse >>> from dateutil.utils import default_tzinfo >>> dflt_tz = tzoffset("EST", -18000) >>> print(default_tzinfo(parse('2014-01-01 12:30 UTC'), dflt_tz)) 2014-01-01 12:30:00+00:00 >>> print(default_tzinfo(parse('2014-01-01 12:30'), dflt_tz)) 2014-01-01 12:30:00-05:00 :param dt: The datetime on which to replace the time zone :param tzinfo: The :py:class:`datetime.tzinfo` subclass instance to assign to ``dt`` if (and only if) it is naive. :return: Returns an aware :py:class:`datetime.datetime`. """ if dt.tzinfo is not None: return dt else: return dt.replace(tzinfo=tzinfo) def within_delta(dt1, dt2, delta): """ Useful for comparing two datetimes that may have a negligible difference to be considered equal. """ delta = abs(delta) difference = dt1 - dt2 return -delta <= difference <= delta ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1618729 python-dateutil-2.8.2/dateutil/zoneinfo/0000755000175100001710000000000000000000000017657 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/zoneinfo/__init__.py0000644000175100001710000001340100000000000021767 0ustar00runnerdocker# -*- coding: utf-8 -*- import warnings import json from tarfile import TarFile from pkgutil import get_data from io import BytesIO from dateutil.tz import tzfile as _tzfile __all__ = ["get_zonefile_instance", "gettz", "gettz_db_metadata"] ZONEFILENAME = "dateutil-zoneinfo.tar.gz" METADATA_FN = 'METADATA' class tzfile(_tzfile): def __reduce__(self): return (gettz, (self._filename,)) def getzoneinfofile_stream(): try: return BytesIO(get_data(__name__, ZONEFILENAME)) except IOError as e: # TODO switch to FileNotFoundError? warnings.warn("I/O error({0}): {1}".format(e.errno, e.strerror)) return None class ZoneInfoFile(object): def __init__(self, zonefile_stream=None): if zonefile_stream is not None: with TarFile.open(fileobj=zonefile_stream) as tf: self.zones = {zf.name: tzfile(tf.extractfile(zf), filename=zf.name) for zf in tf.getmembers() if zf.isfile() and zf.name != METADATA_FN} # deal with links: They'll point to their parent object. Less # waste of memory links = {zl.name: self.zones[zl.linkname] for zl in tf.getmembers() if zl.islnk() or zl.issym()} self.zones.update(links) try: metadata_json = tf.extractfile(tf.getmember(METADATA_FN)) metadata_str = metadata_json.read().decode('UTF-8') self.metadata = json.loads(metadata_str) except KeyError: # no metadata in tar file self.metadata = None else: self.zones = {} self.metadata = None def get(self, name, default=None): """ Wrapper for :func:`ZoneInfoFile.zones.get`. This is a convenience method for retrieving zones from the zone dictionary. :param name: The name of the zone to retrieve. (Generally IANA zone names) :param default: The value to return in the event of a missing key. .. versionadded:: 2.6.0 """ return self.zones.get(name, default) # The current API has gettz as a module function, although in fact it taps into # a stateful class. So as a workaround for now, without changing the API, we # will create a new "global" class instance the first time a user requests a # timezone. Ugly, but adheres to the api. # # TODO: Remove after deprecation period. _CLASS_ZONE_INSTANCE = [] def get_zonefile_instance(new_instance=False): """ This is a convenience function which provides a :class:`ZoneInfoFile` instance using the data provided by the ``dateutil`` package. By default, it caches a single instance of the ZoneInfoFile object and returns that. :param new_instance: If ``True``, a new instance of :class:`ZoneInfoFile` is instantiated and used as the cached instance for the next call. Otherwise, new instances are created only as necessary. :return: Returns a :class:`ZoneInfoFile` object. .. versionadded:: 2.6 """ if new_instance: zif = None else: zif = getattr(get_zonefile_instance, '_cached_instance', None) if zif is None: zif = ZoneInfoFile(getzoneinfofile_stream()) get_zonefile_instance._cached_instance = zif return zif def gettz(name): """ This retrieves a time zone from the local zoneinfo tarball that is packaged with dateutil. :param name: An IANA-style time zone name, as found in the zoneinfo file. :return: Returns a :class:`dateutil.tz.tzfile` time zone object. .. warning:: It is generally inadvisable to use this function, and it is only provided for API compatibility with earlier versions. This is *not* equivalent to ``dateutil.tz.gettz()``, which selects an appropriate time zone based on the inputs, favoring system zoneinfo. This is ONLY for accessing the dateutil-specific zoneinfo (which may be out of date compared to the system zoneinfo). .. deprecated:: 2.6 If you need to use a specific zoneinfofile over the system zoneinfo, instantiate a :class:`dateutil.zoneinfo.ZoneInfoFile` object and call :func:`dateutil.zoneinfo.ZoneInfoFile.get(name)` instead. Use :func:`get_zonefile_instance` to retrieve an instance of the dateutil-provided zoneinfo. """ warnings.warn("zoneinfo.gettz() will be removed in future versions, " "to use the dateutil-provided zoneinfo files, instantiate a " "ZoneInfoFile object and use ZoneInfoFile.zones.get() " "instead. See the documentation for details.", DeprecationWarning) if len(_CLASS_ZONE_INSTANCE) == 0: _CLASS_ZONE_INSTANCE.append(ZoneInfoFile(getzoneinfofile_stream())) return _CLASS_ZONE_INSTANCE[0].zones.get(name) def gettz_db_metadata(): """ Get the zonefile metadata See `zonefile_metadata`_ :returns: A dictionary with the database metadata .. deprecated:: 2.6 See deprecation warning in :func:`zoneinfo.gettz`. To get metadata, query the attribute ``zoneinfo.ZoneInfoFile.metadata``. """ warnings.warn("zoneinfo.gettz_db_metadata() will be removed in future " "versions, to use the dateutil-provided zoneinfo files, " "ZoneInfoFile object and query the 'metadata' attribute " "instead. See the documentation for details.", DeprecationWarning) if len(_CLASS_ZONE_INSTANCE) == 0: _CLASS_ZONE_INSTANCE.append(ZoneInfoFile(getzoneinfofile_stream())) return _CLASS_ZONE_INSTANCE[0].metadata ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/zoneinfo/dateutil-zoneinfo.tar.gz0000644000175100001710000052447200000000000024464 0ustar00runnerdockerݣ`dateutil-zoneinfo.tar ` 'v "IP*J$A8b)"Fh2JiK㨽j߫ҴF]2Z>&u-߄{&3+ә}}=4j$-Eoo>޾>m[ʰ$ғن& igibilKdl$ ߁A@wvzߧ>ޒ͞?t@bҀA1Ig_5?꿟OwHLDLB??=Wye?+novqBKJpe/^#M*/_XeM?|˗אA|9MrExBko_*$_7evO3 o#^z W7O,+wꕷNҫ|\%r3orQce[|trrrFrreu_zl/7\uCo4gszq^ɟыuɾIdd.Se{r1r*S&G䦷Rf_1Ro>bC3ӫAk5k[Po]EnSܶzH䐋[rK>;ܤYzzo]czD[zF׽rm='ZsM}],-?wUߔݲ9˵w5>cZ,YVسAw#/C_o'*' I+|)%9իjwmG\<\6O~i}_//H=b>1z>|n | $Űjs+ I%e轟!F~퍽x^VbV}XzRฤRW`GXg}c;,uWN~X{LsNkfv~36t眎s[޲͝RWGa[Рm/7H(g[ixٖh[\6۶]s2issuX/oٹ7չ2s~dېq=l_o۸<ӹնӫض frm87mlȃί~(.̰`Om7gh-l?Tm?r sΟSv:%:Iy2Bw-N5KR/xПA|gcwcO;BM~_@?! Yߜ^sOUF͗\_߾d|Y׷.QvTߵc\{hpX80@9{qzC {Ƙ].-[#h'6)]VY̛گfU/]g^,^o75o}yGFWϯwǯ:[Z1=aդQGՂ ? .m.~@+R;X-r^p龧V-Z}Ԓ*$ڔiZ[驄jjcRN|ZdP:۬KZk*%U6_fYClӾW.G&֩U|QhTof3i ߴ[6Z4Ly){HqϘ_ v]~7\z{MS_hvC噕G)-&8]Wi9#hHUa^cnզFp;>61Z:+dkO<"[l PL%@q "6l P2)NXek╭Y(ny5/[l P5@3[l T[bI͖8✭u6l Pܳ5F}?[l 5@Z@v2X ]`k-nN"`N'`^5@[<'`k4.[%<#=ak4H[ }1LHk7l 5@i[?l 5@:i[Gl &5@iEH bN*&[Yl n5@4I:ƥ?iI:A&7 ;xgo[UYxr]#Zx?>VRZNHs|Imև?߾uMUԼy#Vu6̼&Iohfk(]P”/!Md{jbZAEPK-VT^]<[r7ŌZCS5K-|W?H6KOLʌn>]*۳Y.TieBRŚj"*TԪV{SZ}aƬM-YjnZ0kKu4[-y4kzd0]58l6h3E6螚亪Ol;)w9=I;U&UΚMNgJMo}c6aH|mņg9AVR::Qm5N nY V j@ + [~4jZ5j>52j-.)ԮUkhݴujSեߙ%gלR}m8=OT¿Ԣ&P{VKbBZ1i5]njF'!Sä=w͡ %$ KRR\sXRr fr-5mx˵7#&k/eSGN^^Hݷ6*Mlh&=V_w_F"T_!ї܃=Lq/P0q/PPqI# 3 2q/6l\Qqaf\ )0 ŒQf4q"#(=[#8= l> 3 X.(h0ŒWܳM}g]|z 3 h.(0悌RsAFA:]ܳzq#=Mlg>Ā 3.H=ۙql>DBܳ `paF f$<&ŒD" f$&< #AŒDEܳ=qv'Cd=۳ 67l?}g6C=[!F[C=Dއ8qaF${$TL+.H$Z\pqaFŅ ߳%{$d|ϖČْ=[5gKƅ')8&߫%cZgKlI- ߳%!{$|ϖْ(=[FgKlI -$߳%dXZL&&߫%dx=[PgK"lIHyNAblIPmwVgk {$|ϖ)${$L_gKlDBhdgK̎0gMoqԗ?,اUXU[I]#/>sCa9>ßo'E_Qy#Eu6RCL\TW&dRqGBe@T%V(^V-^Tެ]\v7?֊6Q)^r,*!T:"C%C\g mMSPOX3XT]C|^xQ"z-h՗kڥRO]vW5x'Mu-)V٣NSI4ߢ78ASzxekt=_'+ rZ`r*ץ&gMoE7H͗-6|DSzchʽ[o5n\ez藵6^miW!hJ=_+їvh =Wp>jqͳZ>qcMܼ%5ֵqݾC~YMK=3ؔ{OS}'Ҕw/mMu]zԄ Z8-=&s!UbwEqKiqO_ֆL!ǻJҔԤjY}gMQIhji*MIoMVhG+NцoܤLf1j4s̏tL3uYBI)43U7ULgG`+dDC3IMeQ:'Q'"E_Y%]NDP_ԉNQ:A*Q'"XEIE)UIȢ9D0?Dܘ lQ[8EE-]uE6<E轅ZVRMwE6 el/D5g[>Lb!@!W5Q&zI@D+zIHD?Nl`V MY=?hoճ}]$6?$bVއ#IzHߝճ=]5Q+zID]jP_CD/z!\& Dߦ_CD/z!p:Q7$x/)_?QϗDOl_CEE?A ]qEE<U"^! 蕇Њ_+WGD6 E<X"^!Ģ AfU[U?pol& z G4o?.zpTB}e}g]5⻧ Ev= eſWyWKo+[[r7mG e}c{65XjSgm^ͺrҜ?9@9ܷk>R?e.-Q@䳵E'N?\ssmK겾2Wt8\Uݶ-k2מ|>MW7,#tN#t^#tnˏ sg~\k:ιX3- Il~{hZr}Gqm@\>t:Vp@\3 ĵqO5Ϛe ʵml>yaNY[o1Zo鿥[[sQC$>.]s)[o鿥O'Ħ="??Ŀu/X`2HC~zΗKnREjYއDpVf_@N;O !+[VJv?K-/?nذG~Yߣg}g]߻gEcd-ݻQ]6j6 \fXy)T+[W|TB򈤘G}= 0^im7GUmb֭՝^{mmVFJɝ@l?zs-'\S ퟒ;+Ms8K-uT\RncOp59K-IaQi= *==/>[b{713v-}ա ھY9ҏ=[un}yI-2dVdPR-o_QKkI+&NkjjUڽu@mxSjuZG7N3NG Nχ6G|gQ8;g|R0%~kHg%O;nk٭BgQۢݯ?uOm"lۜ=mל=#:{`6u6;{h볻Aӗ9/T"ms/ֶEwF댹P6Jggcm [ܤzθM!.ې9[؆ϰ%;LlVԦ|A^LZ-L-yәj-53o VۆGrQ6k_;G|y t66韬+/_w8 ^RZ ^|v_%z7~v?auʊh<1iLzd4x|[L_scLg|4֘4@9lw 71ACc#1ɤq bl2i| ) b -./1̤q b,3i<LL|i|LL ;"Z̓ڍ:U=+[N(7^XohϺս?׽>}V~-6]j;c&UMDMo;h-?c|^?ņf[-WՃ[k*?׶:ܦ=mZ?!Oaav'f|"wعIM㧳N W=л]!z ݯ{ʑߗ{ZOYZ~~yr)e9szkԣk| ǴX,Zg$q#G"! z;^BOUNTCW:7VTSJKrW9=<./y]&xHl _^>z}ct1lS օȾ8αxb1׺ zޠnZXD8D &?HARj(H(1\57(@ h D:"@ D F "(A&&( @ "Xy2B "hA.L b̤` D`n"A:`dH"A>! D0I @DM#6H4"`ӈDM# 6H,$"`sDCB10ua ӧ 0y) SC\B aDg-Cؼ!b󆄈#6mH$J ' JbBؼ!b󆄋/6mH@6$dIش!AciC$qc9al}6$x D3 ?|F~퍽x^֜ܬߪV5$i#Y[omymD% -kO3_ר7?[K-/p\Ĕ\?[o鿥[[b M'ZK-~Rr-];/ [([ײF?>5b{LC~-*X޽3nŹ[Pg4(618և_3_3_[f>_Fbʛo˻O_[U[=mRLLr⋏g~~>V[omy!Qۭ-kJ%k K-~K-r]E%%' ͵ci/='u/Y?\PVo5/.6*>XKV[omy E ʵXXYo鿥֖!*6qXn[omyqbRcr)K-<ġ1;ZK-?>K-<)CG K ,k5䱙"Xo鿥[[xT|Tɡc鿥[[鿚?K-v&8R=pKfwS*VШxY~JK*_TiVY>Z㕋Mm>5ڨeZM~>N@nZӷeůMol8>@qHJW,f샣js_QJk?"tW8 30̀8;L:C  )gIg Yq@=g,8 &3 AәqvAagęq9qAyg;Wv<}c5$ ˭g???|} e}"5&)N;n||cMƷ̝g˻Vw}Y^ڵsc]57cyW?%'~$ڔ+5g73k5gnTɬSݬ|QC}.ٺ&sFn}Gn[k=OrrX-[f(/×$}yR{tdHCZNKIa϶O]q@*I iq@>IIqJAV18 N5גN9i5>=(1f#m=uL^ig%ojպo~4*{)|_3ۺךQ="-pf鷴?֛HԞ4NoM gIZzUJtHuZWxܬ/-brȍ2ZV=kZEkj^EN5sKZKIzנbKnnryǷIrR(BcUC~|{JU;-n0miF5)tҺUÞ{>$sK퇃6Y+"Yn`w}}]vyw|GԒAchAέ@AJ`3x2$7K$Q\Y* LJ)5<}|V{}j4: a8Tpwq ]{szY~VR;,1([ww~1-e XVomj˳uhܝI/Ҕ.g,+YˣϋVct~iR,QJKFgҥat *DVҽ]x#J^(YxXePթ?1]S2t7ebF@ekCR-7G'&EU)/H zW #ٖTiJݕ/M#6WVF6^Z`ĊW(c4'jmqlE1L6~(@ D"^@ aR쀈&8bR,'&[ D3"@{ D C&"x DlF "FyIq "V9OPYP܂] "A1bDV1XOeomtk?n}%[oHekyߗm( {{!=G>6^YI{3 򭷃:Ҽ U{k;}%NH؜eߔwl搲׏+j]S)\Sq8h[!Mv*78d}I90qtO;ʱ&㣟VNUva)Su8{\ƹ]n_uyʕ1W_W`巖^\j,uF;YOFƝRu%/i6a+ߋ(\R :9 U {rTS{9QxQ)~hJR S HW=2#kjYU.QIB;FŚUdTv|RO{*նlqT_Y1kÖrxzkݾ3j m_cin 1.J}WӔn4[ikt {'teQ],thRecF[K\vl5Qw5_j(-6$}KWPոuh5H ncw_ ?+ [hw}ᣞW:)ԧx7GO+]R2]W"}戸uJn~͈3CW9ۍGGo"0i"b2 I& & & & \oDdĄĤ$) QT07x$DdĄ&0p5m(4bgO:&!9)*>v?@{_ol^71}gu~|Fi{jQE몘vJRPC$G~Lc>:M;PWn41I5zk"[h'ԓ}khWTO4Δ7zT^)o9 ;I'}n^M]o^vHtFtlt;#LL\P$_ʞL*y.I_*t ] {ՊhE͚\s7?֊6Q \?JwlyJd*WbTNeJ(MMKW$XTT9VJEZս7j[~Ѫ/?՘KrcVe*3vRʋ%TZBbV=JZsTB5گji/jWvѼFԼ'k>_H$74G3* ~ Wr:TZlGTjtNk_ZM4xӂtV)P3d4d|>fӴ;FhxS˨к\SVEt;FvӺשOUwfvLטfqh==}L%K-jm@lo5x-&saQCN+-n >}B25w͡ i|L^[hj<Vn/M'ə&sԣ{ǫ7.FLN5:E{y]#utژK>o-X?9e.rbJO94Ķʺ4m}o'j.ߓYeS5#`dl&ܳ́|[D"ܞL-CrnI =$+9 g)ܞp{@n$އ0Iv3M g&ܟ$U?5Di '!MP'5o 7:C*, dKAyB@Șp9nO;M=p{b%DJ LnOC&62DdV=75 &ܞ]LHp{j, g$ܞp{HY- G$in n EM=]4Ԅ 'ULLJ,%Hp{nhi& އ iq]!a3^=B#+_=" G\W&ӄYX2)B>bD %23MOGU>#4xH%i *\p}>ҋp}֩. ;}H7Yc $\Ml#4$\>p}Ԅ3BM>UׄB M>5T},4҄sBO$\p}J9Hgj G-Rp}J` G-Rp}D" G-Rp}D" G-Rp}z>RdD` XX۟?QÒcr/]W?"-9{Wں~QpyS - 3ysnʼ-; >m.8m|RkʢۋOW{).yDuhOcvQ~ꪐF>5%\W2u2ןާl(aEߛ_,u77=vRqFm6NIFrL ̭j}nFs'G(iqj䊊OltS 3V ߍJ`f*?MN_2hc̏iF4w\jjqc:MQ[GG)mR6 ~F7̰f 3&)ᣆT: WS ({]RN+]V#+(O2#0"]6{f.0zo>gjFifJ0D9UDƄx)1z]ոBW(C63\6V57e;솙8VK3#9'5T%ux7z)#^S_h2o:}IyymWO͘_=.?l0̨`?lOعtqybMV @ $F=a$F=a$ F"ɭ8$lҐX2I0EOC8EO"އrO(DއrO*rO+rO,rO-r/.W`"=a$Fb=a$F=a$8 /!FB=a$Fͽ`$ 4՜_Mޯ#p?q 7pfnkx&<$ 7ECTF+ WVn*zpKGM#)7 "AްD!p \H "zVwl"©ޱ뭈ޱ^{nbsU= &FM|nb3S &Vg=FHBM=FHFw,ScwT&#$'&#$)&#$+&#$-&(FBnX LpCL&60X_׾U<\m/o'EoXE@Aa@T%]\E]\mE,]\+,z^EU,zʢ窞=WEesUW瞫}EtsuN=WdsuW=WdsU=W?j.zf5]\j,zʢ*T=W d:S\=WeZ残ڭe:nzWnO ]ESrX4(DS޹z}Qk:SmZ.U=n'ۥZS'%垙ijʽΧ>iJ6.=j }@l]b^zxj"¥/kC]%iTNXjJݫ;hJyGNJ\ESɟNSi yKOmBK=zD^q6|&}čTmd,HmW5FǼ_UϏ ܽsEN7"89\8DpÅ?4ퟹL12-g#epcRȱDa.L~2QOg#]pdRHBaת$ܔpSK77薞7舞7h7h7U=goS􊜳7(ZVTOD77$!go9=goP59go]9go19goV9goOzޠ-zޠzޠAzޠqrޠrޠP9goP9GoIQޠr AAAA.QA$a%zHD5Wj>H\]T}4QOE5&8]T6MTy'yO]T'EoIw BQ͟A$AFQϗD5ODITdQ͋cC2E5?A ]Tq袚o/zHJE5)zHREOP)D*˚{̊j,y.YrE5OYT$Q$j~  9ռWȲEBE5/2-ykQ袚m~0QH{U[U[۟c^ ZzѬol^WB朾n3?;8ʹó{wÜ[}F0ol'~<|qӓ;,>2]\G\>/ϊ\9^jh&}ڶmkt~u|Vh ;_:|~/1-<~B 6^Zq:&[F\ZO5sm/d{ӕ vD^U]]uX)vJk׉_o]8XTE22~z\ơXp>ydУG4S$XOѕ#O=zۑz:bƙ2ֽqsg{ 3/_~a3⦍~it^~gf1^My_t话Dֲmu^#f67oθun:wҋg+qwtinv{یϡ߆ &"O#KoG/3J/Kd&dtN/=ёQf_Sqe{K/V6|QfJtZ*ZUeV}d-V_>Ƭ=מ?fj Vm|N;dr)<д@_ W\Ws~{WPEٵA@wť)SeeoQb^Ta4mZF4452LM17\õZſ,½, }"w{jws=ݴv,Ӄˡ,u=/>QĠ~@ )7_wuLQ<ܴ* #JG"d.):89\rS9\r3Kvpѩ\rt2E=Y"eTO)bX "e7z9 A1\rt'bXؓE&9\rt,EJ)7dq+.,Rb")XdŜEJWmXdEJWuXdŜEpz$+gn w!_ cGR *rRArޘ@kUUtrH9-aۯH;õV+ͥ {u؉^3|eݜDU!׽ѿzmp1Oݦ5L>@9wW!T~rX>zx+'_T-eysG fs忪0͐?9 z(m!Ko4W< +W<n{w;U2|}JnOeYuspx\yʚerՅK)ru4FbRsȽr^":# UV避7Wh_z79+Z*7?^ePeCG[mg&wګ%]hO1Z.ܰhIiFvciSд[J-hzRRxQ*}/߶w}O󕿍3^;3:e,;`tQ0uwmң r^^++wO=sCz_3}G#Fm1'n W}? AooSb"|@ra|_2L a&'oш_ycS12v}FOC=qIO._OPcP]S5WWL%5eV'%~1.j>svx,gS'>?94xٿ6b2udh:"h!.i ' cczKj\rh5R3DREKN˼ovʼoʼo/24X][:k:kC VyCo Y]QX][ })+L^ 5kVY]3nuXfuX];aFյy:ks VמY]0X]+6`u-Cfuյ2k k=eVz(K K I]4 T 5.CduK)Y]R1DLVvɬM1X][&Taumꚮ&v@K#e.PX]s `]Km:\XGk鬮ivT k5"2kGdV(Y]۫6KY]dV Y][a45XK;묮MUVյtz%VN\E0Pau{յV׶\X`u=յ V^Y];fPgumڋ:k.H \ յ$.%dVV=ZյG .l6@Y V~R@4R@8¥yX]/vAaumꚩ6]fumյk鬮m4X]{Dgum.%s) D..lȥX]p `յ kd.dFZ+F9V~RX]RX]c+FAV_1Qյ4K[ҍkZs?bFǦǍJx$6TOHdxhPxPR鸦Ok:ApOn!Gr zuY**~}S9sݧϢٷ촶ݼ lґ 'JN_8K;?k9+Qop'{_}3mw=E:J>k,C3oc@Dk歨ypMM āo*qۡJܚ7E8m5o*q Ao*l 6Qo*l% .U7|mgsXLf `;5Cb `D5wtfiGg @XHY[g @k5kwɬtp'DbogĜ,jT'?O\Ze򿰐o _Yu:ߎ66sv!x:W4L4V1рzIIX=nH͘z cC "#'CŸӆ:4'Ėq_Hqm&)I 5&F9vةkCB""xH*c~ IHM6.!5-1%,h&$%Ħ% ?ޥJOWnkhĤ6#G&1m9-Јt>??lDbRӎbf䣷ఴQP|d\||dDhB\คذaC#"CbBۍ I'o9"nxB-<HǏ 1"av([p[H<|,rx Q"Fm7bDHTXayuy[?GSFUbq\zw_ 턱)j;)b$gR~Bz\BzB{#bSR'5<6n4# "_Dw"nY)QĪ;y)Ɵs^{9W$׿&_?¶#m&Ә1ODHHe8xv\߬ӌ6?8x聙? x;Y ̞^;;M3πj ȌNĺM zBy|_8諀FN^ӈ zM^r& X9U-V=; k:LvںO^uݓ7ə'o\OOiɛ=tuS[Ϣ[XnNus{{Sku+8VΌӫ(Wz z]a׮qLKz =prK3gˍ&M?-+Iɷ(7nMUܤA4E:7`mg>zU2O_=ءM_/C<,X+lk:^8UU=x8]ۏX{~Nz #2ɝ{]]|wr^]KɽO:Acjuc9LW(}7yثer>ܩpR}j}dC]yr>|5A@}I[>{<ˏ^?&oONԟz)Sǻ"~PV$yY=Ë}ݯK=;R]Ijx4p(uR`x] pH?Wǣ8(E\k+T|#d.2T HC߀6T Cu;: uG@PIQ@#DP2QWt@'PPRQwt@+E;: uG`'3^D2ړ hF{2h/&Y@6ڋ FdўL@:hG]+:uE=~di& $佛""T-"$ZDIh-"bR=&~d=E(-)hU"EtEQ, -ZD[hu"EEQ-"1ZDch"2EtFQ-"5Y@kh"rEFQ 9ZDsʌ"S6ʣ"£EGHO-">Y@}hb@Q-F bD@Q-Fb@Q.b$ Q-FB bDDQ-FFbD!>:?݂l-(m2eBO'T?7[za"Sk$u5t:* m6J'8Iŋ%_ʟ3%fJTptX* >* '(|W]QNXOihKP[LkWΎkߢWgG zscXouOK|vcuS1L7MN0oz|$0o~ ʼOsq@Vf~VSsVwt[~P[:ܥ~u&c6P㧨!BS[aw̲`jVDVVTjVsoj~~~;'5Q;̐Ԏ#|N N].X]Pu1K7Y=~n̴z~ϺIV/Y}vSb >菚S@9$ |zy;NUv<^>^ 9Ohy:"w0 }Hw SoWߦ+o)ᛥ7vi aZwo,|Ӵ67NoT3&tXdldd,d2d2h27YD.a22K=]$$l$l$l$PMQMͲMi$l$$>IXSIX{IXIX#IXI2 Q5?w&0;P%*MLp2 d1 {b6Oeb1jhgU/w_{x֢+E/qB>*!9M*=DV`'PuOvRu1E2otW+" E3hz[e&Wf֥t =DѢ_Ih7ѢEE~}-+1EQ)IJ]9Y>:[*`۰u@/焤ie#C /Kx?g4]b8l٘5mc@xceθ 3ye>2pNĮ,ڪۢƢNYmIʒ )ˌ ++f}{ݧ|,3>zS6e+V\0>ycqF}ӕMW6LPܝi|uOm1mG*n>}co#}#VHn{GJN㮶B}q͍L`4C+.x9m^VrzM9REUr:Ʊ[2N:m|bojO0߆ݱD~sd́sʩ+p|{Vm # k/_va7W6CcMʟ^ +o\i;i{mkUOuao1ݽѨ>A6j5jj>ue}Xg>}9Yy/3mYNL֤4̩_XپYy~h'*XȐˊ:}.w6I2ncP-4rtmW.슝;U ||KҮgT,b+zWzXKoi3`.z]vw=o%LpVEL]Idys?Ѽ9^#V>dysݼY׈WYt Yv,bSʨ~^f;1ou?naݺFkh 4R΢OQ:{Q2cRYz7?꼛]]wxדwk<Q$`W隆2f  ,_jOxaD;Ƨ8SO@GoggJEҾ ھ9}GíqU^?nt*VrN>/W=~ޘyyV||)IS<8y~"أ9}N8ξTyEQWךt-W227On_MX!ɢQy5o7=7% e Ap[d}|\-1/+Ew&{I!5-L 2}-4}q#( ;.?<4ЈːְO\?w}py@?k|`*`T`(ٍ{2xUۻ?ގ7*ܕ>%%J2h׌KBY?q]˕75hҞWw%^ʻkVdk/I]>z3Z1MAN"m@HEe3Nó˒zekj / F /شRK[DXhH,ǎKD-L`5ɵ6խy2mO[ mobͰma-yZsa{_D[ul_`-]ZfWZhR}@>59"~޽ȨHdUO)YyO('NƩ8Y$kQ\sX-d,dT+S^[,kL3m y(#cڭ혓Y1&jIC}1w/`x{"Q_ !a/ bxE\" D}1/`dq_hlq_*׈]K_ 6qn}1b]/`[_ @|,YX? ORC$DKELEJ`Pb$kkd$+DJtFMxw0⢜殎~#? P|U#P:`/WQǐ0\?>\w͝לi˗kծ[VZݯhO7?_ tr)O< x|;⑐7~{۴VAg;9g癒-WVlr{imӧڃF< M},['WH?~b=<o:K.%UԸ:a-puBZ~&1}b?,Q|p' MoEb8Yt1CMMɢ1ſ,Q{p?D Zg3ζ3>1ޭ1-'S9SSg4$ֆzzԚЅZ+1.1Z7ZדZsJM\)z{)'dj/3՞T{hKMڏe -v/i.Cq|ZJVH?e];)+#8FuomO突򼾯[m/W}/lWGl{ǭWsߵW7߆\пK _O4哿lk jPk5ޣ֮QB\z3TQ{q MYWWoO=ǒ˼b'|K*?:SfkOxcaT!I*@/)!x1'J?x3ҸUf"E 4<&Tӄ |PO*h2@H2F2 e=*U1V`c2F**l!dn)qB5DlZbȄRKEF6,#k_!vGڹi$<\G@]:3\S*]tչ@u)]quX*Nnp/>=M,kf\GMGWtNwUEN Ou0vlF\  x)Yg\u?Dt~VЂuu{4U7=]%.wNˮΰ,b59j49ͺxKI׺-}"Yg5ig5?g5ǤMfњO:jDsM@佯@C;I:>rQmmޥvVڝ´3hG:e:wC_Z.g _]hQWB~1䦯A^:rZߗ\t?9Xk$ Di[6U}mh1 ҆ ;@> #r# w< r ZM/Bhh#|h#NF|^u>^K=t6ݾZ8jAWMS'ArJɐ Gg6>vh.r%oҞX׵^~XU]xΊ4~g ]ߵ~R53]-J9:z4ŸJ88Z#_瘻L_+Nt[EOK9%' >_f{&\ @U||-`.sx9h9yw9y_9yɻIi̜Ĝ"F3'j>ssSsX0fNĜ|Ɯ|Ɯ9s5I{Ɂ@{ /<*tV/C" ʒVN\M8!;`~n_D>)c'Lt- pu/;w_Jv]P{K ]w?';qҞUp& MP{C6_pӜ] \ ~^dIKbIZXv[m, ( ou}KnM7@k_?T ,_c[dtKLM_4G$􄫏ȈBE$c!oe`ƬoƳ+scM{,Ns&veAVwX$7wRoKRlߧ,]OYfL0'XY15۸ܗ5cx)s_V\pyrwf/n>}co#}#VHn{GJw~{.TޗxA8T68ۡ~C<6/+9*G~Q9m؎-'V6\Z[1_i7t{Z ԍoCX|_r@Cީ'*3^W[?xo*"{vϝ Ck5mw;wR2Tn'ۜ*E9` YvN6E.'?0Q"rxDs`h ρ+<fs`Z/Udh `ρIRx>SxkIJe b<90}ns`/90m `cq ^̤}rIJ̓ALE UZlI&O% 8뺸xK0EK0-0Zbh".ElFLg 4u3}0nSn"Q"Jv[EGB0|4 I#bK7  =G'"DrR縦gi)w۾s㷅59elS;RbzϋkS[6`>n:`I΄ۙL3}%=! y*隙c%B_a)#M./)?'&ZPA!u=T?Ͼ37dM3=61:fêMAOe/j̾ys謧;=jDoZKFW?@ T65,g̜Jf0~T#?4{ ؁l5߇>;nʮy릘z{=+L'Fsf U\adrS=,xUPE)x Oy|-dcJ J /I$Q_*.T'lVg%?Pr$ՠE-IGk t>; ߈Tg{$R^S-]urR]g;boxjxoH7ߴW;,ܝJܥT~ԣS1u]W*Y,'d63u!]w)s|ܨkg!̋z颌ə"̐%u{xZN&xr)rSFQn$# ~#bѵH5wIbOqjJ [ ,Nk9R;mut77֮;ﮎuX^Q[pg7_7ltJR[474omo毯gR[jw^hvgk{]_Oz/}sk`vjX$UZR/4a7GcQhTG~`&Ǖ6pԆz teE2KfFf}b _.Oi#O[0g72j2|dn2L0}2}0}F>>Mffa3Iv,nfG)6ޜ>7Y>[>3s%k ~yq3*_7P<*罏p v$r1>NFp!t]sT @HTL@TL@}`qMZI$ XCUƚ3EYʆZ8ʦQ)c&([:5>_zۧʶCƶ#JE)˩gѾ~S:z7+8VΌӫ(Wz v _kɵ waoa?6!1B@:%{ zkQfEյ+<;[\[rn̿uӅ‰: 5~Oo5~BȡuZY衕uZYu!ZY(6/a -BY'ZyFSԨ}%>Tr_)k+m -B̏3xeWo2,Z:^J ?oJjz+^N Է5x~W?UxH"X `ӵ'Ҋzo^iD(% pJ7@*ZUh^6u̢-JщVbrKsX%d'[t[l5h#^/_J )#  X״cǟYv׷< IGT>Sվ/S7n>u[yTOLf{ʙU^8o95xU4קNQ!Q Ƿbn߫z^dE5)꺰BGj)I}//zsӛ]'#VE&Y וQ:Nsg;?쳞6\>Hu^@{VrѿҳT[g@}O9^ [muxy>ܚU?RϿulĕ 3S=;?z=;n9ͪݪ֩ W+QSTY?z3Zr*Oժ.ǮԪWVrKB>t!Ot7zTpl'{kj]jO3/>.A蚐z"=4mv^M6٤wt/YB?Go2x*IⲚ"EH$p+D ]P0t97`x~hA-Y@hAH &Q"EdA- iH! C PtMD@ _$"Ј!@$҇Hd"}Љ!@( }HCHB}#RFŎI.-/ߐ`=G' G6P[Xh&:촻)JR-C{g*د &Ңq >諵riUQ;6뵶KZȃ;RK{l _"B"?,E՟E ;7JmM]Zwkwm9)L0qD-SFKs?.񕥮Mkݺ{z4+9GRc鮯_z/)ٹB4N13һ~;$^iwY~d|Ky,L{/܇~ތ.r K6=DJg9#+<(w.ܛp iΣ+;5V8kp.Xᜭ¹0ܿp.X|Nb·= $+4V8m+wipޭJc3Lc g-ΖX}3 pgi?XXb5N_X|^qQF"ER6-"$`QS뎑50OF֌/Z3MQicq*aT]ŽY}m-sVjk}>>dlJ<'H%:[5ܱ$*cr_NeύP?Qg޾)IDo"b5՜8K]1vܼqkNpf*SP%` U"W"*4gY"ngFl?0j8VQMۏWޱz&jq)չ)Kkj.{ڣ&ۭ^VYw}=%yjߗS}=0}|*Vç2V@bwUhnL !w +=xY-er^wƅ7;ߏT˹ W:p=eƺ9fܹt -/y#oFzo=G:wdF5ރ}HE~$ $p_{?qwAjpuTT晻TTT晆ǧfol}W]5]?Zy{ft̚ak5^Ffty:MzGEni.#ğ3Gd7`xl%y-ol> Vf?g7 :goOhoeOtU2WD~uMƴScC\jvnN˶5L5:gՓ8N0Zy5/zܕ⍎׹?ᆧMiAn|^to6/h֧thA4뙼)4?f&Mp^М yAsT4/h3fɄsD6 gl&=L&-p67pd3`L82p; Cch&L4WD3\ng9-T;ͱL4ߏDSL4SM)4n5p~uhEŶaˊMOZRJbw ?Sj\zb'9!!6uR_7&GǦ&" _?r\{u'+),M]rf_,U?Ncfv^cMţsx]9w<8;K$"VW(YWu{h+@ T~!Dk$ F$b3|G#ďLIM--/?9!id* /+#&H%] tĴq c=#Km?<4o&QĢMUqMgυ/_0c%r"kY S'6+4O iAgj wi5ҏϘb}\CS|m_a\O$՞7$<{Iҭs&l"%*č::z4tyRz=3Rs/IO;=ɽ  ^&FhY:ky,x"A=WぞM,͕H@m)Њ3|, Ho[[!?eLB /#>aFԟꌃ;͙Pswj\b@:O=+ɖ7Wab|NSu};Cj>:Tz]+l-skVYJ=օoWg[_S+̼O8˻4b46_ߎvV@v*rcZU^8oUu^jKTG{%깯/}6ϣcuwaWd*俊صAh雟q3-uu+Judgra2cgrYdrfgr)ۙ\!w,Kk\V?w/K\3g2mgrdrdr:[\7\>e2tp~Sw+"q?yXR SbotO}(a\JI UqCmQyU"TJײ&])yά91]qj}WZEjhK=ڡn8x(yڧ\3W,ɷY>5MAc%z h]-t|_(?qmՔ2#CCDXp0wZq} e*3wx˞Qg56Va3~[oښ&َm3Gv yM/n2aQ"x[)' /.߲spM&WeK\,@52ct>CUSc~C ?I؀۩b^eA6缍ܛlY p[1G;*Ns嘰&LX%;Q\<ۑ KF4LXs[6oP- >uIS7_">TF_/)#KlbWY?~O9k#*[jqg?fVkب ؓ]ZݯhO7?_ H{ @Ӏduw ֑@In}Ze7t6Ӣyh#Xszʠ7?Ӆ`_S"Fqmwp^)_sK;Nq"iuV[8V.t DhёТ3E*8[XdH# T.p4VIr\S$V&Jrot@VX.)LbֽOV3tR%QЁYrnͪscBD_r—yWȧo:s{^`9b*OO MJJLN._""+C';T?kH띳'kj Ma.9]_"*nv刂^zUĥ^\g ZL,+VxQ %Zj9[l]˽ؚ?S U.ֹsU &spzbΝ4D<:}^어(ESh+xX눽ިs^[#>'1{},X`{* ) _bjlr (P"9YQYc:NYgy6OWVW7ڪj {rz~B>g{ uZ5Z=רkorЪnZ0{eX;vtɣBQU\Ko_Jλӷ$KɅ$݀9Ba?A-Yp*h]Т p:*EBnDK*W;%5Yp/"bLٙ/ĒXb@,Y_(u / ߈?t?JLKL+qޤ )Fc?Ru U5?Z@ fs Sq+g~k3?\܀»sj4[d߹FO"5bE/s訑))eG[d2x&OY ڳ2~{޺v6'9J_Eo>]zYU( @8N-Wb%z)|w V&)crnn "B\}1O~^NGS,a^UYO2*i[?QVo\#nd{5_qPlGK!._Ʀ%&LH.U Q?=1.lȈа<'eLBߠ\Z.-VpX*Gk>/9w@=Rzn/_?Q突녮Nl"M-}h?~wc`/Z9^k jeE_c-ѱeǣңwū}JRջnxp/JE]qs$L)ruc^vz`am8x8Z$MBޅ=Dac}dѢEODވ=-z%ZL=-z)Z%]Z`[]Gıie _ˌWw<(q\So]o%ؚ7b=k!- ;MEykg/gyWqTzUZE&_X:˱ܭ(Y5jL|Mk?x܌9`x8P9WW"WzC:w%|>1}-b_Ǩ^z'4ꈿюf&.׸ ?$Z-tk_ihSӢm?m|ND^N=aw9E/qF?865--44@oTǻ@|EvQ5[HsKxܞ5\hMU־Ej.q>\SɁN׵k.JEo&9pd=˪ү ~{mKgMRʙjU^ fDjrz3Z|=@?Ff؏Zǵ5vkuy? RP2zRyӲ;/do|^/Sng>xbED|QK_K$?K^"_)K2Cy*]| w~_/u_, G_T=o뿿 @K5]%R*ih1y{I Y=:su9IF:oph:Nq?0&ٿ;rng\.!aa8¤y/3|hk=t;Rޝ3ā.cJs~*q$-G^ PDS%\S(iPETMC$k0gx>K AD4TqD8KJ6 px?*?0P!_Hy h']7w=b;%h}ڇVu#|}IBfg5_-JZKӍڑS: "*?E ?3Xl!58  a -A toX4Nؐ0)i"pD<o!fE!4En MQCSEA4EnMME70Dix! Dě7o&"PBxc NNMmst4,~/ r=I;ۘXUL)zkPJY.xղ[[V>hO`ź3)®пU1]EirRv: %N R~[sGnk-P"7-O󖟦)ƝTKzI3#/ב~%:K"/F_="D x'n AĻB }I;x.!ϭ7xg=<~rpsAByO< EOyG|okC>NNmsDC. C߷JŬy ]VԍϜߝU8PG@\}\ ү{9#DᩆRK'k7Ջ/i>u4J%Wo|mS/e5J'1nY+[F#1KONL/UW-Uj\0LR^dZPڙʺ߁JF5e֥RĔ<$ NbH90kPuFt=`\Eo>vRRHztBo.ÏWZ?.sAjumYhesFOWzn3:O0:ww!CxD$E-FnX u=C#)O=^4poj&}Z}j11_bk~/dH6[=wJCM,#n1,q_f_O85Ho'n$ГVw1FGOF{1iص9brLCImJIw)OI=%p1}Ҷ}eק1nN1=HP"[ꑛ^H͝%4%Owoa- Dˤ1#1Q"!q!!!!!၆}I0@ 1"A"QRXGu¶K,:Kak ,1X [+Fb)lR."6^b)RXRXs0>yh,5;"<"=">"?"""""""""!"!"""5@d "C"AD2 I I I I I    H   H(BCDRCDbCDr#'G$DGdGć䇈$DdĈ䈈$DIx0 48 <@DH)Hx$TD$UD$VD$WD$XD$YD$Z\W$\B ]D$^B _D$`D$aD$bD$cD$dD$eJ+ Zf4i`SGap'wכ<>uBb8y`I)C`w936;z q57,࠰G-@'dzywjbn\b]'}5bCǯoT-#^-R\#6ڒ=fkhm9/NXoĶ]X6Ji6"R$Y^VBºY)aVZ.ggjV cV*,)VkPJֲұ|_ysIJ?*w P">dujD~huVSj}D-hlzT9cR)ﶬ>JtVZˬ\ +J=#)> ZaZNT?5$9RQFZq=+CXÚQ[ eSW]J2SVUF YcϔZvEULe\xJJ7T)UPy+MQ~ߚh+&{)nlݷ2̚d2uV+NʴWvGo'hkśq -TQW,1YW&E_+$,4<Di!R0SD4UD4WD4YB0[D4] 拈&f挈&M3hѴѼif =!>`: T@3@ >- @3@>M Rkr&Ral"u} B4B3P ! @)>MR^H}!hg[F!(gRzH}!(hg#RH}Z"g' H}"w TE3@Y>m E3@a@cB tF3P@k> F3P@s>Ց tG3P@{> G3P ! "R!g]I}W]"I}^TI3%@>+ܮH>]BFIu*%vEJ%snWVR^I}%hgZRґrI}#܅KG &TtLL32"R3@Ϥ>E 4M3P5E4@פ>e M "} N38@9 NN3;@>͓ TO3=@> /&$M oߣ_@_A 7]JN<ۿ:36;:Nw?zo9o_s[yϿ8uaJ3Gr6  z )8S]vOKԅ;z~SqJTnROw{kvA.þkۺj]kk'v[Ǘzuw5_ 6̚nFomM^ Xn`Yz3y7 Ԟ9iӲ'U鞴m{rvwe6uOI枺YtpO[p]H(q=5{Q]J%8D_U}[I~%8D_Y}kI%8D_]}{I%&x^cBd}In&h}I|Mo(#6$="f="nc{D^'w#;l$ד |/ WJ [)rߊjNѷOWh5A;q#踔Q7RBB ߒyO<;+k>t0r6s宸[*p$Wq̢q=z7Xylx,~,e)}kgwr+qOU~lΤ]+FJ-ȕvUlV-VYqڙfw~5v57k-ڐZȵרS];T/WH+~.7Z%7>.5ltRon6xXla,AS6 9(%x@SÂ~6-)o 8-_Of}-R[nBɕ|l?UC̎O1;w9"))"cY^)rrARgw?dDMYjxesC{~kWDwZM_#1Gȱ5sݍ9GKvIٶ\,))Qߚq3C7%>dė1̈́D#f/Lil$1G/c"6Ƥǚ:4.<>+T7񑛛2 SSUL4#yE|B5.&!onxv.ǓnosO[{Dyo~8uf.H5sX{}{H{agF"8/riK~BOnk)^5"r"w!"6{eg6XA?risב6 |G,pktG,p ! kG\a6l&k1k5r7myUX?{,qf6I<7U%6&&ōaq?_rpbm;y9wkl].pPwq=Ezy o yl)k}S:-}𬫌g얃r+3[]wz]~s;uW?U12]ErC]TOՒ Tk\Gv~4;䩱Ys}OgM)-Uf#녕r5S_˿knIOCgYxLoih)f9y`30q+(eG讐>uPfshW_m9xŅ"r˷ZJnmxl}KnW[Rv%g{Omvy1ES=;2;+"9"Wd \]O=fԔu0{qjj=;ǯ':}'&6cq*#wNk`\l r YD\g 3,q_f'!bp$3=Iia&<^5~ho<&mkYMNRg_Dž'g)JR{zܻx?c?;{ |?, Kח腖[}4cwgWoVyw.{xD,,م ?e-ڌ9N.7 \oTkȱp-m-u^]Gt^]kt_:"~}^eȫ wou&u?nk1alUsq,HoΫo=/1wSu>-v~AŊ [9|Nx)I MWg kn(u'ƪ6FT7 茶ںxqm1KZuN/ oͲW>c{|,0[;?*9~3~p{O#[{Fk{wɌP}8GvƄ]HXg)V|Z8hͱl{ROhլmgWE#I6aꗃki_kmh-o^>_S`v7ǎ ~}jϛGZ.;3Ӗ?$/~2S vIf#ٿ몝+hNΟ/dF mlln,(c O .<;ȸjѸRZ1i#{Uzꥂ=O-eJ42 Z-OV>!OwJOL*+F ZT+7&T\ZPpUڙ*Z#Ui5v|\VkvUJ+'ԾZBݑoB3>oׯIotw0kdg'&CՀE:kj`bRB BzTC[ aA}'c9B-XBëk/hm>n[ڮd~cjKjfӵΝzxUcGd<-DiGnOz*=Ԩ)jA5jm~TҢ~F_(ńnVc)Ўݍ+eGYOك)ܳ^{p El%j7s:4`6,q_fFM85BK&%RV7FB5?R?XSFPgDž~'O^nT@H9N9/SӲkP'm[M޻hv_fWuJm&j~ڴʪ^Q$yb?|ˆozf!^+Mč;B_ x"/^18 iBr%'!e5NB5&"r'"'"r("(M.SBTDUBVDWZ8yΥuwi^Z,biXbZ,NEb iXgBhZ,xbiXlZ,xbiXpZ,x.biXtZx7~'$xҡ! / >"D#O @D>"DCя /AD> "D/c AD>"D?ѺѺ(Irr[E %]c$ <$ $˰ߢ!I]<$YZ!R I!IedxxH_!*I.dIxHҴyHrCO<$C6I <$cdC6I <$Y!jI6CCUU0I@?IC+i(% E*Ex(r1]7ЗP6Enx(~FClܠPdg"x(rC5Pd"<y!ak<ْ/P]&MCi(|5Ek<8]HHC<Dd"k<KWcPEy(>"m\Pd"'k<)<9P*Ekx(]c\C4ܬPdM<x(} 4 1E>ePEkP Ey(rCU\P@"gh<FERy(CTlBwPd$}<٘1HWGh(2؄"g5(<>*<9CuEPy(d{8"i<YV4DXGg+luy }ޱ_8KY^z헲fZ/ګ%Y3zkunkݳ] SՍMM*U^muV\VT?n9v@Z'{랍_~bkm{s}z˳l#ysT{W4!f֞)[ZZ{{)qdP}V)OU[?t}f}w$t),V|>h=hyQ=I>͚~%k(Y(J=tr4Edw_kj7+N>72o?~:g}z{&3(?$W2Y$v &Zk+:k?ʺuo \D.(E_bnK)\w*>UUK˔پ Z'Q-eUn僶pY v];" Y#ڕZ*7,eWPZ]p)_Sߪ5vWj{_x" v*u\k }Ӿ~lF).o_arVm3&J$0Yz7U[E LLƟS#"ޟ*mJs2vxCV_ZnuxziVj;۫[8r%WOt9O85>I[^[ "E)-)A0 &"@rٝ/))8ETu%j,J|(!,JkH6@FZKyZY gŵ>s(6$Y\Zn\`qO/k}*\rOk}*\S{V Sp1lTk}lg=]#GS4L'Z!6Z\3EZ V֧µ>.{YKDvyYbg"vE6<-yaEUy,yf,<3Je'^a'JenEf*< yP֧ŵ>6k$Z-ɰk}6\듡pk}6)\QZ Wgµ>Tpk}&Z\õY胸'ZV֧W*S_BDEj .Ǹ}!1Deѧ!_CD߆ }"9Du!CD߇} "AD'"_DD߈}$"ID/g"DD߉}(!QDOѧ"_EDߊr|g)_r@w"ED~}11B~}3"gDшW#FD~}#n:Nmut?Jsekqj="?z, "E ]=X\*W]K~OJ\JTKSQ:25yDS:_[ߛ Q~CpwB_?A3Ÿ_y#_zb`uס KUCBy殿qPlA(siť ]тъzDs?Cө#t9?Z=d\gⰓ;MUy#D=C{^O _e}O2Om>9;MwbXmJ- [{Gns-ou3O4/nuI3OByyRo{}@g<5 ` &\EkD"Z-[Bs^-yuht?yUyuh|2xuhd2xuhd2xuhd2 e~g 5ZJ5cwIs2rYA-m ;!&JT7I}h8Q/H'n$ 7|jI#'H~☴i19ζqa;ŔԞܒFZGOƘTe>i>crtEk2SS7wӞj{͝St Fgkyiz` Q7k"^Ya-ZDEFkguj I#@֠:`kKs <`s f99k- tZ j^#99k-# 99!k-DZYkY#2GdEXkIYk/Wd%ZbZKZK*k-!RYgZ/:k-k-uZKAȶYkNbu$Z,Z&ֲ`eZ:tk-Z:k-OHYkIkdnZb$ZN謵529k-$Z\Xky[dZ"k- ZYk`eZ6鬵k-cXs/Z#7`e4k.Xk!ֲ`eZ˓k-uZ&4Yko"ꬵ2Xk9Ú xZ>d k-߳^ M"k-Zk-EZ ZYkLYkYbҟ5Fbk-5XsZKZKZZKZKZ +z.Z^уrJbek.lXk`e k.XkWx4҅۲OFO1q73:OA?E@䝗@gN% ;& n^OބǿW/ȟKm"~p@;8:GϸZv9/ KWV~t~eE[t %&[YYIGq!Wpe Xnzg]L GW$V>W^OEئWb^5Ы횣W oƳϋ5ZSڃuGu[w5 뗮"7.GF}&˾қNWo.ǯ9((*/xN $:M >O,Nlq>MoFGX C6[[mg-];]L_]tqs_ŻG\8}L,C|b5/ۮG=cbر^{N4GwV4iǜ؊w@ʏ|A=OA2}Q7>ݫ{k=-&Y/IO'#~'희,Zb>z8qm/G^+)5οĴf48Y}Mq }oէ|Kr`(#d)G!;0=f懤!h7l\hmp? Z Rssx1Qµ>r<ƍ͟ FěL7o6"pZ&n:!xZ&n>!4-@@Cr9\4-GB@r48 4-GD E@cBr4h 4~wlzr s q,jlԝɬ'3H; doP^nh4YrIlodFL,iF|:Mrnzi_YhGz-v[\#/.LHai 1;Vjw ]ѝVCĖC#qZZhIBhMDlQDlUDlYDl]DlaDleDliDlmDlqDluDlyBh}D h<D #h< B;z { !3簨A=D E$j@O"Qz*O_NNN{ܐI#㮯C;-6 wsS hKv܌"Pו)Q:]m2؍*߉9UT{ y"j.DOC:$74Ǵq] O)E=B}w19?Ӑz%592p;;sIC"FNHL.B'/߮ݯx'v$M߉߉_wBnUyXj?tެ:tJ'w'wct7WoJپ캮,u;'Q7t&\d NNk!o=/>GT\1ޟ{mv>!AoX]-wU&s]l6@)·.J*"vWD;߉9n?z° c?:?nu](|qބAWX C;AB}w׉߉9noʈ qI*5wK?7{؉WNN~q?=8(2 r-H3yYlZ秾D `ٜ1v X?tZ>Nws\O0vXReC09@޹sb|.ئTO)3)G.;7Un@)*;;sy^BxUWE r=K63+\UN pߚfGj)ҞHf W>>fNz!ڷrկ8/b6r_vͦfyێVrs=Qk=frecm4!G;]}rsϞ;5Ueg3=O N2G׿gh yXҞZ*= ¥\OG9J>PckԊ\co+yD+S3K s|9\3Qg~ro_O#O<3kɓߩ)߷!5E_&O[ŕΐ?[-tт|@ .;'V]cb&ͼC'CK =OD D DDDDDDDDDD D"B$D&D(D*D,D.D0D2D4D6D8D:5;q)1Z`hg%5"i޺`ku""R J,\D^D`BbDdBfM?kjDlDnDpDrDtk',tVz`h#^,f@4YYY10 " "2 ! "2 " "2 " "2 " "2""2""2""2""2!"2!"2""2""29[`-Dd.Dd/Dd0Dd1Dd2Dd3Dd4rjl62""2""2""2"nD>mM妁Mfr!xdNaHh_4*yT\Arhp g[%;͋_EݛOy@q%… *RXnKD$/yizU@U:I^*qk]Rrz:-x_*Eį_p/QP;}5U po }4k?:aBjҍK;׬C܈ . jd<]yi4osHk.c!kYҡ5oɟV=b~r,Ϟ`OK?{ekٽo0ϭ6[\FkNĨeR~IrR{Y*ߒh_y,c6d4l)55~Ar`(#d)G!;0As>6?$ &FfF7m{Fg=#9 $G_bnG^~wMZ"΋MB,4<4   &W@3t͉MJ*Yyrnwl^Bhb\L+cs#b#b#b#b#b@n@]I%d]IE bWA]B!mih>|++s֒ccεu.o{Z~:(E+Į}N3WLYcg(kc>4gPօm\N6Tz&s{)]W>:vڼ-vizvol)lR;vSO";&Wv6+vfB*V[o|_|Hf{:[3qsffT$۔CO<|$;[Y2?be.x:Z/z,!NWG=^=N9cb=y.G&d~G95w-1]k+hE`PҐ0yL1$DQɑWM9nm^ګi}h+(WjA){};ڄVf̚ 3|k~56t~_49҄K/JHC >x@)MG-6_Oߠ'>cCg ah@mx +b/ %Vc5AV( 6Z"= >  , Y0,()S' D@+KSX@/ DȄ,i* hB X`&' r*`,> z*৲Tv3"P}F*AHA19 !# gD),@ʪiF CDS1 9"F( HE#9"F0rDdр t@2ABBFD ! %@AT a -%KL#3!#4m7HM#796Fp`{ y(D!knc&z =.@#+bAJ=+8 gQ Lߧ/s2?*Vv??hE?8>5pAʃ]*-'Gl}/}Z7o{`ds]EklYݜYnEdL_+v`<.8t#׹wux1kǜ/\ vi_ns:l!'l9UВ]B>' oh.e -qI esZ[yxv@\j .7:@WVTM_Oui9_6~bbRƫ=gznT^yYPxP䟖H',Y1Pm$3'co7:uPD/4GF M-! -xSÜ;p{{}Б4>>ْ,ܱtRY~|/8=Ird-6o>jmdn[iͮ ŕ-h_ H Z˶I7IE&/)߾u4%yY[/֦>OOvhWI#z_al9љ 7!8́:tA{> Bp@  dyB" B&@A7xa$HJH+兑 %(fr!/LbB&5fH!;@Hu7H jVHW, d .xB!wL^$}@ !@!,!1y$d L2B. d!8 @'H(2R ․!@H+ !Lj[B&@.!^  Bg¤9IBq@gh drM$&d |!@8R!ƙKuH׽؏cQ.+W0 B٬K /JJM˘:ȑQO9UzrRj#&NS$_:ISsqv oӊ'֝Pmj-}>h g9+Jb~+{x6jٰz\H{2 NkQ1L1xR ws@$U {OxS{RTЂ˼,4[Fd.B(HؔdL̺*t8_qTiSӱ5]Y0 _ۥ*^]:t=<-B*n_VNrG=/9 (x8cIk/bkPI BC#YCK>6agWYWwi_׭5/\jfr-nd|ysBkCbC\ѭVX_z<쬫 fս*s|9 V51N Skq+.2mbNwΚy+6O*J-|G߿.BBrnh]X!$dJޙ)! T,X YgfAK{YwfL4Y@&pYwfAN3 vBaE'@<3#yfF̌)33bPA<3# !# yeFBFʌ48@<3#yfF"̌H33Bgf"̈E<3#yfF2̌hlp+32gf$$̈=s*><@ʫVVE_E?Ҟ:=+ae ZWST6v+AFpY%$:_4,oKJXj۷ [7iXoƀE5aM+-|P<Zdb{6$j: -5)7I~{uD~t%<}x@W_{//vϲV]+ʳh|)QœUI嫺>Fzإ#!ɔ%#!1 ٯ𑐞|>GgGDإ^ԫ6>G9-|$#! M@*ͱEX>󑮫y5^G¢'E5 ,fJq܀wyǀ~߭.=!uBURxÊ('FR~]X܎Rv8J;' To=:RLG3kϬ fsi?B W?7)559 $*?զhx D*_OtrkS9&~՟shV_t^{MNoPx%D2;2)53ݞ"BGYvߵK??_'I+S7NuoSo_d%gKՐ)tq{~W\{ihL=AZt29AW-fo<ڈHQ4F紕m-ؔҸA7q#OoAx@ }'xoܯv[)_oq6eZyfMqh}^4-f<}Jo)?JNJq'w8#%q~y>KҬ)f/;>6?h6/ZF̡v{HgsZ&KsOxVgdzTosHl}ș]ѻ^44Oc62 ?1J&=3ؼ6GOi[Kosl7WoD))9aib.eIE/ʓMo]%OI|4udhPaFWXwDka*fQ xUm}cQ9=' +[E q6BUN߽o//y@DD@D#!HdQIC,2o":{"y D*uXꖳn9\%8=?Kp {/:^M",ʩ{"y D?~Yy_gh֋>D ,B@DD%@D D5@DM'eCIYtRE;.t^@DM#eQE",€2 E ,%"},%""BPE_^_{5Viw8OBEfz#z0%wLÑl/_lGjT-뿂_+59ˑbI /_IZCp#ҞjOlH_ߑ&Ղ_u10ӤaG׊[ΐO.rf{Hm_q oɲ8d+Zszf;n m8]fE߂1l%ӭ wHA1LA'BSWk󂀂n0emWR>,m0 *ގYHPQ}{6Cu&g6{zgRgmlB^,xݳV^l=mugsfugl!+{u!{ֺ=bu)qف@\~ n[q[5xkP2@4M'*Rdk~I/4LjWk#R'v?e2=y[[]m ~y[\{Vd+VꖰL۩[΀d:?&=hQjF Ecq'HJR_OnN{:wtyFR{Y:mAփ=^0]:_5\dw2_ߵSʝf~(7/XlegM#VKt 򟵶ЖqFke)WmJX&ԥnyNXSSzڛr SrfygvD]3z% k7:;Cϛyw0}ޔ =tg4RqQ^Kʣuh1UB*:*VQUa`lq@Q1VYǘHkiMc$_7B/Po\u ^\u ^ y;{M}19=trW+Y|vQcpG|Ɋegd/NՀ|j7_ huՀf0W>KqjC.p6ՀE&Q3_ Bqaj)&0Wv0vjm&p'}\tg  a7?!<[BvS(n !9a7$ʺEv(n!ima7- Ě)ISs}/48S_VovjC{_>`{ PNT9"l JCN[#iD^iV[SJOW6/ؒ],HBa%7-zowL{w›n9ֶAw;vJ|w)xӺ'ln1wי olvw~OawnI~e/*^хE {nUv ty-(y;8};tG6_wXިˆ}=[ܷ~V^8`5qִʠslG/R"٢zߡ ؆y80zW;yHa̦)' GXhm뷹'N^O[NI\➺Z>nx2=y-L%)-H%ٯ-^632軶Y+))q[axí.gNwzڒ ܙgfP#emRr|fr>䖌]{r^yeۼ)*W]WN~G8UFqP{c i4QT W~Fg2HG*|$>P `@hl@A<  !D@RAL A )D@`%L^#2Gc0RAl@21cd'd@!f"PA qB  @"!F@0!N@5$LP!VL-B&\@!d@!l@!t@!< D GBCj !@#@!@%bIX $,|xn|!@) !L~:=^ _$OK̼>b x%,Tf?NR5ҍy!gu_mnܯTC3[u#z_}Mr;>˝Ȧtrqr~Cn~rf>_HP/=y=_(O\O}w櫺9=OȡcWʖÂs+vϹlk%>` }_:>hayІzdb{9ۗІ]_c!|]~ yij'u=oȣN*G3ؔ$}\x72Z(=>_ެ'x{>[6O%OvoX2mK?;="'VE='[q>]wlggm3G}_=qrtuE3>&9#99$gֳrN·ܯ?纞=7>/w>ouvhP +5Ycw^=W>B:_8B- _r,Ѳ0&GB- gBlYXeM79ZhYeN;9ZhYؓeO?9ZFrh2:e dh=2e4!G˨Bхv2hmHuBh]I:qGÑъ;^fgЌ; qGۗ֗㎶!w3HNQZe$d$'(JhJQ-+9ZFYrhu2e&GhLQ-3I#4&'˨MMNQќ-:9ZFwrh2ꓣe'G$-rL 29 G$-rLrL"L!h\eA9Z&Ԓ1 G$-rLJ29!G$-rLZdBNI !rLjܐeC9Z&=heD9Z&E?qb2 f]םiEeoXpp%㿡Aoӊ'*w[?_ޓumlJA~P'7ƈ&Fli;V}xv=Lsx-H/w=_ {6ywا~~}3᳝۶/L8aE[.=̽6"#hy8KaG}~yCǺ{ԙ{|_ݺxǹ׷;qSKO8=/Τ-HfjoGOOnaPr˴%f%вr³% p޲, UczwtWZSy#Ү3nÓ{)+{$߫g]y=7/]=R뵩YJy}ܿ480%$SiS,~a+R)h*8Ϲ[?,XT5ִ-2x̼#DMrf^it8zRMKP<Ⱪy#IgQAGU>^س&ۿQ^d?Z>{ڌ^eiM#@>o?Ay8bO{N4"URW P^+=!\@!d@!l@2B쪎!~ g"H+~& "!EZτ#_ٟWW' |>A0]_#}~&|e^TB& +!W^|e>Cl߇'W/H+! |e4!|/w8a"Wn¿e!_߂>pXq!@8B^7]).)|E~)wq~>R>"ϻ+.bG|]y|Eb><>G w10ϻh]thϻdzT)|<>m w1ϻyJ)wqS1w1>.ymRAybdޅhٯB.&}8_=5qj\VZtI/$Dj3W]F{Z e$7s6ZO7iɿ_iѮ^Si/b+H9Ŕ-,W?lt}meO~=2~eo^EO={n]S:^”F>JPr~V 1BW,~=Jgs#>wѓFsø~V,-T润=Z8_9J'ܒ۔kUOɛޝQ7%FZR<ڠi+/ zRM?ѹdJ?GuRхff^ ⎴v07ww=mg5mm+msBmP.VXn#3(rwmmpSwnRnIp7wۋU*wa w#3hvY w= gP}nOmn{Z7w_mkn U~^n{ mvvnjp=v }m^rmU۞rEn;>mV>pJn{;w݌E2 SE2.Y w+UcsT{s7dVM3y. wL&ޭp.h_]n _ts6^.M\pi&/Ep7dUprQ.:>C?y? VM~C?sXE2]8AY{M_/_],,&_Z1S?3i=꿚CÂ/.q%NJ_x~m@m~ǿv߲}raTXeH6RM݌tjɓkQcR:gP93{ !;# Ίgq꟩{'F_??>'P%CDlT_77ھ)^4EEPKEٔk+멽f@枝O-o:4jS8fsj՜$"혓{Pf=51]B GMvKbh8?kZ_B'Np]{7__9\q je'7S7NuoSo_d|w $ZPB98=C[Ya4bM}(/_U\ubMyRMj6#o;±glTo>ʉD| )w-[7/2h6,}G*.J:ʾ/ wb;ZhcR)[,p '_8WȨ_ppxY2{=#3⤄ /_5#Rrj\f_q^Kg% /==)59rC 뿯 'O}5PZhL}271<׎ĄO}'}yCq̯tt8׎(1:zX*~nq❷j}UeCzwj@96FփMjy3+ /cUo?%FBw o2&mp_|id~׳_x4lã(/ؼ2yzߌ^yL ç i& <(Uvx_XH~!=&ICw,DBJ;'*wF _0wF LBvD;#H 3wFrk|g"_L*^T@P.! d&뵖.hGȨ!P5w:񧪻+z̤iYYƒ.a2}]]g!q#7w$Uܨ6QF&N׹kO?RRF:2s_pbg WIœ!ﯩUԷ=Mw_1U=ؼ\mf:z$ͶuLجoq{ԸR-ޒё>1ٸmag[mL^65$>h %M;8W^ָKZc;wIw%qW s]1 wI-T!TX?R 'Emϭ_]Z?\n\&M1Owخ 9kĀڅwF(o]7B//?ӓRS22/;~Oz']iWW{$#u`zJBs?7.ts~y̏:~gNՂǘQA D@Ϯ"UXWg<<'<O/O&8Rӯ:/[#AfU[c%iS2c_ًg? )ښ\^Q7dB?bxT7/@.g?wr-!Bp"i@6! o B0#y $U'ŵAnRy7yk '8~]պW~oHE/_8ge;f/ d'KHbaœw\C͔A`e|u͖CrJݽߒz_A+]/zCqՉBDsJIjl ǁ("q ځx 'd`L @0V Cp%@0ck`!c $ D@( XE͘`!c D`#VL`'R@C:OKNxZrӒy<=ӒS$\"Ui'ub%h<-yZҤ dӒg%xZ2@i#<-AC xZOKyZrӒ/<-ɛfOK.xZy%OKyZrӒ:OKj<-@$<-WiSOKNei>2OK`P)y%_xZӒ+%<OKyZrӒ<-:%4GiɾOK&<-GU*گ7IF '̱d92k]o*(W&u|r}[7:{c6}oojtW6>aTiwKm⻣XJ>R;{N1eKF˕.]gntly6|S_ _[xѓj[צ0ylUBcб_O#,x܈hq@c}gqgk6~EsXZ\3mM{^p2x 52^(K YϪ^+{4ҿy ]w еB WonK.!?G!*F O#hPe7lH: 6Ȧ7 HFn *@z8rr d C2Lr d2'717n {@nU䥇A[BF]n cpr-9 䥇Aon yaМHR:8/OO?nmgXAfKd ɓO ?kfVTs0 '7(=9)5ӑZ)_"j=V?44<bks\. K+wK9zrY~|CYZo򸯙\/[v?g1^zAMbHg#3 Խ˜-l[>I~dYW7f7:M'N7yę o3tmcjWϢZnwznNߝ7:|#Wus;/x%c-݆ٯǿM~e\^3p8zn}gu^R2/9`gH_̡Z;-~C7"ܷzo쿦~l1 Ycw Zs\8z?usșCզ]oc5lz~~bAN  I *d%d%;N@` H  3 )An Ɂ :d@A~B&L AB B$ B4B&@! 1BPd3aB\AdP' b!:@2B#  QB'  N* B.B&^@!1 !l@!t@2B !L D DaBH DB,L DB<PB&@)!S * !ԧ`" !@. !@0!a 1LDaBh DBlQG#M_Ç$ X}Οs#R3]CX1$, /_NGe92))I*k x`sppbr\dV7zݵZ $^ü㞷QWK5oY7۪M&Ϭ0EJSjOn^ز{ VKr '>^u ըk5jIֲxQb:L%._󿾄L9j:\TRS&S*%5]vCN|?T'Txʓ|T')<̭Pk>u [2Z>s%F%̍7: 0c"hgߎpmR6ڪNhS}w:q@~ӺUSvK&֩]Ɵb.5f.7{\ïl5/ڤ8>a-`45pZMQjy5jPrX N`ů/{1Cԙ=JquOYǴ5uR{Żδ<,f&#<4x桧ħ r ~w)eW)3ܡ<*[53ܡ<2x!K㙇 yxH♇Lgx!pg%y0x!B♇vydrAb߽ȿsMn/wKk+^Vh!F`1L0{Ty KF.GE%$dKI.';cJإbgq@\jڏ]nڏ]rBvفq h0 8w nĭq0p" ` ĭq mVq;5pK12uSYwx%BkT!WokÎ5T`k54ۍA70o_f[N'#:lQqڐNz5`X^n*-ח~\ݎ 8?_5οՅ:%(ߋ'; wR}gS@| A -_h2j]ow:W̏o9??ʵ`E1xպuۓ$j-ZSl>x`76L1WnEdL_kɻggn:WZz=f󅫓3ry.M ޲i$kK}mBXw .XJfsGlgsFx6ggs³8³9' x6'̳9].&洶l|?ܡ]\kp5o^vw~:omQFg/D%F<(3YeAur r.a1DK@1D\[o,1 X"ހ9 ⎐^n@"DL@& D@*]w,f[BtYnq D,@<8@671D@;1D" !|8 #8 |382C8W@p ~1`mD^?ۉ3S5C!!a_gH>t{xȝJ~0%"s^`m%/3h!3б%oO !G^ܧOw~R?>\>p|wHp6xKL[>$j6e} -dӠ7CyCmDxy]gHsʶJc}lviܠ'7< M>7h Uq}mӯʷ8Jd/V3M>%' h%͸Aѓ;O8[rYy%iwviSzQK]]Jsۗr\-{rIZVٽs9-orɹ'Is_#qG)Y~^EGx??M>^a񿜘|q/cc1cc%" "h.>jMByQRncF2w%wd6imm|*qq"BF|t6hmt6ָxHncF :XDsUn#>#m'tr9"zr,m'@@.A.1c r%6Sm0e!XCn1c rE6e hE(rUY@c 2ri6Hm0֑`̣X]Hncwi`"ܥ2z>'I.1c) Trsƒȣ%`XxPxI̽,-!r/)51mnt_phhpOIԚ8M1OBf;RjK%Ab6OK+*}*@{TںG?S߿Lu++㇖õR#A\z>5Wu [2Z>$?iZ)ݐo舗ZO0c"6}7|mJU۝:8uxZuR sn쒺 } |Uu-h BءCCHl( 8ҠŸJ).A4 hH(T\FGe$= ('Rտt3!zz5~i/l+$`/dӑ_\]Lq9`KmnXzmHEKbL_➵a,6pRC*^«M~V\iŅ-ѹuо6hR 8,g"h>K}vT hhn@PA= J DTd$:AIF%GADM E)T8@Y h8@a hT8@i hfAs ݁<8 d9I`$YBI dB.xLl𭎤CҗIj8̏@8&ib$y $di*_˟\GlLo5>#_slYc7νj+QeΆ!kB,C7ECp{kDȾu\ɃFIvtm~ckq{'9'JmWyj h &-35kU*/_(][Wwky"'.g_e4})Ec 18]֊*~fpRoYuT"oAÕR >Jv ࣪D+K<, >L36ihemVӒhegQ%G5VxU)ZY|The䟇*, >U4ȢQ.F'Y49*X4sThmEkI6hm,Dk.Zi.Zwh뢵J]64Ek&Z)|&F<0B6F9!ZhmsD6hmʢ,5&ZEkCDkc.Z+5xE\M6Ek#EEhmikW-*7_PߗigꆿZ so9V5#wΕGG|ǘhZVJtu(Q'Pޯx㵍{^)Az seTTdNe(?F*A ʐJwdr$ْ͖[0ůT=?ⅸ 3zϽ?ۨv~`Cx;=t,S:i\]bL Fآ{c"au׼oR}oܴ[5{sJuxlY +P&) &$&$mV{=0SͶ!Ô/Բ (}e޳2"ͿWG=iK.PIۖw1yswl]q_陰xwb♔:;y}GF/f:WnK %6뭤wޖSR>9LbmƪVތzf[^d\3+MovOQQ@T# DUQT@T(#U) DQ@T-r^V6`a#?*YPFQF{6RsT;Hxa#w+Fz|N6a#ڄ,PL 9N62b#@#166X6666X6666Xş?1%zcw9X&zcODo.>Do,#zbk'xDOlW"<'F=a6XM&('&zbbg0U$>cEO'֊,zb>FEOl-բ'6#zbzEOl"'6&zb('6&zbKm=14@P s(5 2w$}mN1LgWeeNͭ[/&<DʦʭW/(P|進gwslh}ޚWsyx_x5mNxwd獓;K?UBwOƿl{*2>~}ƅ>#qZugyse)z|YR3IO+_$6`??q8F_ݦ|Mcʉ只.\|Tæ?6X=oڃN4J qfG}oYQ=1կ~KxmTw7jMeR[ڬֱR,1[ w73V%[<úv s{:ƶ6NjnW潩IJf~gf'NTZ*Q[zCfJQ2M9۽1;y˞WC!%NGB'v)#t}®3)WOu:"ۛtԈg3NDܛ[qq_l;ݭt;cў,5hYwԖQM/60!iFwý{ HoIc BR8QB#e؄>rmy)#[TWG$VSPRcZyǼ1~︇K ?fL,䝔̘U<ڗLT.UQRimcJήaU[ʌU]?̯gdn3Ίmdg-4~6Û[K͏[lV LW S]?[QWpXu~UY0p/kԬ^*/#^C|<G@~o0OsM_JE I<w=+?I )$Ib41<!Q$S@Hrd![@Hqd$e@H1[>U{N!oy!{@H ^!$&9~6I"4!@H$2 T!@H& t!@H(2 !$@* !@,R !@. !@0R,ֻ骊n9diBhq=>gArͅD0m )o~pA d)gJr diBށx dB|H~ [ n@%0m[ n@&U [Ciw("H! ^` M;-4ҶAʣ"H{r BAڣ"H;*"H!"HAB5A҆@nk"HD+y"MTEHAZUi?("Hk #>mPi/@n"H{@jt[AZ("Hf + M m!4Wi"H m*>Ҧ"Hk#5rFVuUEvXjtA[Һ"H+zҶyE&[?q+Asf@n"H[*WܢE&[_qA+n"H롊 [b51?33?iisot]x %s_z6rWgS_06?ߑuolq5_g}x7лGc?Q_ӱqow7*zjs?+Z]Tjy_w|o/{O/}qq[j2"nG-[ŽU+}0ngnxo;KdžKzg~hѲ*O|4B1/z5Uuu ϑ -\r\C@ng`Y0Z7R 7[LS nS_B:!zwGn0Oy>Ih=HIn'v7qU7is?l1;mo&)=kF(ǕͿ%^%mר/O/񽶀},/g%GQOhO>򻑟lQ^~+?I9Cfی>"+CE&؈\Xz{|̭xN_v=itk3{NnZvfS:l{QȰW%M7sP{N=kGG|s%Xs;FJj͂=+pgc8ɎF&&F|FwDAq_|V}._덞;{mu{}M1lY:.^v]w&WK l$/)97X;c˜?C g8V6aSYUC39" udQ;)O)ƴnyolFc{|KbLXobq1)uo:9} uJ*!jjP3-1LM;6Ι@Mxs{2?aoܴUs.ޘmV9_ctǭRK^s4)P r99N缏z ҝZ &%9I1^/M~ҋw^43a5+mwItx!QAż77^9żن7)͍5ļ1>1o!uys- 1oƠ# oD@P:/Fu>84g$Aw (큠>B 9B yB" B6  BF IBV a$BjIn dB~xN 񭖤9I4!O@H2T1\!Y@|!a@R$ YBڀ7 $;!c$B? $B C $YBGD2L!cL7cN  BFR IBVV BfZF[ $de$Ba G+$@H2 4!@H42 T3 BK_!݌łp d)B΁t d'?48o?6{جW_GޟM7Mp:үQkV%E8|ꎓI;K}Nn_aw^˞F5*/>&*,l6"XXߜ"b7J 353P33?^1O0MoiU3~ 6Uu*p+w{۩ݣYJdeHoiZAR}O poQZ}#7z6[zS穯Ǟ>omAz[?b]`K snkx@i4vqnvM!Ҥ|O:f&{undmm?o[zzךMnmJsSI)T [ )9w::ws~usv]G59"'BLMHNc"~boZ4(w+^VcROkg:ɖuDE߰wkyZw5R7䤠RG&HxMA6!} aЕU==-|rx mƪ9I?JXٹ4+rʹÞroK4ѵ+_}.xP_-H_&NVݯF_{ժ_1MS0:G=/rZ/wav5oAPPh<:F{.ܛXaC]K8x^@LGQY;0+q3_A@rAl@+b|c)yELM["g1X1X,1Xl1Ev)TEADL1ϡ" @8 Uข RW|,wj!⊯$WE\OI: "(. $WuWܥb.LM"P4Whqm|qE,4WP"FR#W|P%W|P'Wls+I"8EM"Xi]4WE\Fq+J"xDqI"(D\.q+E\SqXG'$>2H@ E\1@qE9<+9QoH"8.I^YK$WE\&tWܡBE\b.$M|eqE CaE\?J+Q|市TW+ $RY9Xi". ]q~]+5W"WqŃ+R4W,E\ajWe }R?'7YB9^esaj>X*ꉴԢ=Eg"[Nt^*q&}'Mhld=P/ZK2[}M'E}rx+[/ZOx]f[ZnkRk6Kmn7)kCW4^~;Nh=,n^"= :^7T5\ʖ  H Eݻ1ݻ2E]B.^t1y/]T%.,˳}l<ۇ.4#]ltl<ۇ.>[%*чV>Ja4 [%`aD#}HlQbkB[CckB[,, =#ۙ93?3&gdêїLlDE6oy\YavTtD±} vw?ߥ½], tXN̳~5r3;[ʊY7X4-)T}Z}V3W {SwM崫/c<5W]c;p߫ z[6X?Yko4Xv9iTkIXob)IW:fՂ];niWݵ-_3Gܭ7tI-mmrUnm7]ч>m kp'%;$ RӑdK]8]pw< - O_lȹx5jIWtkLǮXNָ?Z v+gzֿ[z/?nŖu~twɮYC -{&M$m^fxf#Lp )6aKYusx^yqlڕ<gi?WJt3p+˘Vن qj_7a񛖉s}RL^?ye_29%aԠ;]iiǦ҃[;wt9sƪ$K徙-R,ofEczėx%w_n1W~]Mt?srs{\>,\_Ź`h5aZ5׫\O|n<Kwj{=5k$}/E.EmY}@}<ŀ `x6 }M,by BPB E"#)#H *ɸM=B9q@=PPPQ 5BQPU ue$BeIiP[FR\ T)00Jj "*8Ό@4#)5jH j@7 [9?a?OfWM}.{8Cvu [0%yo7hDE{݋4BKܳF|Iш87ծ ur /nMe}.8?)Xc,q "N ubB|P) O9K}%\bj&bIՄQ~R7 O*'<>W4`rn\aKDlD_V#/|m­)wE1jљ;}>?2opxaEω~;澮ē+I5ڹ>ʱܜ%/v p+$#Fu'ܕ|;%z+pVӯg[:1r:y r^}הgSԠ{i\ic.Sӿ8ᚱj5[y7k&9VX#}К;l9Rw~ܳ& _u9~{Gc\ nw/Z0)ͽpM Exwy_[ 6ߟ0=Hy}NWT2Q>@eD)J9TNbŜ;}"].1]t]D+\TTpQ2RrE%,OtYAWontI.t sB"\^T"./*{t}&/*t 4ActkE]YE%!%.t=A%{"$/BEEAW}xDu%@)tuˁ%t`TAAVLӠEu"wKӠD0 j+MTtS42voSs33UK£+?sf3fc꿩_L%F|XbX^}C{GY*=1L8h4qRsƸ2MM6W>h4;4;qZm~bWהVxRo6Pڎn/x)\ )Yv:\s^65ubn=Lo IggڳS|}QfZo_QN=s͋Ëx h W퉞廃\Z[,2Ce WobD.]v} ڼ37ʴLGA717+^7oYٹP%ۑ95DL+_UWA Ȝui[5;q\i~h.ͶV?׮sds ەcw]ك϶+Q@* D>w{(Xc1uN# iGȑ1ȰW%SM?krߩiU_ fsʽ6zNwQ[-Eg&xPJܶ||F哦glɳ( WJ֝@9!۩S7mZO˷PZ|i J𼀺{  kxKVV"Uxj`nGW\ ^.X` 1EB1qрp@\< .  2E^2e_t9i I ]lNZsB]$->vUAi㿫83/%-cZV4_<:x_1}Eg[NTrq˶ֶ}'[l%l} |_3Cm^oOSK6_o?`kUpXoHt!@ 6lrn 3*<ȸ_Qm_Qh (Mn(e1ڣK!Fyx(/]v61;*QF(/#Fye(.FyŴAtbgx(.FylbW]Qa]{(.Fy47ˌ1\Tob93?// W|'G^04_[1{ٵ?W+/_<&)@ x1&>;b~^ͳ? lm5|M:g3t̵OiϹ 11*kW|x/oY7`7XfyI?3پ1Nsm=l{zfz^|½·$w3ٛvfWO[Sz;=OtKwyl#/I< Ÿ%|kK+xe{"#1R01 #$ ;9aW'A3<<&hH #/ bq|G`@ A6  @"AFF"$d$bAN  I *DVN5ji9$rIT  2df$BAj  8$@HfGBxE"!@0!$@BX!@x! |'BH Qa$aB\I` Bp B! 1BD018!P?斓0#9G8@~k f{5_GTghqr2g::gg\{u{\t_'UoJ_WZks} ZnkH4kg[3M!,M:>miVٷM\:[:jgg>qSʯoihv_~wZ . )t$׹>W=Sgnw-pw-,qͿ[/ڰӮ^[^^;csxα9v9;cWsẖ9v1ؽ;crXʱS9v)؝;cWrHȱ9v!};cq8Ʊ8v];cWq(ı8v=;cp±S8v ;cWp8v;co<p9`̶EIGhgw?J;z]Be}|IG ΑE2eZDv^tae> :h#6]؁؁؁؁؁9R4cFTcEtr켈vjtm#QѐQёQђQѓQєQѕQі΋HfF4fFTfFtfF!,њQo7Dov`w\w>فy/XVs;0v`$ H؁<#[,;0 v`$H2yl"C>IBy0nv`$)HV؁#yaFdI ;0v`$9| a$B~I؉ 1-X$%  B+ $ B/F0 d 9c$IBր67c!u8 w@H)${@H#I F$%CbW"<!@$RɎ'f7?ϜȜ{1{ZߧO?2V:PX.YW"o5>3aOϪ*>e{qm34ee'=jns{y<~|B{&@4Z ^3fی@7@9à@;3mI{ 4[DC @q?}{)S^q=(Dxːn]ûƄEDuU.7?V?6ʑTo~ڃ{V ~KxN-PS1[s:UJҗ!T?sUz U 7xN%S׀7/%Ţ[]ۺ_rg^6nw ~qA|ߗ~g"{3^~FA:0ҵ`B׃ǼtMxKRW7߼Ɋ=/#+؟c-%8|9 nS_~3-rBR#AzZroJ]r-Jkr1Z#kM娓I1Rk9iZu$/:\!(m]wk}<)?cZb;z4 =nՇyÒVJip6bj<\K"''+LSqڰ wʪVIzrEK>YOTK9<@Ӫ\<4@y|҄ŏHRK$uQݾ!mJ{; ]OKLҎӃÿx*Ee6cU$%gRVJ\~\TJ9KaJ7qi% ZA~}ɕ> $r-tD<(q  #@rrDJe$ATF"+@A^   2dМ9a%bsJ愕*U":'DvNVDzF">'D~NZI8i%कVNZI8i%QकVNZI 8i%कV F NXI4KĂ)NZI@8i%ᤕ$&MDVx= 0pJB# +# HZsHZ?sHZ9I$$%ֵ|⤕ĊV-F.NXII8i%㤕V3NZI8i%Q㤕V7NZ{ n9NZ[ n;bDV?F@NZI9i}DLprҺXLp(rҚ*&A9i%䤕DVJNZI,9i  7'N1 "1夕VUGrJIk5FLprXLp2rJH +0# 1'$Ɯ~ }b0z#Ke_Ǭ Up7շ {,Ƕ_MݾYOYj؛^W_lA-xI_KI?^K]+O {(.fϟф{\ 눮qDĵq:q^@\3 5:2 ƼM?sg?KNKϛHg8U_Qc޵-xxO6)mzW'e{vY{bEFqsKbx -@{71^zטoeeYKl|/Z\O?xx7dӶ>s.{nQB׏Wn-(cJdb#j{JtpK#&BWbkq}qV7ޞ lo寫}%{mY}R S:R&G+ o$&)4"I'5z`:eHDu a}?({QG}lQ]M\zXM~@I9giUgزf/)NX1xwR2czWj_2QTGI %QҎ VӃ+;ZSVuo)3Vu12;3i7kp.;+z̛9#w on.5?n_Y-h2])(Osr2wluG]cEVe*U㣽^?qNb_nDQC@D=QS'}RòQm,Skg5C-c}X < ݩ5pIw۲ب>[|7`4t$d4N -и)Iicf; p6?tLm먳k﫭yz3oYtvԧv77Gk?pѡN9FpΐQFH#NGbK]$ήc԰=Mt_D)52155:/&X5؈a}FMǝ˽>g}/T ?ծƇ; m%N6ŗHڜx1e!3C_h0ĩ:EgjrwΔ'Ԕ}cZm7Ƽy7l1=%1&,~78Ø7yPCӾd:%tsj55LntNu<9U}0fencd*9?o̊6|YƯr1r:V%9 9]sG=E X^I슽˟L-o,EG-Z߹{h'/E쩍 d >=6 *OZ", (ފhD1 hC=OXPA= !T@PZAM E)TDY h u/9':sOHh 7gKI4g$$3Z텵\2Y2FrSX&>a-OZ&DֲOXb>Tk$ZVlN!zCXNa-]^S a-u kP^vUX|$r$9ZGXv˜ZTa-g8l k9!KZ9BֲSXbT k$YZnKXˍ{|Zy}Z5|) UXUNa-Z8 $OXb k$ZU!e { a-?!Z ~B&|'a1I2\%,f+SXKWȨSa-_!Z&9'aEgǵ*%4'!3' +SM7˯YYY׊GG[1Y7Sׯfe\3s"bϜ_%s>qc97soUtGf?:2o97+9rӦeeU /Uc+ʬjo꿩_t8ү?92so꿩Q?>#/מ[eQ?_%Ȝy1Ϳ \euoTV4J.'Y~KI gh5zMZ}oS߆uhu)+zRAޖW,[>(5X^a"%7;Uj4E[tSHܤ]kZܬZYFfӛ^kfZgk7|I6ڦ4MJ9~?Jz#Nsz=wi7]7gja n{-<]#r"䨑T9&-9EC)ˎro=(;轶n @TU/2v}5T08( "0""7offi:NfFeJf:fn5f fw%syg~3;Cs{y5zSw?uJ{hIK'0 -S^S{m_X;s {伶G{շE Gl1~csү~ߦJk'W;Q?pʠc!f13_ i?[n ]conߑjO(–N3lUGV}cj))Yծ(=WSsjӂvҎ]״OȞcSۧdM} [ ww.U)nfq Y<=X~[ W.b^=I6K&]^!)37=7O,)th,Y@A"A#fAId "8,@A)@ DЂ\ "A1@ DPl "A9:; D )9I(L B B3B"H@ȄvP@HX@`@HhL6 B: B> BB DBF왐@H @ LR DEd!,"q%#&8"@ȤB| B $B dB B B $ BD&K$2i'@AHHi߁PAHXA`AHh9MhNM_Wܱ_^n|"D[5oK2E:5nL'w8>~A{>̍07L2zI|)anʇ|Xoj|x[V[F Ṗ5boK|x{Bەnކbobo2bo-*ʇ|x;]*׈C>"!ok%ޖ Fzh|x*F4owj|x@[ƇST>o7|x;Y2v̇&oi|x;Pۙ|x^nޖP֛^|x[I*޶će>D >].ogI|xFQfi|x;S&|x;Wn*ަi|xm?o+|xۆ^7|xWۊ<52v9okoH|x{\yn*vʇ4>MSvƇT>}R6*i|xM`kFb' bW\Z!.[pTvsH{{{~F78 (=rO3/;4r_=<2V:~1ytbKoe'o||^:-Ae /l-X#T`VO*[>Ce ol-XCT`+X">Ee ֯l-XcT`Qق7}D@?}D?cƬ/1cAI" & t7*+보YwA_}RX&>M֯oSo}D?2 T)݃bUbUbSvy?P5;c[ ?fdˣ?eٿ[xyt>' gmnyK4!onGx\#+>[jņb R ?(KK{ޭ_oP;e+,U|\iz&hciEԪDtUkVƥZ͓Z{mZku}"}{\ob`>1En8pܨ{ܸmpIfr5fBfkh^k7ZZ.=y=MI])hAeߔ5_e^dcWt949\-hJo }F ~~A]4azkcRZHlS3ZhUsZXrpO_]O.w[}-go/z&%ɑ>=iWbEwziMU,OyڟymAk˃])c| m'pPhCcm˟iSVMT4M(VKZГkx - 1 ;D֭AtmDAtuDAt}D"@  BD"dhw !5B;/%C('!",@0j Dȁ;"@ 0 DHKIR2(0%P- W! "lA. D(g!Mda "A780'P BD؃}B 4B tB B B 4Ad  nL! 4B% tB) B- BY)fL5 tCd V "ȃ=Q\glZF<9ŷEĥ' Kq/h?_Q b1#cz$ƹ*46+A Gsaw_CGLIMty*aqIq.[b>)o!! ]Q/6-4u?#?ZSEs"\{}\i  Vo4 V7}}o?W\W/.rn,["yI=Lyі1XL>+"V߅xk??̲6uo%ؠ/`waXHHd1Nl/ "/h}X7__7 7 f_E+EH;oH"/hZ"e!k=㝐|D_ 0/E:oD;!D_ 2rb"?#k@N`!E_E-_ِ@NB>"/hXSD/4{+ x'@!E_AE-D/wB _E+ߺ1o[[?㝐[_E+]/Q\IREYZ<_G[`o1"/ZAB]%__E:?kcYX7(,`D_ 0/w"_#k?wB_D_ 0/H|^E '/*m?=;!/f_E+ +뿊t܁N,E_ .F1,QN87[E_ 0F1,7WD;!{"/Z]( x'`oQ_E+_9Y>"/h wW_|׼-_E+_!_P ?_5;!{`E_ 0w"oQy ?([,+"VpC?UC}'bXE_.+XU___4W?%..i|°E h.h~xkqO{]]?roo bOE_$/Ή g'%ťI,20.q\7  ŦMKtg~28S q0;ڋϫaj.ߐ-T^5iҮOJYo.vO"yz7ή~XN?@Q'٨?L:$&>K:_:a;ұ5;K7gҤ}H߬ "}zztS:Syz;ٳ%g~gx/ʹ?U>ffsug;ꍟU{Hh"Gcȇ(&RȦ.8~}:^_77AV-gey/sf$/eSWw5]=gL)m\df SݽofI} {R{rLeh]b*a/r+~PTT|CS}UAf4j3UctRfe^th|m{U? fMiJF({|kzQIOٙ.Q<Cu1kN0ۯ:)2LكJm:mNydk̶OoWڭ13xJuw)K{ev{NUVB/Ya~,tf _t-Cw)bsG=GvA(8 bDY삈_1 "A2x Dlo1"A:x' bDppp3/p1}'   "sp p p p πp r"s@x@@x @ @x @ (0op Èc \g k o s \w Gd>" !'"yA8'A–3Axv1jp(p)p*p+p,Umأ1eDVV>-#sv_էWW'/bzV7~~FQ-kYs˨>ߙ>t=!͜f[@;?{MO/緣>>UCT~%왟G|WWw[gz3_4I׿n&k5In%JJO8ZGi+fwIճ6d|Mpyp7Jd*oȾ]0o7 S}Tecy ?íoAzJ>/YS[>j(!I!uĿ6K:Z[ %>>#oeE}h˞{/>8[J1c]w^D/_"9-#AuIҰPT{}77ӏ72_=z`wГ"/\6xk}_Qy#c#'?%{y&n=)lhO_E)Z"( V?..1.Um_ߟ[ UðlP~˼C@MC;=`oq"/ڃ1#\FEf5?}zMo/%.o iqc]w=(af_N_84Ng{XtvDw<5i q7 3E@_q) omA2yi,uTp>sv%n%(?)?wt+IC 9Okm:hLk;v.֑;59\;ڪ5>.pZwTroݷo"{VgRڣ}z%iQZt0wZ^Z_riY{l9fwmb,ǵ[ ׽Ӵ/i#h _LFFxLK(1   eQ!2Հ )v(Xz@@hh,X4uxG-#Z[)>~-# =w LO+(<+{G>/| } ^]CM[<%틲cg;ެ|-D5_z;I2n,^nan[EY*yv8B  D@ "8@ ( D,h(Vb(4у69qW_} !t\J%Χc\𘱩b//_;xŦKI-L߶wfte=Sڮ xQyxugiڮq~򮷧KYHY>v&~vIiό'Z_0}u̴.Ӂ5<ȇLGW2|9Od:y"%6󛡽3OmS/2Se^d`"3ȼxQy'"SX"2/*&"sr ,PQe^Td,PQe^T ËG4Ë6"2/*#"""2/*Dd$^TI2'-7X,k\  FdY D&@d4Y Df@d8YD@d<YD@d@Y2!l"#Ȋ8iY 'NZO$vA\ і`C[/_P|tk'w[O̭VRFqU_cA[rh sWEo_[ћOXmCpl߻.kǢݎd7J1E3uŶYLwȃm;~9p'͇<g>:c'Gu:L`,=sYy^ÙY1\ܬ ?L˪8rʳ:&JBkGuqTUf:tݮF־Ήuw3f,y=R?'GgD6%Y:t}2if㲚]{u%sRZ`ns̭άiM9ÿHcz_{d`GPYAO8Z_YfF#vd~At)y1{>e3zGYa{';+e7Bn '1yڪ=7Gkm{;U+} #rs^tcN_~pY!LY713Eŷ002Bws|3 OE&#G9j^KG⮓Y*:VmJtXf/cHI5GjQYvӂi3E7O:*r)rS${TҽHrr6.n9ܗvdJ2v;F;cN{z8%̬ٙ*K,*K,e1IT1aIT!a1+$rf*Js"UHG40GRy* ̕Ti`d$2oRIP"(UK|JT40R* ̯Ti`J,Uk|K\40RK`"0UTi`NJ2Ui* Ti`Js5UMm40wN<.' SaW* SyTi` s_{~q/]DmhehUdNj1OHLRLʄ8x??CsW_uM_%"@sw<sQÞEg[:FV>Rp ohT+;߼cic:2 Y:KGYF7y*}Lm~L_,qCĥƹ$߭Eo;vBra,?tyg˓N*y( d{S>?=s+"^?rO*_Qߧs mq.o3 _ByO}^KX~o99Wce7~=𜧈_w9o׌uRQE\Q-K6j񟫆W 4HzCA No]cDLK* 5(aӺ''OIꊿN___?BJa\p"D>J8c$u}…WW>.$ن U(m7H}uSP{iseҖ~[^PS^l~i1Ҷ:ۏ+x1Dڱegݹsu׸&Ү9zqf-[]Fl_Tϫ{ \W֧ʁ_W0^9zkOڏI;Hcfhd |kO7*g?S'P9[S9{r{CWVϯ&#͵%պ?GUsdZyQ7O&3 ׻y*h ̊|O>&|^|Q%fJ>Pz c?Ϩ|)|q%fO>DX\+?}%> YUN?RT>ל̺| Y~ ?G|ϗ5l$?%> YE"Q| *'6sd<¿؜;;T>E9Lg(#?:3K| 3K~?Ws?>;I;3?av>geֶ? ӓe>y^U;>iWK>\ljv>v>g9e% АА@d) D{E8h/K⠽kڋ~i''>&01IzCA,N- ?ǥn @_qȽ}C֣r9y㻹_f}j$]n/ ;/ !]b\<;$ 04!vdLk_?&)1n.? 8+{G }NiHۍ=d~li)eK-9n/1m=vzm7ٷcR5S/~VRwzOwVx`dIomgoصш^foRzgeIs(|Y+-,JQ3}4i4_ubL#+!Z]큇.Y݃Ⱥn. n> n+N nEd] D".j .Ѯz i_ݐR+ #. [Y= * ˂ . Ƥv֕Atg]D& {YN9uuDAtEQ- 2ݱuL@P8b____4Wð8}G)C\7 bNq=SFw< 6bИEiߗbDƌKLo\Q?m`^G$Ōm zW1 K/>Q߲Ͷ$˒WvY=1_qy#?q^ZF]g5Nw5sIUKH鸥jYKeߙp>e.a)5GxK;*S~y8C8$9o޺W9gF^Z %ʙkas₹z2ww4̍zl#YBH F "(A&'%  DZ "xA0  D@j "A8 D DЃ|B $B dB B BD&  2YiyN6PBd"! cB!b!!!2ـ  @ h' $BTD&+"2iyQb#2ɁLz B~ B DB B B  B DId!L"&q!-"2yAnh$ѡAvhA~ Hȷ+DB B H߮$I%daAh's%^"EL T4H b!W!Yզ+oҁN1(8[e?#Jh%$ƹ&:uw?o.\nۖDYw,ai5S99n1YKVh+Z2JIkZV:m-rN*L+EWi:yu?RjѺמUꩫ~ k͆5X"9c;ާ'nm҇:}ֆ>k'{t]tMK 5ZkkΫ|׶Xksu-ﶶ3tOjN3jcMikkbUj+Yթ :r]u۬:k쬮Gu3ԵeÓZ;> S!3K҅5˙Wtu2YѺ"^1Ӥ9ޠ >j F|ъ[_G.asoߵ:`2NJ7h&`Zݐ:~tCL ^9`8:D7k֑z[G[ߚu5IhM|c?Gԍm}BG7F]Z5tӥ5]7ݤs_a2':x봔~"W:9a[)I1!vcRws2*8!w l@>dAkkuXy `@c4@{"Zy 4' <^kz""y `:^ج5gtBk9Y@ON0.Dp5+t@e+n5u0k~t|EDZN0 &x `!^H'B 0k1V^hk5+Է@"kePOk5$k۬pBkguQk_x `V^xNk{px o[y oWHvx oWHvx 5V^5]!-^5KV^k|BfNx oWȍvx oWȎvx `"t+$k|B+k|B?<߮$|c5:^5]!O^5]!S^5t$x `vdy oWVr+y}I_7Iz<$t˒nKG*uJw6~ ~!b/b/kSI*6C{>pl;MXñ:OGJE_G% 钐XT7ZQ^G&?^}Mxߋ{': 1qC ϫ|0 \(ŅyPAf`=("=8P{I~IoK?$M_?vK˒+^OX87,h$ KIqMs?P'뿅ǥ$Ĺ*V5z`f7ԅR WuR1⏚6sp_}L'ztuKZ]YQf֓J_%qt j͓׌75MK Ǯ^+y^8z}5_jcbD;TVK~xrPth@tg-of|Cs_\^kƧ5ン55k˼+k݋҉7jOAv«XHm%} "򞱀装$X$@ LH&X,bi "x,â ՙ!x=:>{PףBuףsaAm P=>Tfxf!G3Qe6 ՙx=:Buf'^νPYףCŅ^{:C^lй3:tn{:C^lBu^^u11N1) a}o+"3/+"A"FX0H['LI DV "hA. D Sb "A56 Dv"A>!!2!R!r 2AQa-&!!2!>  `@Hh@p@Hx@$g_i"`oOa/ %$ƍIrMeg`=tVCz?6urg=6vEMCU wY|chID_?)C$sI/?tu'_bġR [ 0gAQbzǹ<&,1_呷qK ˽\s\)FUC< U\!eo!˵\,+߱<;] \4QDYqwF@@F+ͬ뭩쟕ՔfֵR6̦Y_e{)53y ↅcqsgH^.+ t-KgkSەkW*lWTՀRcwY f^V3ֲ h|ݗ8S;?Ɨ_ZV&Bղ%|e5j@8ϴ|e5/T-q;_~jY &0e5sZV#?e5IJe5J^IC"(RofBEH_\Rwi迁 @Mũ /5_oO{Qytmj}ܰ3M״xs%WrZj긳Ɏ0gǀYΎp9瑗)զv_L=92hsVB nͅvͅIͅ\8n3ՋjCcC'I8;3%N1 uqncBv@9!{ O'AȞO=?Wt /-򜜢B[Q?߆β$ /_KϨ3)g /_(r]_\ o+k+ʷՏ17 /KCYMN/_sJciB (xA~Q>noz~+7MSS0獒95eo MzVpBݑF}">-T+:\k:a9&5[juGɓ_S ]On.ªG+lWZ=Kh[A_Oγ֛13xUPqs{mj" Ave5'iJX J$x.mditOO5tm+ˑϢzi?]fb~ڽ,g/w?_w{w"\]g:eFzuZ/ :ƲlajM9x{3fsrn5Er~t5uΑ mZ^<7jZd\lj_J,^.yZ6Ml['y:ՅXz\]@2ABF AAI !# !d8@3A$  !##d$hl@2A@ H #EN~] eUt|1Bk2C!cl"nE/_.//./˯/?[|u&1ǟq 502h ֱ(!;r<-m5n;WBfN%ؔtcjTw=v J y"A3'8qJㇺ^MD$s=IΙK7YG{'\ {gў3._p$_Q$_n˶fيlbg8c\[JQ o+>L_/$ /9ך~K%smWyI}pړ'UJzM7*5zeKuJ˜3dq+XW|缽"9}A:n<ҙ:l7nor]eECN&Q n⦁t(y<P (a@x(p!xX|;S^!'Oi?XDO΋"?'6jmp߈r?#dd~¸`bWB7PUWTZV\t?BCEo|[};EE)uX~bC?*h #au,1أJ-LjS \j.WY两h}w_ӊKKl9ggf]&Xɟ߷˴-ַsߙ= Ok[i h9օI|Qo8ky4ٟmǷM$."7Z`T;إ3M?mm0'n??HZ}}^B OaS^R\67?XßPiڑ6~,+r*gΐΞ4^O*z__tm2_ [ɼR?2n?O7Y)|:k:%.ΫZè\$}DS> h ."~ۢ:Ŕ`;6&BE7m+/):XkdӭL7~7#+[weU)K6,ş)54̍7.ܾi";Z;\Ouxaж__S_8c $k^N#oWt3cԔ6gxe7` lg<:|]LD /Ņzs\uqz(<ǝҤyMaYrg̅7VyWU&V]02ʜ٭ߧ>6_y.^h{W\7"{U=&UY2TYYM_) ;rK*?5rc+Kۗd/j}EI4nrFt'; @06 XA"coxУj25>bV=kOo,?O:_=[N7ޞ=e-?* G,gZ1l\R`@ +3L>1ػgS/I(€8j bEر b€?rH_qx1O\/k&Awvu,ǮPQ׺:A7J8]nUYV귎sڳQ-6_Ep_e/FcZ{4lh([gyus5 1Ej'i'`.O ZC?5C9+&'$%_E9/+כ|joߟ߷˵X~ upN,9/tːkj6<Տ7hJ>Bo v/ /fYh#8B o_R63$t֢z3;]oE(X3(5:ʟkme ,n'?c.NXSK/ /JX[IqYqQlc\IYE5w,R{Y[NҶ=()˿e}X73lL^IOg5Gn=_9'wg7}ssڞjXd߭H03 ?9_0NH Tn;qy+V}_I8yv2_}1! [ּr[I~N}Y1^_{W~=o=-x{agfn<J=\:dJRMJ5RG {%E')4=4~ҤGJ)M<4ˏK-tIf4Z'=+YJ=RI.O!#uV>K+R?t&Ex97Rrcvr_6{7Rnˤ#_zΔ"<"E!c[륾>Dm[,{>%z4)(eInn>E1d8sd謘/%OHJ>Q2`e}>\IyiÊ%>i 24)91eXF%:exHQ){_,|w4r)-i͸u4Ҙ}%}r<\kWYz+u ڦJfJoG*>گL~Yeʳ'?myUҌ5Bnlf(܀YJ㔼)9R muSb>4o_Iߗ"w)o4]҂nW4OZ,icT޻\YvS*YYQrՓBxa7D'M@1/՟ 2n<1l<5 k*_3kFҐ aV@af@F-^09 3=k"xLfHMj-:񰛙#!3IPf4'!3Q a(0W, E Q`(0gBf(0k6 ̛S(#3'da@=@ rI@,@P L"P @H @l!V3BB2BJ(brIBVP -@ ! dR!9@҃BP C@H}&G@H d iB(/^!W(,jq}/BI2C!g@HFvĤ y#:3#d2!w@H@P (AH! H#xDL!L.L dB>P!@)YE@^Q 0E2E@vQ (_H02 !ǔQ3I~z]>F/#kE/E/(-.'?k\G"_yS9A~7g[xuhBEk,nXH.7h-AŁn뺏>dᠮgyY]=޿qٽﻛ]Q]5諮u+vVVNƢRa-A,iSa:s'-ޮHZY^ *5u_jJnnЖ#9yerŐ]C[+Gv),)?+R[ ԍ~ebݨ'YҞ*`xn*ט WXuRGب-㦕Toeb纉|뚔rYϤ1 F |? f/'v<Roy͂h=L6ԉ;xBȸ_g ܡNdN#P]_c@ 7 8@.G 8 / 7'@pY x w)cä@p43@p~q xNȸ߁<@ >a'V lta;@6aK@6]a[DBf_@!3 l/`oMo.^E/De,ՏuxéNg^>ւ[3+*W}毿]_򲼙œz?BOϞO:1xtRM꼋\xGT;gL /ʟǗ ߥR$Hq$gk‘|B3<%Gj4?׌ zN3r^ͨO7j~PYGk5ST]bu9q驎 G;2qdsLj7\36?Lq1i֚۾Xfy۲?ɚϑ6MΠC;r#/ou(q]sp`TG 4s rm)Ⱟ6i])^S)K9)o-iǶs̯D/=EX\Yd3v,{NE+_@%( &4t·Vx5[;< ۺ#dDQXEQ@T(!T *U. D%Q@T6DQ@T>DDF !) !#$@A Hq D@ 2A( H $h@ ‘n0A<  !D@b2rAPBFR Y ,@lFhb1.I~ 21]f\_\?쿎ljҵ) t띀Gէi;;B^pi~=Xmuh6BECsuOfvy[UxFw?_Q<_8Vq,;Qmc9¾:p|gN[s]&:tK[:[z WzDq W] >a oym9KԶ,6mD[gYu%lEkOe(2*sō2Edz'\ - ;Y5@KAO$]}2w,!+W_!>Fk+XFn8YPjn$yᡌɳ$oYAr |J,BVa@TDQ@T" DeQ@T* DQ@T2 DeQᄬҁx *B?F  /@sc$(@# !d<@@"A&  `$d%H4ї"_ ;;V &?Xݯ2s,R75G݇!sԦ6rw-ozYS顷刻;tBrjՖ|$wmsr=w=\^rd{ݽ?esrWfQk;T5fvwlY7>U=\6 -nM=rU>YYy7$yL~lʔM/Qaƫ)CbjjjaȦ1W~UG}rƺcޒǔ>>:.nymꄶWʙS3OܩNjPtp:)]6u;uVg,μc,OoږDȳ{5s|,Rr~Gjs>}N-zT6^U+syԒjiU-K-42F^ؼ]'.rX^?˶7UW^[U: W^Au{xNZ'>A}RR<ԙhcPAaBFc  4@Asʘ)cbtQ2&F{ʘ)cbeLi0ʘ9PL2%f)1 dA3zL(SbB3ʔP̆2%f:$|(Sb&Da3#ʔ)Q̉2%fR!1´yQL2%ff)1SLeJ(SbfG3=ʔQL3C Ls$0KJiaD0SBf@+& a@/& a3f@4fML&d&a@;&a@? !@,! @! dIrd!Řt!@H2!'@H BޒI _x=Bf!7@H!?@He-jm/܅XCg)/5zZ"ٲ9cԙk "Dz 7u ]6>ttEc7¾rX:vN[/#6˝e粶]Խr{D! _+jL ޢFM}h}e>o-Q)TMWmFƬҩe]U]vU?=I6treSDlͿ:S>xAu-wQ=}tfuW5ꐕwCSYt\p}f5zݽ֘U7[cnu+eUCɵqC["JT!C5&ϑԁb&y39iu{y?ȖcU-U^Au 'qX-Ew#r"'3*|Q{U}Ԍש)ZguJ:Wph0`uLQ:gf:Q.Mk;逪agr.̮:+f0x}o0AK WYyPXnA̓%n^At7 <(̑Ӭ<(AaM<(ZyPiAaM<(D("E;Ԗ]_?1wj7y(cKY.kɖnvkЋֈ ej9j0U:-AGQѯ37WȐr _ )cJgRw+^(V>xFiϔ5(w,S! %z][I" o*%~vn,zZlՉPl!0>FH6*,Dc7_(ОU ! Y?C)E5QϪe*Q6⧪YUK!>^z>)eL=j YuShWT;I:XSh(@рB{A3JPHhAe d(B= *3Ph(C= :3Ph(Drh*N@P ZZ(o*u O >+ 3jǙD/F 7';u;!0.*o:? 8os/b(# qsg{\Q?߾R?nͭ"os>W- Zru8`uw+|Mj+:TY{~]7.j %4.㠇k$S 0G2'%VS2IR7_ zڨ bN*J򋒜BJJix3JjץI#FZ-R}*/FoYS$Kֵ*c '*g(+[~YM7  m9^,^?O^sO'Ŀ=~u隽ʷv:>C{_xӓIǛĘQMO?%&j6aXEjĘEMJ]˨i1ۨi)7uy}22Rc!5-FjZb%JjZb̤%NjZb %%f,%TjZbl%XjZbJb̥%^B`1lFQj vpv OJX`uTWqIq"E(UQnAqMbK/ȷ9{xi$͠N56p*6ezws'E _ ռ"[yj~/%w~۾cmba5폽}ÁfR}S;*:m\aTE+,W-:eEVVg=_|DyT>k,}ڭq]ԶM~nE[Y@[}1]3%9-װXRwv_J=|kdbWF}:͕p+}"K)i?2r^z6ntWpc*CFTcWШbޟO< ~{[ U15{\X%eWX˛$Q2P#oӁ /7MM*x ׯ7ET𦿖 51P# o{7=O2Q#512&:8! Cd@W䥦BF`Tx7p•Tś vyS4o*rETBɏM~E* ?Q䗔9kg%O1~oNqUMܛ{FGpoǬ_ZhfO_-[߽6O=|[둊3䐨FAgK[%hwgwܢvYܵ+Uoڶ_+E0aՐq.u"-&"X[˱4cmi/Ҙ_1\rM9 'g}s=z=/e#("ZD&OR5 KZ !d2+’5aQ@Xuaa@X3Kڀ8 #oA $dV%a@X$V eaJ){OkY,%}j)cKI^JSǬ>fɔ1kY4%{̪)cMȬ*Y8!ry]EBީ;xW$T'yd$ϳ Syw.]EhwU{W.]E/%I'ny͓Gj#xF,,c=+♄f /D9Ofu{( o"Ԛî559]QęEhߧRK1tqf1E_v>tueca_=maN[9"68:T8N-SGo9zD3|Woj">m6kUmߦEus41jb5A<$a47a64vOt$$|Pf7Rx͠_$]f[55CVu MEcX䵎!5݋#':F}jp=ߑo&p̟kk 9^2{Ȯ YDrI@AR#Aң?UY@y&kLd{Cށ{ Ꟑq '@p g ?@p.'B) xx v19w@pA xHȸ '%@pU gIo.c@p>2NkBm MQ;8<wp{O/"_r8VToMb?ƞ76cu_nGW{xikW{Ć` {%ڂ]h>AGk^a ޢF>o][wOߦjʘU:5,RFOO2be{\tk(>mw)t Z(IV8R,6ǐÔÒqa=z:R"#VNhw33fisgvOobpC ݏ4kh|E Sr"p^w7]<yDFeQ*{exh2{yEÿ{eqƝM}I+-?*wٷhVhJ?L`rtrOR~2/'͕Z/_>b҉ﯔrW*A#[V۾UBnl7cݯMCcoes[4XiY0Ճ&:k()|K]̮M],uCe2{]= *={{DD#aIv֨Ǣ~gHUc..]">ϔd5mLDYM6woW|͚Y;^'|wA럱&yZR0X2=4DMtuXf9 f5o5qf#_Uu5m{{9C֌u`Sv@^z]ǏJ9ӰƝy4Kf{SvԩoĸݙNL㞱:h}]pr^Zqhj_9=otZ5]cU'Y[Xn.lɺ]߭L^j]?˶^>]yźݗƾw?l|!՘` gFE3âeqѲhxfdl<34Z.ax@a@#!3H & a@*"q0Z.K0F !SLkdДe0&dM23n?9 c0z>ƏBP @ Q@0!( DB, B&@Aa!$@ LPrLX hL` BpB&<@!D@(!L@) EX!X@E?%\_e!f@!n@"G: Ďn,_2B e!@!(!@# H!@% h!@'J_BJABTV7C`Y Bp] &@0!a ]=QBg .ԧ.HoZECl~l?/c<sB/_6h/̯ssSŋK9;n[}fڶ_Qk 9fزd]vU?aՐq8ȡEM%ٰPc>BΑpЦ|cdg:=3zcCV H #%fxKiRfQnԤ=&}߳jFo1Hc]qc s SڏvdE^So͔GSnl[͌?jfۯg-1k]n z1;t#7VGމGE9; Lu0O3w Gq.jf5Κc֒f~l;O4 [XޣYt5K?XznDzt,_ɱ:oX{}?c폛z(=K }}wi]nX)$ju*oT(o6FҜ%y4uߖ|kJ߽?HG*W.|?L,X~tZ wZF/'Sca>~YXCKp7kf~v*w9"ӿF,XEͪQn3Rk[{L=VĸkjoW+z&Gwm=k>nܺ/an8ulT6Q&'4fM8LDvh:gN:Fnˊuȴ+ա3Po?A}yL$PPĂ, JhP΄j&P3%LH(fbB 5JPB̈́j&.P3 %Lh|j%Lt(fS#fD 3<QB7%<02qĚ xL(fBE5+J{DEȄ Ě !1JQČl&h`3Q %L(fG 69 4QĎl&x`:!@J!`{3A"%L)fH iwyL()#gI w9NJxRb(BJĔm*%oUșRDm&h3D{) ѥD{ D;߆S݉߆Sm&ʔh3aD3%{m4%ڛm5%L)fM6nJxS#&`3!'dbN 6tB&h3aD;%L)f"O6zJS_jЊ_3=K/V/Fj4؏M&}qtRfa7njso L|}HDDk~5v-pznzuI+]-%9)aW ĕqwoI񗪢 /ɬz;G1_BAEoY%~8T7&]NK4VշwfU~+@_$|t'X{$k3y'rI$(zE.Z߰E/L˟__/z/VfRdtvR]/5b^TGͦԥ'AJzPPRt) /m(wfUPo%"?x~v=\bStb'7J\oZ5;IMuLR:mؠU:4P8N=tK} J8zoQz5)MCK}ڬZ)jMMR9URlYF+9 iq(G\tb0h 깊۞v&nzbк ΤUwT .[d/2^v6"9nsX!)3m )V2bgW(5Wij zup^MBB$/B{E ?hQ%FVu3J/ua G3w\5 ߿Ih![A f(O}Pw?P1u,=j?_yv72M|!&j5lJOԱē}CB%mmC1wRADQDDD0 #NFZLJ E0k6sX05w*uY6k)&c%VnkyF@mĖs<ν:sy9y9;l#ݶtd3ݷ)9[~ks">1 51:6v-@\xƮIEucP__`S+%.1ڳo>>ŷޯ?/c*F(I Id,~k hX7%Mؼ7i۩un/`MnA|D/깶9+6h4jHmJ[a)Xb 뿋o}5fI*xeKJK/_ywdIM-/gGRFeQ_?3VUj_?x(gBJnLztۦ5^1ޡӝ}P=0uk+:ϭ[N5*9[×Ye \{\'vuض25ntu j4u"YY5PgTS0>%Қp !ըg5lWM{߲&}Gu5y+Ԕ-OVjQͅc>aMϜf̴[F穙XPZZs:숷l3k^Γil;/K7J0jMH?6mYGf#C١bV.(j}b#kRwjOWV)^TЃ[݇վ iJ<x 9x d|x oD/ PL 2UC1AR4<&He1AtW9z8L5G҉.Q[w:w&e;kjkҎ6*µҘ[K+cǨr(=p=s=gG} q1R;Y rn㨹n]t_V. h-}xW 9{V0IqZCZ-GJ-ý$3"АQ BA A YMLFpl `(Ǧ&860̱) TH L ql dcS p<Ȅx& #&L FP@##+@A` H 922Ah^3RAl$d$H ;GFx HϑQ(xay DA/pR;!B /+Jm5h>'V6oN?:t_i[^V`?{Q xһM_}tO#{T8za՚>?[&g˒,p9(3*3:|sHΘ#r1U9vRs쮿ö$m\#_b[2(0)=x\9Ԟ?hG-|IO59<5|l'\!j$gd'9<ÝDpM9$$S'9<;$L*N$óF&%29<$óI9r~Ce*{Y[oǿ<\MO糉xGxxT!iϮۜ_wqu:=gWuWHGn{γnR{_ݦc=~ M>xtCwM'9c;uo0ם~"j|P]A:uź낲vIljCZbڥ~h YS L=+y?8"EIlpϱ~gfd5DD\J6A܏`y͑7_:9Ds?@p> xq~pd'@p/g ?@p% G- őq 5 @pENK ?(GS _,r"HÜ@p>i x 1mNo@#:߁<+an /"GW;$sD?ձ",\ ?]z1=擃J=fݴz+&;'x'͡e *+T"VT/ Yz@8#ePߔ:epܳJtx2$~%&p'3H'J v'ncgiR=#FzYp9ߓ1s26fOf ɊdI霠HVnP| r׫SW8bx̼j)^Z${9Rp3)~c\$B~$0|"@. 8/#@ 8oCđq ^- Ǹb<kb|sd{@C@#$@S _,o.8 2|8 92no 8<;2$~jGHmjVti"m\ Z3AО?j -?tl7¾saO .i7 9߷$M)_22t~ B~nD/wo]7eYNWFջWl?~6Z,IçG]陯3fr^eМ+𓮜ηrv+wLP< r@.^p ~~$-[-{L݃f,6S`Ef<u\=du=`A_ud3uN{L݃03u{pL݃=gQu^3S`=B3usQIun'd4uf~{A.\)=_s#/V`Њ%MȽbO }pl PRu"W]9Y8kPծ]㎸Uא]116musWb}4WswL@o4)cueYM5Y֓? XK?LC꿤<"]s\GHǹHEԿ")3fR,!dt"f/^oL7 #mbvlg |޻iMWޡH_׆< ٷ6gE~+ou_6=lwdY{aAy݃NOCB1Aa֘oY6_mO˰mqwXyihudCVyBvUWyOq JUCDjS)|մϨ&ȳz%TM3:i5e5uIkZQu̢P\u]?/_P`(e&V2?g|1 { Iɴ-cZ.^Y&jIR]KT{L$ۜIWI&>M=M=M}T{8Gd2SnR'UR8"9'~J}5!#}VR;_jwZIjJ}TT}*vJT%^j'd!>Jݨj VR W\ڏZI5+l̆xh_Qt(o).3RX^%&ʋJ+J]/Q_(*JWWg?5vLJ˥-?/X?VCc^w*;;u[q>yzZ2_2'哚OCzSr"?[-ǥcϱkp[2\S7Q{QhEE X?}h o?BgCvHrÎN-tfv/E6h sZRE+ξ_[o+p ض_Ӎ}1<_VR_& J[I˿E/Qwrۂu˿!Aڳ|rAjiV28| ;ii9=KFe,+Xed"<ڢ^U֧ڝ0i1mԥƹM,}CI'R-^Nit%N%]-i5sW1$9dѰ-vd>d!YMS -3wdN1N;43x#22x1q! " FA~q GF D T@ rA0 Hx% 'GEX **gWϫgk0O{WEm_R_?-dA]-:ubis4..-Zv;gO }\Y cI =b/lBo׷ѹm?z2" F3!rHޙZ4.ېhNXK.o.j'o}F9d(?O~7Crjq^oE/udmV߾  gUX~ʿ%Q#Jk3+fd//-mz;ֻ\ynWLwhOlwOC>a ۽շ!UVD_Yp1%2pGʠܿ)QugeHJLfO̱g) x5ψ.Ax6Wxmj'4zb[$~ŨQO+WVT1ԥ?3)R;ibeb[yQʩF--2D/Q /?"RQYxD~]?QW*/,([0gnyZыO%]R?VS]CF1jR'*<zFmݬ$v'e=i5 Y^IϜɘ\}'3CQdEMRߤtNPrv$+Vr7D(y :OŎ:_0C9.P܂®5Ɓp?ȏ6?RRK<#E.Gnt?#rF[I.GQ]䏼"Ʃ?C/OEr-%e%sf\0Gb߲Vv۽H|Wޡ;>| c6,vo}H~JPpd5,K8ͤʋUFUQOCB1Aa֘oYZw[(fL?GV3˳nrSnu&L4DLvuQN)nMN Gm=J(~:̜s9u sZMl.g6s̢~̃ aؙ ֩+ps`yFi.NC 8K|}O~;qJ %W2%HfS/Z%j Gdi]UwȤUYɵ*NҪbiՇTҪ UҪU*iBdjJZդV刬Ze?iՓ*iCA\gl3_翷)jd1exhuFJGF+ 4j@ A;zeM!{Bj|B /_+aq5h[?cQ7_л{zxUś5Ͳ(o(9_߫nh{P}eWŭwgr)~yFV$f˶WLZz]N;R]]g6*Y_3}줷5QYv1IOYV_zǼ9'Mi֏8.=mD}vc]gogg8єe}ǯ_){ɦ_[];~Ru_]0 tջ'K7M>= mטn~U?ui˞v/cg=_g6^WwI͞wiVk ?^Wx"+C5d'J^=]?u첇bsϭs]WqKMrC闙+ךT_꫖dW4˿߶'nl}}eO|kw.Gl3L$;a/&HL ^8=|Tnv@oKIR<0H^tmy232AH@rAP H{Yf= FZ`= F^`‰0ad= Fhް2R#6i0r#8a0sdD7Fv`= Fz`= F~`4X!= VxO`WP+@ DaQh(8@ Da@e D  DaQ(x@> Da@Q((c#+@R * DQxy; 0 Da@Q(@nްΑr :DQxK~h=_݇7]rǾǗ|q7?tս?ȏ/[6P~|'NwXn~C#=Ï?ȏ?+}?y?,?r~ OON*~S3\M#'ӟy$?Ͼx ?ܚ/?>(?~I?~ E?M9 __ =A~|ӡ ~|rWWB ?˓/?4zO0?3Mƾ=1cۮʏo;|zwT~~+^-?5_ˏ[w2wwg,翯;"~|W!~|7~Y?x?^w=?~| ?gYw~|!|_|L|4M4=GF EGQ?H?mlƘy%o z)R3VXvyʿ-Q?/.sKu{>o7{U X`΂&Xnoil÷47{m7r뒾N7LHib 6}_,NDO_+JT;ڲ3_aM4Q_bOQTeϋuB,,\7 )ӻXu`?64WLwOjMC~"mZ&g˒,p9(3*3:|sHΘ#r1U9vRs쮿ö$m\#_bQH?o]]^4b+e+/l4|6w_?;d_fbUF}^w?K>8Ѓ'=}eN^Svlf<(z&QTbl(!xu2K;FcmʊEԦU)1cHHp͌NsCA6e7wN9^_gIa=PvOv}Qx{mͭgl^R-sVd s\k\C;Y+* 򸝬_pY+yRyL"KTv,_Pi/UILP%Ke4Gҟ#e[&,ϹU[%,U[%*a<JU8 n0n 8‘[+-)5tZ`O鶪JK뵾ũ_bw+Jӟsmsf_:v?*~Ba}]VjeI'{_*n۪=lZ+z#0瘹 wgb]%i8dN,molkylds|B~D#[ZI|o1$? |EPaeS/.k*y_\O.),*^1xf_?:d_fU2bn '=OdiX0û=sSM7{zdZ{.p 9%zknݷAk ߚjv>Nvhoi<:;|S4khL} ,hL`DcGcJ jۍ$)7[fO[֧fO޽?e譬??kYy==s)/.arYj:\dnّc=wC=aj{sIZ}we@ީ ]w'ΡnL:9ͭd5Y=d Y@zzճJV&Gk%'NVobEFz|Cd(e'7DqE(nҐ3P$z|Ck/8R";TQPEF=zC92["3;Y=twAKzvKd|*ճU" '$zRU(KVR4F]z-(LVODVNVOtBFkzꉳ3;м{Gwt_.Ad+ 0VbW/.U/95%laoC5o}#bGe8"u J#:|cH341Ƕi6;42vӚa~xf5#MՌȳR4]eC2ޑ0)a0rOpkL{=]4t$R3zMʖw4פլט _ҌYXH|D194ndE;W;r:[9;89r7$9&j; rтp>\t> t32F?GVޥY֓JBJ?M! ?A#(B~]o:HovA moD/%dt"; {5hH֐!!!_ ?A?A8GPJ  w4א_!=Meb%Meb%A& rj !5D pU_cURj|0B &/w4_^TnpIquE/]ڪ +KoV$hiGƁ_ 3ƬMO{׵:Dmujw[Mq3Y8m{P^;jtwS!!cB,1NZ6_mO˰mY6,׼`_eĢ-#YYZ>I݆Yn.m<5m f1N:jJ7wHc,)/w.jIi Y$3ߵd=6ǑmqAZvg~ޝ^wΎߺKw^RKy;us$̈́5-<΂}Hݛst/)ϛB{n 'c蔙d "zM&cZ2C9Z&cMЭn2v17:&c谛O8Sd 1tJjB12޳1䲐1􂅌,d =l!chj Cn2p1k7Cd r1FȸI4Q2R>ʍ!Wn 1rcCd 5Z#xLл2>s1' Cd =h!ci7Cϻq!Γ1B|o2~e.!5ѕB yt!KlW?S7 .5\XM[z<CwI=obWև~+ wNV#˲ԁL꠼X5jt_u5::$fu聮Ja۾R6UyW_2bџUjgTNYG&aƚ5\x:fQ5=s5cG53c:.IkVF5jNG՜Pn5ќܦNXüL Q;TNlW24\t>9z JI-W+|.9Lq)Ynsd9Ε=uRb)TR URU*)Bd}JޤUI?? ͺ{HӬ[ )WRRH*ټ]*)R|JJ>1l+)yJJ>JJ>T%%?JJ`%%c%%JJ|+)yJJ+)*)'7_VI?JLJɤ&Eo㟃MJg7{Bj|P)B /ڞ,eYKk47B)9V9ve&T=v ?I$DI$DI$DI$DI$DI$DI$D#?d^]H././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/dateutil/zoneinfo/rebuild.py0000644000175100001710000000453000000000000021661 0ustar00runnerdockerimport logging import os import tempfile import shutil import json from subprocess import check_call, check_output from tarfile import TarFile from dateutil.zoneinfo import METADATA_FN, ZONEFILENAME def rebuild(filename, tag=None, format="gz", zonegroups=[], metadata=None): """Rebuild the internal timezone info in dateutil/zoneinfo/zoneinfo*tar* filename is the timezone tarball from ``ftp.iana.org/tz``. """ tmpdir = tempfile.mkdtemp() zonedir = os.path.join(tmpdir, "zoneinfo") moduledir = os.path.dirname(__file__) try: with TarFile.open(filename) as tf: for name in zonegroups: tf.extract(name, tmpdir) filepaths = [os.path.join(tmpdir, n) for n in zonegroups] _run_zic(zonedir, filepaths) # write metadata file with open(os.path.join(zonedir, METADATA_FN), 'w') as f: json.dump(metadata, f, indent=4, sort_keys=True) target = os.path.join(moduledir, ZONEFILENAME) with TarFile.open(target, "w:%s" % format) as tf: for entry in os.listdir(zonedir): entrypath = os.path.join(zonedir, entry) tf.add(entrypath, entry) finally: shutil.rmtree(tmpdir) def _run_zic(zonedir, filepaths): """Calls the ``zic`` compiler in a compatible way to get a "fat" binary. Recent versions of ``zic`` default to ``-b slim``, while older versions don't even have the ``-b`` option (but default to "fat" binaries). The current version of dateutil does not support Version 2+ TZif files, which causes problems when used in conjunction with "slim" binaries, so this function is used to ensure that we always get a "fat" binary. """ try: help_text = check_output(["zic", "--help"]) except OSError as e: _print_on_nosuchfile(e) raise if b"-b " in help_text: bloat_args = ["-b", "fat"] else: bloat_args = [] check_call(["zic"] + bloat_args + ["-d", zonedir] + filepaths) def _print_on_nosuchfile(e): """Print helpful troubleshooting message e is an exception raised by subprocess.check_call() """ if e.errno == 2: logging.error( "Could not find zic. Perhaps you need to install " "libc-bin or some other package that provides it, " "or it's not in your PATH?") ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1658728 python-dateutil-2.8.2/docs/0000755000175100001710000000000000000000000015145 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/Makefile0000644000175100001710000001516200000000000016612 0ustar00runnerdocker# Makefile for Sphinx documentation # # You can set these variables from the command line. SPHINXOPTS = SPHINXBUILD = sphinx-build PAPER = BUILDDIR = _build # User-friendly check for sphinx-build ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1) $(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/) endif # Internal variables. PAPEROPT_a4 = -D latex_paper_size=a4 PAPEROPT_letter = -D latex_paper_size=letter ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . # the i18n builder cannot share the environment and doctrees with the others I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext help: @echo "Please use \`make ' where is one of" @echo " html to make standalone HTML files" @echo " dirhtml to make HTML files named index.html in directories" @echo " singlehtml to make a single large HTML file" @echo " pickle to make pickle files" @echo " json to make JSON files" @echo " htmlhelp to make HTML files and a HTML help project" @echo " qthelp to make HTML files and a qthelp project" @echo " devhelp to make HTML files and a Devhelp project" @echo " epub to make an epub" @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" @echo " latexpdf to make LaTeX files and run them through pdflatex" @echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx" @echo " text to make text files" @echo " man to make manual pages" @echo " texinfo to make Texinfo files" @echo " info to make Texinfo files and run them through makeinfo" @echo " gettext to make PO message catalogs" @echo " changes to make an overview of all changed/added/deprecated items" @echo " xml to make Docutils-native XML files" @echo " pseudoxml to make pseudoxml-XML files for display purposes" @echo " linkcheck to check all external links for integrity" @echo " doctest to run all doctests embedded in the documentation (if enabled)" clean: rm -rf $(BUILDDIR)/* html: $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." dirhtml: $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml." singlehtml: $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml @echo @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml." pickle: $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle @echo @echo "Build finished; now you can process the pickle files." json: $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json @echo @echo "Build finished; now you can process the JSON files." htmlhelp: $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp @echo @echo "Build finished; now you can run HTML Help Workshop with the" \ ".hhp project file in $(BUILDDIR)/htmlhelp." qthelp: $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp @echo @echo "Build finished; now you can run "qcollectiongenerator" with the" \ ".qhcp project file in $(BUILDDIR)/qthelp, like this:" @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/dateutil.qhcp" @echo "To view the help file:" @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/dateutil.qhc" devhelp: $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp @echo @echo "Build finished." @echo "To view the help file:" @echo "# mkdir -p $$HOME/.local/share/devhelp/dateutil" @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/dateutil" @echo "# devhelp" epub: $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub @echo @echo "Build finished. The epub file is in $(BUILDDIR)/epub." latex: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex." @echo "Run \`make' in that directory to run these through (pdf)latex" \ "(use \`make latexpdf' here to do that automatically)." latexpdf: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through pdflatex..." $(MAKE) -C $(BUILDDIR)/latex all-pdf @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." latexpdfja: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through platex and dvipdfmx..." $(MAKE) -C $(BUILDDIR)/latex all-pdf-ja @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." text: $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text @echo @echo "Build finished. The text files are in $(BUILDDIR)/text." man: $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man @echo @echo "Build finished. The manual pages are in $(BUILDDIR)/man." texinfo: $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo @echo @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo." @echo "Run \`make' in that directory to run these through makeinfo" \ "(use \`make info' here to do that automatically)." info: $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo @echo "Running Texinfo files through makeinfo..." make -C $(BUILDDIR)/texinfo info @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo." gettext: $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale @echo @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale." changes: $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes @echo @echo "The overview file is in $(BUILDDIR)/changes." linkcheck: $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck @echo @echo "Link check complete; look for any errors in the above output " \ "or in $(BUILDDIR)/linkcheck/output.txt." doctest: $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest @echo "Testing of doctests in the sources finished, look at the " \ "results in $(BUILDDIR)/doctest/output.txt." xml: $(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml @echo @echo "Build finished. The XML files are in $(BUILDDIR)/xml." pseudoxml: $(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml @echo @echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml." ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/changelog.rst0000644000175100001710000000014100000000000017622 0ustar00runnerdocker.. Changelog transcluded from the NEWS file ========= Changelog ========= .. include:: ../NEWS ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/conf.py0000644000175100001710000002146100000000000016450 0ustar00runnerdocker#!/usr/bin/env python3 # -*- coding: utf-8 -*- # # dateutil documentation build configuration file, created by # sphinx-quickstart on Thu Nov 20 23:18:41 2014. # # This file is execfile()d with the current directory set to its # containing dir. # # Note that not all possible configuration values are present in this # autogenerated file. # # All configuration values have a default; values that are commented out # serve to show the default. import sys import os # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. #sys.path.insert(0, os.path.abspath('.')) sys.path.insert(0, os.path.abspath('../')) # -- General configuration ------------------------------------------------ # If your documentation needs a minimal Sphinx version, state it here. #needs_sphinx = '1.0' # Add any Sphinx extension module names here, as strings. They can be # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = [ 'sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.viewcode', ] # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] # The suffix of source filenames. source_suffix = '.rst' # The encoding of source files. #source_encoding = 'utf-8-sig' # The master toctree document. master_doc = 'index' # General information about the project. project = 'dateutil' copyright = '2019, dateutil' # The version info for the project you're documenting, acts as replacement for # |version| and |release|, also used in various other places throughout the # built documents. # # The short X.Y version. from dateutil import __version__ as VERSION # Explicitly use a relative path version = VERSION # The full version, including alpha/beta/rc tags. release = VERSION # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. #language = None # There are two options for replacing |today|: either, you set today to some # non-false value, then it is used: #today = '' # Else, today_fmt is used as the format for a strftime call. #today_fmt = '%B %d, %Y' # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. exclude_patterns = ['_build'] # The reST default role (used for this markup: `text`) to use for all # documents. #default_role = None # If true, '()' will be appended to :func: etc. cross-reference text. #add_function_parentheses = True # If true, the current module name will be prepended to all description # unit titles (such as .. function::). #add_module_names = True # If true, sectionauthor and moduleauthor directives will be shown in the # output. They are ignored by default. #show_authors = False # The name of the Pygments (syntax highlighting) style to use. pygments_style = 'sphinx' # A list of ignored prefixes for module index sorting. #modindex_common_prefix = [] # If true, keep warnings as "system message" paragraphs in the built documents. #keep_warnings = False # -- Options for HTML output ---------------------------------------------- # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. html_theme = 'sphinx_rtd_theme' # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the # documentation. #html_theme_options = {} # Add any paths that contain custom themes here, relative to this directory. #html_theme_path = [] # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". #html_title = None # A shorter title for the navigation bar. Default is the same as html_title. #html_short_title = None # The name of an image file (relative to this directory) to place at the top # of the sidebar. #html_logo = None # The name of an image file (within the static path) to use as favicon of the # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 # pixels large. #html_favicon = None # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = [] # Add any extra paths that contain custom files (such as robots.txt or # .htaccess) here, relative to this directory. These files are copied # directly to the root of the documentation. #html_extra_path = [] # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, # using the given strftime format. #html_last_updated_fmt = '%b %d, %Y' # If true, SmartyPants will be used to convert quotes and dashes to # typographically correct entities. #html_use_smartypants = True # Custom sidebar templates, maps document names to template names. #html_sidebars = {} # Additional templates that should be rendered to pages, maps page names to # template names. #html_additional_pages = {} # If false, no module index is generated. #html_domain_indices = True # If false, no index is generated. #html_use_index = True # If true, the index is split into individual pages for each letter. #html_split_index = False # If true, links to the reST sources are added to the pages. #html_show_sourcelink = True # If true, "Created using Sphinx" is shown in the HTML footer. Default is True. #html_show_sphinx = True # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. #html_show_copyright = True # If true, an OpenSearch description file will be output, and all pages will # contain a tag referring to it. The value of this option must be the # base URL from which the finished HTML is served. #html_use_opensearch = '' # This is the file name suffix for HTML files (e.g. ".xhtml"). #html_file_suffix = None # Output file base name for HTML help builder. htmlhelp_basename = 'dateutildoc' # -- Options for autodoc ------------------------------------------------- autodoc_mock_imports = ['ctypes.wintypes', 'six.moves.winreg'] # Need to mock this out specifically to avoid errors import ctypes def pointer_mock(*args, **kwargs): try: return ctypes.POINTER(*args, **kwargs) except Exception: return None ctypes.POINTER = pointer_mock sys.modules['ctypes'] = ctypes # -- Options for LaTeX output --------------------------------------------- latex_elements = { # The paper size ('letterpaper' or 'a4paper'). #'papersize': 'letterpaper', # The font size ('10pt', '11pt' or '12pt'). #'pointsize': '10pt', # Additional stuff for the LaTeX preamble. #'preamble': '', } # Grouping the document tree into LaTeX files. List of tuples # (source start file, target name, title, # author, documentclass [howto, manual, or own class]). latex_documents = [ ('index', 'dateutil.tex', 'dateutil Documentation', 'dateutil', 'manual'), ] # The name of an image file (relative to this directory) to place at the top of # the title page. #latex_logo = None # For "manual" documents, if this is true, then toplevel headings are parts, # not chapters. #latex_use_parts = False # If true, show page references after internal links. #latex_show_pagerefs = False # If true, show URL addresses after external links. #latex_show_urls = False # Documents to append as an appendix to all manuals. #latex_appendices = [] # If false, no module index is generated. #latex_domain_indices = True # -- Options for manual page output --------------------------------------- # One entry per manual page. List of tuples # (source start file, name, description, authors, manual section). man_pages = [ ('index', 'dateutil', 'dateutil Documentation', ['dateutil'], 1) ] # If true, show URL addresses after external links. #man_show_urls = False # -- Options for Texinfo output ------------------------------------------- # Grouping the document tree into Texinfo files. List of tuples # (source start file, target name, title, author, # dir menu entry, description, category) texinfo_documents = [ ('index', 'dateutil', 'dateutil Documentation', 'dateutil', 'dateutil', 'One line description of project.', 'Miscellaneous'), ] # Documents to append as an appendix to all manuals. #texinfo_appendices = [] # If false, no module index is generated. #texinfo_domain_indices = True # How to display URL addresses: 'footnote', 'no', or 'inline'. #texinfo_show_urls = 'footnote' # If true, do not generate a @detailmenu in the "Top" node's menu. #texinfo_no_detailmenu = False # -- Link checking options ------------------------------------------------- linkcheck_ignore = [ # This has been spotty lately so we're adding a mirror r'https://pgp.mit.edu', ] # Reduce problems with ephemeral failures linkcheck_retries = 5 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/easter.rst0000644000175100001710000000012500000000000017160 0ustar00runnerdocker====== easter ====== .. automodule:: dateutil.easter :members: :undoc-members: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/examples.rst0000644000175100001710000011670100000000000017523 0ustar00runnerdockerdateutil examples ================= .. contents:: relativedelta examples ---------------------- .. testsetup:: relativedelta from datetime import *; from dateutil.relativedelta import * import calendar NOW = datetime(2003, 9, 17, 20, 54, 47, 282310) TODAY = date(2003, 9, 17) Let's begin our trip:: >>> from datetime import *; from dateutil.relativedelta import * >>> import calendar Store some values:: >>> NOW = datetime.now() >>> TODAY = date.today() >>> NOW datetime.datetime(2003, 9, 17, 20, 54, 47, 282310) >>> TODAY datetime.date(2003, 9, 17) Next month .. doctest:: relativedelta >>> NOW+relativedelta(months=+1) datetime.datetime(2003, 10, 17, 20, 54, 47, 282310) Next month, plus one week. .. doctest:: relativedelta >>> NOW+relativedelta(months=+1, weeks=+1) datetime.datetime(2003, 10, 24, 20, 54, 47, 282310) Next month, plus one week, at 10am. .. doctest:: relativedelta >>> TODAY+relativedelta(months=+1, weeks=+1, hour=10) datetime.datetime(2003, 10, 24, 10, 0) Here is another example using an absolute relativedelta. Notice the use of year and month (both singular) which causes the values to be *replaced* in the original datetime rather than performing an arithmetic operation on them. .. doctest:: relativedelta >>> NOW+relativedelta(year=1, month=1) datetime.datetime(1, 1, 17, 20, 54, 47, 282310) Let's try the other way around. Notice that the hour setting we get in the relativedelta is relative, since it's a difference, and the weeks parameter has gone. .. doctest:: relativedelta >>> relativedelta(datetime(2003, 10, 24, 10, 0), TODAY) relativedelta(months=+1, days=+7, hours=+10) One month before one year. .. doctest:: relativedelta >>> NOW+relativedelta(years=+1, months=-1) datetime.datetime(2004, 8, 17, 20, 54, 47, 282310) How does it handle months with different numbers of days? Notice that adding one month will never cross the month boundary. .. doctest:: relativedelta >>> date(2003,1,27)+relativedelta(months=+1) datetime.date(2003, 2, 27) >>> date(2003,1,31)+relativedelta(months=+1) datetime.date(2003, 2, 28) >>> date(2003,1,31)+relativedelta(months=+2) datetime.date(2003, 3, 31) The logic for years is the same, even on leap years. .. doctest:: relativedelta >>> date(2000,2,28)+relativedelta(years=+1) datetime.date(2001, 2, 28) >>> date(2000,2,29)+relativedelta(years=+1) datetime.date(2001, 2, 28) >>> date(1999,2,28)+relativedelta(years=+1) datetime.date(2000, 2, 28) >>> date(1999,3,1)+relativedelta(years=+1) datetime.date(2000, 3, 1) >>> date(2001,2,28)+relativedelta(years=-1) datetime.date(2000, 2, 28) >>> date(2001,3,1)+relativedelta(years=-1) datetime.date(2000, 3, 1) Next friday .. doctest:: relativedelta >>> TODAY+relativedelta(weekday=FR) datetime.date(2003, 9, 19) >>> TODAY+relativedelta(weekday=calendar.FRIDAY) datetime.date(2003, 9, 19) Last friday in this month. .. doctest:: relativedelta >>> TODAY+relativedelta(day=31, weekday=FR(-1)) datetime.date(2003, 9, 26) Next wednesday (it's today!). .. doctest:: relativedelta >>> TODAY+relativedelta(weekday=WE(+1)) datetime.date(2003, 9, 17) Next wednesday, but not today. .. doctest:: relativedelta >>> TODAY+relativedelta(days=+1, weekday=WE(+1)) datetime.date(2003, 9, 24) Following `ISO year week number notation `_ find the first day of the 15th week of 1997. .. doctest:: relativedelta >>> datetime(1997,1,1)+relativedelta(day=4, weekday=MO(-1), weeks=+14) datetime.datetime(1997, 4, 7, 0, 0) How long ago has the millennium changed? .. doctest:: relativedelta :options: +NORMALIZE_WHITESPACE >>> relativedelta(NOW, date(2001,1,1)) relativedelta(years=+2, months=+8, days=+16, hours=+20, minutes=+54, seconds=+47, microseconds=+282310) How old is John? .. doctest:: relativedelta :options: +NORMALIZE_WHITESPACE >>> johnbirthday = datetime(1978, 4, 5, 12, 0) >>> relativedelta(NOW, johnbirthday) relativedelta(years=+25, months=+5, days=+12, hours=+8, minutes=+54, seconds=+47, microseconds=+282310) It works with dates too. .. doctest:: relativedelta >>> relativedelta(TODAY, johnbirthday) relativedelta(years=+25, months=+5, days=+11, hours=+12) Obtain today's date using the yearday: .. doctest:: relativedelta >>> date(2003, 1, 1)+relativedelta(yearday=260) datetime.date(2003, 9, 17) We can use today's date, since yearday should be absolute in the given year: .. doctest:: relativedelta >>> TODAY+relativedelta(yearday=260) datetime.date(2003, 9, 17) Last year it should be in the same day: .. doctest:: relativedelta >>> date(2002, 1, 1)+relativedelta(yearday=260) datetime.date(2002, 9, 17) But not in a leap year: .. doctest:: relativedelta >>> date(2000, 1, 1)+relativedelta(yearday=260) datetime.date(2000, 9, 16) We can use the non-leap year day to ignore this: .. doctest:: relativedelta >>> date(2000, 1, 1)+relativedelta(nlyearday=260) datetime.date(2000, 9, 17) rrule examples -------------- These examples were converted from the RFC. Prepare the environment. .. testsetup:: rrule from dateutil.rrule import * from dateutil.parser import * from datetime import * import pprint import sys sys.displayhook = pprint.pprint .. doctest:: rrule >>> from dateutil.rrule import * >>> from dateutil.parser import * >>> from datetime import * >>> import pprint >>> import sys >>> sys.displayhook = pprint.pprint Daily, for 10 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(DAILY, count=10, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 3, 9, 0), datetime.datetime(1997, 9, 4, 9, 0), datetime.datetime(1997, 9, 5, 9, 0), datetime.datetime(1997, 9, 6, 9, 0), datetime.datetime(1997, 9, 7, 9, 0), datetime.datetime(1997, 9, 8, 9, 0), datetime.datetime(1997, 9, 9, 9, 0), datetime.datetime(1997, 9, 10, 9, 0), datetime.datetime(1997, 9, 11, 9, 0)] Daily until December 24, 1997 .. doctest:: rrule :options: +NORMALIZE_WHITESPACE, +ELLIPSIS >>> list(rrule(DAILY, ... dtstart=parse("19970902T090000"), ... until=parse("19971224T000000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 3, 9, 0), datetime.datetime(1997, 9, 4, 9, 0), ... datetime.datetime(1997, 12, 21, 9, 0), datetime.datetime(1997, 12, 22, 9, 0), datetime.datetime(1997, 12, 23, 9, 0)] Every other day, 5 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(DAILY, interval=2, count=5, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 4, 9, 0), datetime.datetime(1997, 9, 6, 9, 0), datetime.datetime(1997, 9, 8, 9, 0), datetime.datetime(1997, 9, 10, 9, 0)] Every 10 days, 5 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(DAILY, interval=10, count=5, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 12, 9, 0), datetime.datetime(1997, 9, 22, 9, 0), datetime.datetime(1997, 10, 2, 9, 0), datetime.datetime(1997, 10, 12, 9, 0)] Everyday in January, for 3 years. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE, +ELLIPSIS >>> list(rrule(YEARLY, bymonth=1, byweekday=range(7), ... dtstart=parse("19980101T090000"), ... until=parse("20000131T090000"))) [datetime.datetime(1998, 1, 1, 9, 0), datetime.datetime(1998, 1, 2, 9, 0), ... datetime.datetime(1998, 1, 30, 9, 0), datetime.datetime(1998, 1, 31, 9, 0), datetime.datetime(1999, 1, 1, 9, 0), datetime.datetime(1999, 1, 2, 9, 0), ... datetime.datetime(1999, 1, 30, 9, 0), datetime.datetime(1999, 1, 31, 9, 0), datetime.datetime(2000, 1, 1, 9, 0), datetime.datetime(2000, 1, 2, 9, 0), ... datetime.datetime(2000, 1, 30, 9, 0), datetime.datetime(2000, 1, 31, 9, 0)] Same thing, in another way. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE, +ELLIPSIS >>> list(rrule(DAILY, bymonth=1, ... dtstart=parse("19980101T090000"), ... until=parse("20000131T090000"))) [datetime.datetime(1998, 1, 1, 9, 0), ... datetime.datetime(2000, 1, 31, 9, 0)] Weekly for 10 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, count=10, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 9, 9, 0), datetime.datetime(1997, 9, 16, 9, 0), datetime.datetime(1997, 9, 23, 9, 0), datetime.datetime(1997, 9, 30, 9, 0), datetime.datetime(1997, 10, 7, 9, 0), datetime.datetime(1997, 10, 14, 9, 0), datetime.datetime(1997, 10, 21, 9, 0), datetime.datetime(1997, 10, 28, 9, 0), datetime.datetime(1997, 11, 4, 9, 0)] Every other week, 6 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, interval=2, count=6, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 16, 9, 0), datetime.datetime(1997, 9, 30, 9, 0), datetime.datetime(1997, 10, 14, 9, 0), datetime.datetime(1997, 10, 28, 9, 0), datetime.datetime(1997, 11, 11, 9, 0)] Weekly on Tuesday and Thursday for 5 weeks. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, count=10, wkst=SU, byweekday=(TU,TH), ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 4, 9, 0), datetime.datetime(1997, 9, 9, 9, 0), datetime.datetime(1997, 9, 11, 9, 0), datetime.datetime(1997, 9, 16, 9, 0), datetime.datetime(1997, 9, 18, 9, 0), datetime.datetime(1997, 9, 23, 9, 0), datetime.datetime(1997, 9, 25, 9, 0), datetime.datetime(1997, 9, 30, 9, 0), datetime.datetime(1997, 10, 2, 9, 0)] Every other week on Tuesday and Thursday, for 8 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, interval=2, count=8, ... wkst=SU, byweekday=(TU,TH), ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 4, 9, 0), datetime.datetime(1997, 9, 16, 9, 0), datetime.datetime(1997, 9, 18, 9, 0), datetime.datetime(1997, 9, 30, 9, 0), datetime.datetime(1997, 10, 2, 9, 0), datetime.datetime(1997, 10, 14, 9, 0), datetime.datetime(1997, 10, 16, 9, 0)] Monthly on the 1st Friday for ten occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, count=10, byweekday=FR(1), ... dtstart=parse("19970905T090000"))) [datetime.datetime(1997, 9, 5, 9, 0), datetime.datetime(1997, 10, 3, 9, 0), datetime.datetime(1997, 11, 7, 9, 0), datetime.datetime(1997, 12, 5, 9, 0), datetime.datetime(1998, 1, 2, 9, 0), datetime.datetime(1998, 2, 6, 9, 0), datetime.datetime(1998, 3, 6, 9, 0), datetime.datetime(1998, 4, 3, 9, 0), datetime.datetime(1998, 5, 1, 9, 0), datetime.datetime(1998, 6, 5, 9, 0)] Every other month on the 1st and last Sunday of the month for 10 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, interval=2, count=10, ... byweekday=(SU(1), SU(-1)), ... dtstart=parse("19970907T090000"))) [datetime.datetime(1997, 9, 7, 9, 0), datetime.datetime(1997, 9, 28, 9, 0), datetime.datetime(1997, 11, 2, 9, 0), datetime.datetime(1997, 11, 30, 9, 0), datetime.datetime(1998, 1, 4, 9, 0), datetime.datetime(1998, 1, 25, 9, 0), datetime.datetime(1998, 3, 1, 9, 0), datetime.datetime(1998, 3, 29, 9, 0), datetime.datetime(1998, 5, 3, 9, 0), datetime.datetime(1998, 5, 31, 9, 0)] Monthly on the second to last Monday of the month for 6 months. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, count=6, byweekday=MO(-2), ... dtstart=parse("19970922T090000"))) [datetime.datetime(1997, 9, 22, 9, 0), datetime.datetime(1997, 10, 20, 9, 0), datetime.datetime(1997, 11, 17, 9, 0), datetime.datetime(1997, 12, 22, 9, 0), datetime.datetime(1998, 1, 19, 9, 0), datetime.datetime(1998, 2, 16, 9, 0)] Monthly on the third to the last day of the month, for 6 months. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, count=6, bymonthday=-3, ... dtstart=parse("19970928T090000"))) [datetime.datetime(1997, 9, 28, 9, 0), datetime.datetime(1997, 10, 29, 9, 0), datetime.datetime(1997, 11, 28, 9, 0), datetime.datetime(1997, 12, 29, 9, 0), datetime.datetime(1998, 1, 29, 9, 0), datetime.datetime(1998, 2, 26, 9, 0)] Monthly on the 2nd and 15th of the month for 5 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, count=5, bymonthday=(2,15), ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 15, 9, 0), datetime.datetime(1997, 10, 2, 9, 0), datetime.datetime(1997, 10, 15, 9, 0), datetime.datetime(1997, 11, 2, 9, 0)] Monthly on the first and last day of the month for 3 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, count=5, bymonthday=(-1,1,), ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 30, 9, 0), datetime.datetime(1997, 10, 1, 9, 0), datetime.datetime(1997, 10, 31, 9, 0), datetime.datetime(1997, 11, 1, 9, 0), datetime.datetime(1997, 11, 30, 9, 0)] Every 18 months on the 10th thru 15th of the month for 10 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, interval=18, count=10, ... bymonthday=range(10,16), ... dtstart=parse("19970910T090000"))) [datetime.datetime(1997, 9, 10, 9, 0), datetime.datetime(1997, 9, 11, 9, 0), datetime.datetime(1997, 9, 12, 9, 0), datetime.datetime(1997, 9, 13, 9, 0), datetime.datetime(1997, 9, 14, 9, 0), datetime.datetime(1997, 9, 15, 9, 0), datetime.datetime(1999, 3, 10, 9, 0), datetime.datetime(1999, 3, 11, 9, 0), datetime.datetime(1999, 3, 12, 9, 0), datetime.datetime(1999, 3, 13, 9, 0)] Every Tuesday, every other month, 6 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, interval=2, count=6, byweekday=TU, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 9, 9, 0), datetime.datetime(1997, 9, 16, 9, 0), datetime.datetime(1997, 9, 23, 9, 0), datetime.datetime(1997, 9, 30, 9, 0), datetime.datetime(1997, 11, 4, 9, 0)] Yearly in June and July for 10 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(YEARLY, count=4, bymonth=(6,7), ... dtstart=parse("19970610T090000"))) [datetime.datetime(1997, 6, 10, 9, 0), datetime.datetime(1997, 7, 10, 9, 0), datetime.datetime(1998, 6, 10, 9, 0), datetime.datetime(1998, 7, 10, 9, 0)] Every 3rd year on the 1st, 100th and 200th day for 4 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(YEARLY, count=4, interval=3, byyearday=(1,100,200), ... dtstart=parse("19970101T090000"))) [datetime.datetime(1997, 1, 1, 9, 0), datetime.datetime(1997, 4, 10, 9, 0), datetime.datetime(1997, 7, 19, 9, 0), datetime.datetime(2000, 1, 1, 9, 0)] Every 20th Monday of the year, 3 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(YEARLY, count=3, byweekday=MO(20), ... dtstart=parse("19970519T090000"))) [datetime.datetime(1997, 5, 19, 9, 0), datetime.datetime(1998, 5, 18, 9, 0), datetime.datetime(1999, 5, 17, 9, 0)] Monday of week number 20 (where the default start of the week is Monday), 3 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(YEARLY, count=3, byweekno=20, byweekday=MO, ... dtstart=parse("19970512T090000"))) [datetime.datetime(1997, 5, 12, 9, 0), datetime.datetime(1998, 5, 11, 9, 0), datetime.datetime(1999, 5, 17, 9, 0)] The week number 1 may be in the last year. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, count=3, byweekno=1, byweekday=MO, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 12, 29, 9, 0), datetime.datetime(1999, 1, 4, 9, 0), datetime.datetime(2000, 1, 3, 9, 0)] And the week numbers greater than 51 may be in the next year. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, count=3, byweekno=52, byweekday=SU, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 12, 28, 9, 0), datetime.datetime(1998, 12, 27, 9, 0), datetime.datetime(2000, 1, 2, 9, 0)] Only some years have week number 53: .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, count=3, byweekno=53, byweekday=MO, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1998, 12, 28, 9, 0), datetime.datetime(2004, 12, 27, 9, 0), datetime.datetime(2009, 12, 28, 9, 0)] Every Friday the 13th, 4 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(YEARLY, count=4, byweekday=FR, bymonthday=13, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1998, 2, 13, 9, 0), datetime.datetime(1998, 3, 13, 9, 0), datetime.datetime(1998, 11, 13, 9, 0), datetime.datetime(1999, 8, 13, 9, 0)] Every four years, the first Tuesday after a Monday in November, 3 occurrences (U.S. Presidential Election day): .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(YEARLY, interval=4, count=3, bymonth=11, ... byweekday=TU, bymonthday=(2,3,4,5,6,7,8), ... dtstart=parse("19961105T090000"))) [datetime.datetime(1996, 11, 5, 9, 0), datetime.datetime(2000, 11, 7, 9, 0), datetime.datetime(2004, 11, 2, 9, 0)] The 3rd instance into the month of one of Tuesday, Wednesday or Thursday, for the next 3 months: .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, count=3, byweekday=(TU,WE,TH), ... bysetpos=3, dtstart=parse("19970904T090000"))) [datetime.datetime(1997, 9, 4, 9, 0), datetime.datetime(1997, 10, 7, 9, 0), datetime.datetime(1997, 11, 6, 9, 0)] The 2nd to last weekday of the month, 3 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, count=3, byweekday=(MO,TU,WE,TH,FR), ... bysetpos=-2, dtstart=parse("19970929T090000"))) [datetime.datetime(1997, 9, 29, 9, 0), datetime.datetime(1997, 10, 30, 9, 0), datetime.datetime(1997, 11, 27, 9, 0)] Every 3 hours from 9:00 AM to 5:00 PM on a specific day. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(HOURLY, interval=3, ... dtstart=parse("19970902T090000"), ... until=parse("19970902T170000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 2, 12, 0), datetime.datetime(1997, 9, 2, 15, 0)] Every 15 minutes for 6 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MINUTELY, interval=15, count=6, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 2, 9, 15), datetime.datetime(1997, 9, 2, 9, 30), datetime.datetime(1997, 9, 2, 9, 45), datetime.datetime(1997, 9, 2, 10, 0), datetime.datetime(1997, 9, 2, 10, 15)] Every hour and a half for 4 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MINUTELY, interval=90, count=4, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 2, 10, 30), datetime.datetime(1997, 9, 2, 12, 0), datetime.datetime(1997, 9, 2, 13, 30)] Every 20 minutes from 9:00 AM to 4:40 PM for two days. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE, +ELLIPSIS >>> list(rrule(MINUTELY, interval=20, count=48, ... byhour=range(9,17), byminute=(0,20,40), ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 2, 9, 20), ... datetime.datetime(1997, 9, 2, 16, 20), datetime.datetime(1997, 9, 2, 16, 40), datetime.datetime(1997, 9, 3, 9, 0), datetime.datetime(1997, 9, 3, 9, 20), ... datetime.datetime(1997, 9, 3, 16, 20), datetime.datetime(1997, 9, 3, 16, 40)] An example where the days generated makes a difference because of `wkst`. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, interval=2, count=4, ... byweekday=(TU,SU), wkst=MO, ... dtstart=parse("19970805T090000"))) [datetime.datetime(1997, 8, 5, 9, 0), datetime.datetime(1997, 8, 10, 9, 0), datetime.datetime(1997, 8, 19, 9, 0), datetime.datetime(1997, 8, 24, 9, 0)] >>> list(rrule(WEEKLY, interval=2, count=4, ... byweekday=(TU,SU), wkst=SU, ... dtstart=parse("19970805T090000"))) [datetime.datetime(1997, 8, 5, 9, 0), datetime.datetime(1997, 8, 17, 9, 0), datetime.datetime(1997, 8, 19, 9, 0), datetime.datetime(1997, 8, 31, 9, 0)] rruleset examples ----------------- Daily, for 7 days, jumping Saturday and Sunday occurrences. .. testsetup:: rruleset import datetime from dateutil.parser import parse from dateutil.rrule import rrule, rruleset from dateutil.rrule import YEARLY, MONTHLY, WEEKLY, DAILY from dateutil.rrule import MO, TU, WE, TH, FR, SA, SU import pprint import sys sys.displayhook = pprint.pprint .. doctest:: rruleset :options: +NORMALIZE_WHITESPACE >>> set = rruleset() >>> set.rrule(rrule(DAILY, count=7, ... dtstart=parse("19970902T090000"))) >>> set.exrule(rrule(YEARLY, byweekday=(SA,SU), ... dtstart=parse("19970902T090000"))) >>> list(set) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 3, 9, 0), datetime.datetime(1997, 9, 4, 9, 0), datetime.datetime(1997, 9, 5, 9, 0), datetime.datetime(1997, 9, 8, 9, 0)] Weekly, for 4 weeks, plus one time on day 7, and not on day 16. .. doctest:: rruleset :options: +NORMALIZE_WHITESPACE >>> set = rruleset() >>> set.rrule(rrule(WEEKLY, count=4, ... dtstart=parse("19970902T090000"))) >>> set.rdate(datetime.datetime(1997, 9, 7, 9, 0)) >>> set.exdate(datetime.datetime(1997, 9, 16, 9, 0)) >>> list(set) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 7, 9, 0), datetime.datetime(1997, 9, 9, 9, 0), datetime.datetime(1997, 9, 23, 9, 0)] rrulestr() examples ------------------- Every 10 days, 5 occurrences. .. testsetup:: rrulestr from dateutil.parser import parse from dateutil.rrule import rruleset, rrulestr import pprint import sys sys.displayhook = pprint.pprint .. doctest:: rrulestr :options: +NORMALIZE_WHITESPACE >>> list(rrulestr(""" ... DTSTART:19970902T090000 ... RRULE:FREQ=DAILY;INTERVAL=10;COUNT=5 ... """)) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 12, 9, 0), datetime.datetime(1997, 9, 22, 9, 0), datetime.datetime(1997, 10, 2, 9, 0), datetime.datetime(1997, 10, 12, 9, 0)] Same thing, but passing only the `RRULE` value. .. doctest:: rrulestr :options: +NORMALIZE_WHITESPACE >>> list(rrulestr("FREQ=DAILY;INTERVAL=10;COUNT=5", ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 12, 9, 0), datetime.datetime(1997, 9, 22, 9, 0), datetime.datetime(1997, 10, 2, 9, 0), datetime.datetime(1997, 10, 12, 9, 0)] Notice that when using a single rule, it returns an `rrule` instance, unless `forceset` was used. .. doctest:: rrulestr :options: +ELLIPSIS >>> rrulestr("FREQ=DAILY;INTERVAL=10;COUNT=5") >>> rrulestr(""" ... DTSTART:19970902T090000 ... RRULE:FREQ=DAILY;INTERVAL=10;COUNT=5 ... """) >>> rrulestr("FREQ=DAILY;INTERVAL=10;COUNT=5", forceset=True) But when an `rruleset` is needed, it is automatically used. .. doctest:: rrulestr :options: +ELLIPSIS >>> rrulestr(""" ... DTSTART:19970902T090000 ... RRULE:FREQ=DAILY;INTERVAL=10;COUNT=5 ... RRULE:FREQ=DAILY;INTERVAL=5;COUNT=3 ... """) parse examples -------------- The following code will prepare the environment: .. doctest:: tz >>> from dateutil.parser import * >>> from dateutil.tz import * >>> from datetime import * >>> TZOFFSETS = {"BRST": -10800} >>> BRSTTZ = tzoffset("BRST", -10800) >>> DEFAULT = datetime(2003, 9, 25) Some simple examples based on the `date` command, using the `ZOFFSET` dictionary to provide the BRST timezone offset. .. doctest:: tz :options: +NORMALIZE_WHITESPACE >>> parse("Thu Sep 25 10:36:28 BRST 2003", tzinfos=TZOFFSETS) datetime.datetime(2003, 9, 25, 10, 36, 28, tzinfo=tzoffset('BRST', -10800)) >>> parse("2003 10:36:28 BRST 25 Sep Thu", tzinfos=TZOFFSETS) datetime.datetime(2003, 9, 25, 10, 36, 28, tzinfo=tzoffset('BRST', -10800)) Notice that since BRST is my local timezone, parsing it without further timezone settings will yield a `tzlocal` timezone. .. doctest:: tz >>> parse("Thu Sep 25 10:36:28 BRST 2003") datetime.datetime(2003, 9, 25, 10, 36, 28, tzinfo=tzlocal()) We can also ask to ignore the timezone explicitly: .. doctest:: tz >>> parse("Thu Sep 25 10:36:28 BRST 2003", ignoretz=True) datetime.datetime(2003, 9, 25, 10, 36, 28) That's the same as processing a string without timezone: .. doctest:: tz >>> parse("Thu Sep 25 10:36:28 2003") datetime.datetime(2003, 9, 25, 10, 36, 28) Without the year, but passing our `DEFAULT` datetime to return the same year, no mattering what year we currently are in: .. doctest:: tz >>> parse("Thu Sep 25 10:36:28", default=DEFAULT) datetime.datetime(2003, 9, 25, 10, 36, 28) Strip it further: .. doctest:: tz >>> parse("Thu Sep 10:36:28", default=DEFAULT) datetime.datetime(2003, 9, 25, 10, 36, 28) >>> parse("Thu 10:36:28", default=DEFAULT) datetime.datetime(2003, 9, 25, 10, 36, 28) >>> parse("Thu 10:36", default=DEFAULT) datetime.datetime(2003, 9, 25, 10, 36) >>> parse("10:36", default=DEFAULT) datetime.datetime(2003, 9, 25, 10, 36) Strip in a different way: .. doctest:: tz >>> parse("Thu Sep 25 2003") datetime.datetime(2003, 9, 25, 0, 0) >>> parse("Sep 25 2003") datetime.datetime(2003, 9, 25, 0, 0) >>> parse("Sep 2003", default=DEFAULT) datetime.datetime(2003, 9, 25, 0, 0) >>> parse("Sep", default=DEFAULT) datetime.datetime(2003, 9, 25, 0, 0) >>> parse("2003", default=DEFAULT) datetime.datetime(2003, 9, 25, 0, 0) Another format, based on `date -R` (RFC822): .. doctest:: tz :options: +NORMALIZE_WHITESPACE >>> parse("Thu, 25 Sep 2003 10:49:41 -0300") datetime.datetime(2003, 9, 25, 10, 49, 41, tzinfo=tzoffset(None, -10800)) ISO format: .. doctest:: tz :options: +NORMALIZE_WHITESPACE >>> parse("2003-09-25T10:49:41.5-03:00") datetime.datetime(2003, 9, 25, 10, 49, 41, 500000, tzinfo=tzoffset(None, -10800)) Some variations: .. doctest:: tz >>> parse("2003-09-25T10:49:41") datetime.datetime(2003, 9, 25, 10, 49, 41) >>> parse("2003-09-25T10:49") datetime.datetime(2003, 9, 25, 10, 49) >>> parse("2003-09-25T10") datetime.datetime(2003, 9, 25, 10, 0) >>> parse("2003-09-25") datetime.datetime(2003, 9, 25, 0, 0) ISO format, without separators: .. doctest:: tz :options: +NORMALIZE_WHITESPACE >>> parse("20030925T104941.5-0300") datetime.datetime(2003, 9, 25, 10, 49, 41, 500000, tzinfo=tzoffset(None, -10800)) >>> parse("20030925T104941-0300") datetime.datetime(2003, 9, 25, 10, 49, 41, tzinfo=tzoffset(None, -10800)) >>> parse("20030925T104941") datetime.datetime(2003, 9, 25, 10, 49, 41) >>> parse("20030925T1049") datetime.datetime(2003, 9, 25, 10, 49) >>> parse("20030925T10") datetime.datetime(2003, 9, 25, 10, 0) >>> parse("20030925") datetime.datetime(2003, 9, 25, 0, 0) Everything together. .. doctest:: tz >>> parse("199709020900") datetime.datetime(1997, 9, 2, 9, 0) >>> parse("19970902090059") datetime.datetime(1997, 9, 2, 9, 0, 59) Different date orderings: .. doctest:: tz >>> parse("2003-09-25") datetime.datetime(2003, 9, 25, 0, 0) >>> parse("2003-Sep-25") datetime.datetime(2003, 9, 25, 0, 0) >>> parse("25-Sep-2003") datetime.datetime(2003, 9, 25, 0, 0) >>> parse("Sep-25-2003") datetime.datetime(2003, 9, 25, 0, 0) >>> parse("09-25-2003") datetime.datetime(2003, 9, 25, 0, 0) >>> parse("25-09-2003") datetime.datetime(2003, 9, 25, 0, 0) Check some ambiguous dates: .. doctest:: tz >>> parse("10-09-2003") datetime.datetime(2003, 10, 9, 0, 0) >>> parse("10-09-2003", dayfirst=True) datetime.datetime(2003, 9, 10, 0, 0) >>> parse("10-09-03") datetime.datetime(2003, 10, 9, 0, 0) >>> parse("10-09-03", yearfirst=True) datetime.datetime(2010, 9, 3, 0, 0) Other date separators are allowed: .. doctest:: tz >>> parse("2003.Sep.25") datetime.datetime(2003, 9, 25, 0, 0) >>> parse("2003/09/25") datetime.datetime(2003, 9, 25, 0, 0) Even with spaces: .. doctest:: tz >>> parse("2003 Sep 25") datetime.datetime(2003, 9, 25, 0, 0) >>> parse("2003 09 25") datetime.datetime(2003, 9, 25, 0, 0) Hours with letters work: .. doctest:: tz >>> parse("10h36m28.5s", default=DEFAULT) datetime.datetime(2003, 9, 25, 10, 36, 28, 500000) >>> parse("01s02h03m", default=DEFAULT) datetime.datetime(2003, 9, 25, 2, 3, 1) >>> parse("01h02m03", default=DEFAULT) datetime.datetime(2003, 9, 25, 1, 2, 3) >>> parse("01h02", default=DEFAULT) datetime.datetime(2003, 9, 25, 1, 2) >>> parse("01h02s", default=DEFAULT) datetime.datetime(2003, 9, 25, 1, 0, 2) With AM/PM: .. doctest:: tz >>> parse("10h am", default=DEFAULT) datetime.datetime(2003, 9, 25, 10, 0) >>> parse("10pm", default=DEFAULT) datetime.datetime(2003, 9, 25, 22, 0) >>> parse("12:00am", default=DEFAULT) datetime.datetime(2003, 9, 25, 0, 0) >>> parse("12pm", default=DEFAULT) datetime.datetime(2003, 9, 25, 12, 0) Some special treating for ''pertain'' relations: .. doctest:: tz >>> parse("Sep 03", default=DEFAULT) datetime.datetime(2003, 9, 3, 0, 0) >>> parse("Sep of 03", default=DEFAULT) datetime.datetime(2003, 9, 25, 0, 0) Fuzzy parsing: .. doctest:: tz :options: +NORMALIZE_WHITESPACE >>> s = "Today is 25 of September of 2003, exactly " \ ... "at 10:49:41 with timezone -03:00." >>> parse(s, fuzzy=True) datetime.datetime(2003, 9, 25, 10, 49, 41, tzinfo=tzoffset(None, -10800)) Other random formats: .. doctest:: tz >>> parse("Wed, July 10, '96") datetime.datetime(1996, 7, 10, 0, 0) >>> parse("1996.07.10 AD at 15:08:56 PDT", ignoretz=True) datetime.datetime(1996, 7, 10, 15, 8, 56) >>> parse("Tuesday, April 12, 1952 AD 3:30:42pm PST", ignoretz=True) datetime.datetime(1952, 4, 12, 15, 30, 42) >>> parse("November 5, 1994, 8:15:30 am EST", ignoretz=True) datetime.datetime(1994, 11, 5, 8, 15, 30) >>> parse("3rd of May 2001") datetime.datetime(2001, 5, 3, 0, 0) >>> parse("5:50 A.M. on June 13, 1990") datetime.datetime(1990, 6, 13, 5, 50) Override parserinfo with a custom parserinfo .. doctest:: tz >>> from dateutil.parser import parse, parserinfo >>> class CustomParserInfo(parserinfo): ... # e.g. edit a property of parserinfo to allow a custom 12 hour format ... AMPM = [("am", "a", "xm"), ("pm", "p")] >>> parse('2018-06-08 12:06:58 XM', parserinfo=CustomParserInfo()) datetime.datetime(2018, 6, 8, 0, 6, 58) tzutc examples -------------- .. doctest:: tzutc >>> from datetime import * >>> from dateutil import tz >>> datetime.now() datetime.datetime(2003, 9, 27, 9, 40, 1, 521290) >>> datetime.now(tz.UTC) datetime.datetime(2003, 9, 27, 12, 40, 12, 156379, tzinfo=tzutc()) >>> datetime.now(tz.UTC).tzname() 'UTC' tzoffset examples ----------------- .. doctest:: tzoffset :options: +NORMALIZE_WHITESPACE >>> from datetime import * >>> from dateutil.tz import * >>> datetime.now(tzoffset("BRST", -10800)) datetime.datetime(2003, 9, 27, 9, 52, 43, 624904, tzinfo=tzinfo=tzoffset('BRST', -10800)) >>> datetime.now(tzoffset("BRST", -10800)).tzname() 'BRST' >>> datetime.now(tzoffset("BRST", -10800)).astimezone(UTC) datetime.datetime(2003, 9, 27, 12, 53, 11, 446419, tzinfo=tzutc()) tzlocal examples ---------------- .. doctest:: tzlocal >>> from datetime import * >>> from dateutil.tz import * >>> datetime.now(tzlocal()) datetime.datetime(2003, 9, 27, 10, 1, 43, 673605, tzinfo=tzlocal()) >>> datetime.now(tzlocal()).tzname() 'BRST' >>> datetime.now(tzlocal()).astimezone(tzoffset(None, 0)) datetime.datetime(2003, 9, 27, 13, 3, 0, 11493, tzinfo=tzoffset(None, 0)) tzstr examples -------------- Here are examples of the recognized formats: * `EST5EDT` * `EST5EDT4,M4.1.0/02:00:00,M10-5-0/02:00` * `EST5EDT4,95/02:00:00,298/02:00` * `EST5EDT4,J96/02:00:00,J299/02:00` Notice that if daylight information is not present, but a daylight abbreviation was provided, `tzstr` will follow the convention of using the first sunday of April to start daylight saving, and the last sunday of October to end it. If start or end time is not present, 2AM will be used, and if the daylight offset is not present, the standard offset plus one hour will be used. This convention is the same as used in the GNU libc. This also means that some of the above examples are exactly equivalent, and all of these examples are equivalent in the year of 2003. Here is the example mentioned in the [https://docs.python.org/3/library/time.html time module documentation]. .. testsetup:: tzstr import os import time from datetime import datetime from dateutil.tz import tzstr .. doctest:: tzstr >>> os.environ['TZ'] = 'EST+05EDT,M4.1.0,M10.5.0' >>> time.tzset() >>> time.strftime('%X %x %Z') '02:07:36 05/08/03 EDT' >>> os.environ['TZ'] = 'AEST-10AEDT-11,M10.5.0,M3.5.0' >>> time.tzset() >>> time.strftime('%X %x %Z') '16:08:12 05/08/03 AEST' And here is an example showing the same information using `tzstr`, without touching system settings. .. doctest:: tzstr >>> tz1 = tzstr('EST+05EDT,M4.1.0,M10.5.0') >>> tz2 = tzstr('AEST-10AEDT-11,M10.5.0,M3.5.0') >>> dt = datetime(2003, 5, 8, 2, 7, 36, tzinfo=tz1) >>> dt.strftime('%X %x %Z') '02:07:36 05/08/03 EDT' >>> dt.astimezone(tz2).strftime('%X %x %Z') '16:07:36 05/08/03 AEST' Are these really equivalent? .. doctest:: tzstr >>> tzstr('EST5EDT') == tzstr('EST5EDT,M4.1.0,M10.5.0') True Check the daylight limit. .. doctest:: tzstr >>> tz = tzstr('EST+05EDT,M4.1.0,M10.5.0') >>> datetime(2003, 4, 6, 1, 59, tzinfo=tz).tzname() 'EST' >>> datetime(2003, 4, 6, 2, 00, tzinfo=tz).tzname() 'EDT' >>> datetime(2003, 10, 26, 0, 59, tzinfo=tz).tzname() 'EDT' >>> datetime(2003, 10, 26, 2, 00, tzinfo=tz).tzname() 'EST' tzrange examples ---------------- .. testsetup:: tzrange from dateutil.tz import tzrange, tzstr .. doctest:: tzrange >>> tzstr('EST5EDT') == tzrange("EST", -18000, "EDT") True >>> from dateutil.relativedelta import * >>> range1 = tzrange("EST", -18000, "EDT") >>> range2 = tzrange("EST", -18000, "EDT", -14400, ... relativedelta(hours=+2, month=4, day=1, ... weekday=SU(+1)), ... relativedelta(hours=+1, month=10, day=31, ... weekday=SU(-1))) >>> tzstr('EST5EDT') == range1 == range2 True Notice a minor detail in the last example: while the DST should end at 2AM, the delta will catch 1AM. That's because the daylight saving time should end at 2AM standard time (the difference between STD and DST is 1h in the given example) instead of the DST time. That's how the `tzinfo` subtypes should deal with the extra hour that happens when going back to the standard time. Check [https://docs.python.org/3/library/datetime.html#datetime.tzinfo tzinfo documentation] for more information. tzfile examples --------------- .. testsetup:: tzfile from datetime import datetime from dateutil.tz import tzfile, UTC .. doctest:: tzfile :options: +NORMALIZE_WHITESPACE >>> tz = tzfile("/etc/localtime") >>> datetime.now(tz) datetime.datetime(2003, 9, 27, 12, 3, 48, 392138, tzinfo=tzfile('/etc/localtime')) >>> datetime.now(tz).astimezone(UTC) datetime.datetime(2003, 9, 27, 15, 3, 53, 70863, tzinfo=tzutc()) >>> datetime.now(tz).tzname() 'BRST' >>> datetime(2003, 1, 1, tzinfo=tz).tzname() 'BRDT' Check the daylight limit. .. doctest:: tzfile >>> tz = tzfile('/usr/share/zoneinfo/EST5EDT') >>> datetime(2003, 4, 6, 1, 59, tzinfo=tz).tzname() 'EST' >>> datetime(2003, 4, 6, 2, 00, tzinfo=tz).tzname() 'EDT' >>> datetime(2003, 10, 26, 0, 59, tzinfo=tz).tzname() 'EDT' >>> datetime(2003, 10, 26, 1, 00, tzinfo=tz).tzname() 'EST' tzical examples --------------- Here is a sample file extracted from the RFC. This file defines the `EST5EDT` timezone, and will be used in the following example. .. include:: samples/EST5EDT.ics :literal: And here is an example exploring a `tzical` type: .. doctest:: tzfile >>> from dateutil.tz import *; from datetime import * >>> tz = tzical('samples/EST5EDT.ics') >>> tz.keys() ['US-Eastern'] >>> est = tz.get('US-Eastern') >>> est >>> datetime.now(est) datetime.datetime(2003, 10, 6, 19, 44, 18, 667987, tzinfo=) >>> est == tz.get() True Let's check the daylight ranges, as usual: .. doctest:: tzfile >>> datetime(2003, 4, 6, 1, 59, tzinfo=est).tzname() 'EST' >>> datetime(2003, 4, 6, 2, 00, tzinfo=est).tzname() 'EDT' >>> datetime(2003, 10, 26, 0, 59, tzinfo=est).tzname() 'EDT' >>> datetime(2003, 10, 26, 1, 00, tzinfo=est).tzname() 'EST' tzwin examples -------------- .. doctest:: tzwin >>> tz = tzwin("E. South America Standard Time") tzwinlocal examples ------------------- .. doctest:: tzwinlocal >>> tz = tzwinlocal() # vim:ts=4:sw=4:et ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1658728 python-dateutil-2.8.2/docs/exercises/0000755000175100001710000000000000000000000017137 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/exercises/index.rst0000644000175100001710000001711700000000000021007 0ustar00runnerdockerExercises ========= It is often useful to work through some examples in order to understand how a module works; on this page, there are several exercises of varying difficulty that you can use to learn how to use ``dateutil``. If you are interested in helping improve the documentation of ``dateutil``, it is recommended that you attempt to complete these exercises with no resources *other than dateutil's documentation*. If you find that the documentation is not clear enough to allow you to complete these exercises, open an issue on the `dateutil issue tracker `_ to let the developers know what part of the documentation needs improvement. .. contents:: Table of Contents :backlinks: top :local: .. _mlk-day-exercise: Martin Luther King Day -------------------------------- `Martin Luther King, Jr Day `_ is a US holiday that occurs every year on the third Monday in January? How would you generate a :doc:`recurrence rule <../rrule>` that generates Martin Luther King Day, starting from its first observance in 1986? **Test Script** To solve this exercise, copy-paste this script into a document, change anything between the ``--- YOUR CODE ---`` comment blocks. .. raw:: html
.. code-block:: python3 # ------- YOUR CODE -------------# from dateutil import rrule MLK_DAY = <> # -------------------------------# from datetime import datetime MLK_TEST_CASES = [ ((datetime(1970, 1, 1), datetime(1980, 1, 1)), []), ((datetime(1980, 1, 1), datetime(1989, 1, 1)), [datetime(1986, 1, 20), datetime(1987, 1, 19), datetime(1988, 1, 18)]), ((datetime(2017, 2, 1), datetime(2022, 2, 1)), [datetime(2018, 1, 15, 0, 0), datetime(2019, 1, 21, 0, 0), datetime(2020, 1, 20, 0, 0), datetime(2021, 1, 18, 0, 0), datetime(2022, 1, 17, 0, 0)] ), ] def test_mlk_day(): for (between_args, expected) in MLK_TEST_CASES: assert MLK_DAY.between(*between_args) == expected if __name__ == "__main__": test_mlk_day() print('Success!') .. raw:: html
A solution to this problem is provided :doc:`here `. Next Monday meeting ------------------- A team has a meeting at 10 AM every Monday and wants a function that tells them, given a ``datetime.datetime`` object, what is the date and time of the *next* Monday meeting? This is probably best accomplished using a :doc:`relativedelta <../relativedelta>`. **Test Script** To solve this exercise, copy-paste this script into a document, change anything between the ``--- YOUR CODE ---`` comment blocks. .. raw:: html
.. code-block:: python3 # --------- YOUR CODE -------------- # from dateutil import relativedelta def next_monday(dt): <> # ---------------------------------- # from datetime import datetime from dateutil import tz NEXT_MONDAY_CASES = [ (datetime(2018, 4, 11, 14, 30, 15, 123456), datetime(2018, 4, 16, 10, 0)), (datetime(2018, 4, 16, 10, 0), datetime(2018, 4, 16, 10, 0)), (datetime(2018, 4, 16, 10, 30), datetime(2018, 4, 23, 10, 0)), (datetime(2018, 4, 14, 9, 30, tzinfo=tz.gettz('America/New_York')), datetime(2018, 4, 16, 10, 0, tzinfo=tz.gettz('America/New_York'))), ] def test_next_monday_1(): for dt_in, dt_out in NEXT_MONDAY_CASES: assert next_monday(dt_in) == dt_out if __name__ == "__main__": test_next_monday_1() print('Success!') .. raw:: html
Parsing a local tzname ---------------------- Three-character time zone abbreviations are *not* unique in that they do not explicitly map to a time zone. A list of time zone abbreviations in use can be found `here `_. This means that parsing a datetime string such as ``'2018-01-01 12:30:30 CST'`` is ambiguous without context. Using :mod:`dateutil.parser` and :mod:`dateutil.tz`, it is possible to provide a context such that these local names are converted to proper time zones. Problem 1 ********* Given the context that you will only be parsing dates coming from the continental United States, India and Japan, write a function that parses a datetime string and returns a timezone-aware ``datetime`` with an IANA-style timezone attached. Note: For the purposes of the experiment, you may ignore the portions of the United States like Arizona and parts of Indiana that do not observe daylight saving time. **Test Script** To solve this exercise, copy-paste this script into a document, change anything between the ``--- YOUR CODE ---`` comment blocks. .. raw:: html
.. code-block:: python3 # --------- YOUR CODE -------------- # from dateutil.parser import parse from dateutil import tz def parse_func_us_jp_ind(): <> # ---------------------------------- # from dateutil import tz from datetime import datetime PARSE_TZ_TEST_DATETIMES = [ datetime(2018, 1, 1, 12, 0), datetime(2018, 3, 20, 2, 0), datetime(2018, 5, 12, 3, 30), datetime(2014, 9, 1, 23) ] PARSE_TZ_TEST_ZONES = [ tz.gettz('America/New_York'), tz.gettz('America/Chicago'), tz.gettz('America/Denver'), tz.gettz('America/Los_Angeles'), tz.gettz('Asia/Kolkata'), tz.gettz('Asia/Tokyo'), ] def test_parse(): for tzi in PARSE_TZ_TEST_ZONES: for dt in PARSE_TZ_TEST_DATETIMES: dt_exp = dt.replace(tzinfo=tzi) dtstr = dt_exp.strftime('%Y-%m-%d %H:%M:%S %Z') dt_act = parse_func_us_jp_ind(dtstr) assert dt_act == dt_exp assert dt_act.tzinfo is dt_exp.tzinfo if __name__ == "__main__": test_parse() print('Success!') .. raw:: html
Problem 2 ********* Given the context that you will *only* be passed dates from India or Ireland, write a function that correctly parses all *unambiguous* time zone strings to aware datetimes localized to the correct IANA zone, and for *ambiguous* time zone strings default to India. **Test Script** To solve this exercise, copy-paste this script into a document, change anything between the ``--- YOUR CODE ---`` comment blocks. .. raw:: html
.. code-block:: python3 # --------- YOUR CODE -------------- # from dateutil.parser import parse from dateutil import tz def parse_func_ind_ire(): <> # ---------------------------------- # ISRAEL = tz.gettz('Asia/Jerusalem') INDIA = tz.gettz('Asia/Kolkata') PARSE_IXT_TEST_CASE = [ ('2018-02-03 12:00 IST+02:00', datetime(2018, 2, 3, 12, tzinfo=ISRAEL)), ('2018-06-14 12:00 IDT+03:00', datetime(2018, 6, 14, 12, tzinfo=ISRAEL)), ('2018-06-14 12:00 IST', datetime(2018, 6, 14, 12, tzinfo=INDIA)), ('2018-06-14 12:00 IST+05:30', datetime(2018, 6, 14, 12, tzinfo=INDIA)), ('2018-02-03 12:00 IST', datetime(2018, 2, 3, 12, tzinfo=INDIA)), ] def test_parse_ixt(): for dtstr, dt_exp in PARSE_IXT_TEST_CASE: dt_act = parse_func_ind_ire(dtstr) assert dt_act == dt_exp, (dt_act, dt_exp) assert dt_act.tzinfo is dt_exp.tzinfo, (dt_act, dt_exp) if __name__ == "__main__": test_parse_ixt() print('Success!') .. raw:: html
././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1658728 python-dateutil-2.8.2/docs/exercises/solutions/0000755000175100001710000000000000000000000021176 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/exercises/solutions/mlk-day-rrule.rst0000644000175100001710000000035100000000000024414 0ustar00runnerdocker:orphan: Martin Luther King Day: Solution ================================ Presented here is a solution to the :ref:`Martin Luther King Day exercises `. .. include:: mlk_day_rrule_solution.py :code: python3 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/exercises/solutions/mlk_day_rrule_solution.py0000644000175100001710000000207000000000000026334 0ustar00runnerdocker# ------- YOUR CODE -------------# from dateutil import rrule from datetime import datetime MLK_DAY = rrule.rrule( dtstart=datetime(1986, 1, 20), # First celebration freq=rrule.YEARLY, # Occurs once per year bymonth=1, # In January byweekday=rrule.MO(+3), # On the 3rd Monday ) # -------------------------------# from datetime import datetime MLK_TEST_CASES = [ ((datetime(1970, 1, 1), datetime(1980, 1, 1)), []), ((datetime(1980, 1, 1), datetime(1989, 1, 1)), [datetime(1986, 1, 20), datetime(1987, 1, 19), datetime(1988, 1, 18)]), ((datetime(2017, 2, 1), datetime(2022, 2, 1)), [datetime(2018, 1, 15, 0, 0), datetime(2019, 1, 21, 0, 0), datetime(2020, 1, 20, 0, 0), datetime(2021, 1, 18, 0, 0), datetime(2022, 1, 17, 0, 0)] ), ] def test_mlk_day(): for (between_args, expected) in MLK_TEST_CASES: assert MLK_DAY.between(*between_args) == expected if __name__ == "__main__": test_mlk_day() print('Success!') ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/index.rst0000644000175100001710000000116500000000000017011 0ustar00runnerdocker.. dateutil documentation master file, created by sphinx-quickstart on Thu Nov 20 23:18:41 2014. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. .. include:: ../README.rst Documentation ============= Contents: .. toctree:: :maxdepth: 1 Overview Changelog Examples Exercises .. toctree:: :maxdepth: 2 easter parser relativedelta rrule tz tz.win utils zoneinfo Indices and tables ================== * :ref:`genindex` * :ref:`modindex` * :ref:`search` ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/make.bat0000644000175100001710000001506100000000000016555 0ustar00runnerdocker@ECHO OFF REM Command file for Sphinx documentation if "%SPHINXBUILD%" == "" ( set SPHINXBUILD=sphinx-build ) set BUILDDIR=_build set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% . set I18NSPHINXOPTS=%SPHINXOPTS% . if NOT "%PAPER%" == "" ( set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS% set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS% ) if "%1" == "" goto help if "%1" == "help" ( :help echo.Please use `make ^` where ^ is one of echo. html to make standalone HTML files echo. dirhtml to make HTML files named index.html in directories echo. singlehtml to make a single large HTML file echo. pickle to make pickle files echo. json to make JSON files echo. htmlhelp to make HTML files and a HTML help project echo. qthelp to make HTML files and a qthelp project echo. devhelp to make HTML files and a Devhelp project echo. epub to make an epub echo. latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter echo. text to make text files echo. man to make manual pages echo. texinfo to make Texinfo files echo. gettext to make PO message catalogs echo. changes to make an overview over all changed/added/deprecated items echo. xml to make Docutils-native XML files echo. pseudoxml to make pseudoxml-XML files for display purposes echo. linkcheck to check all external links for integrity echo. doctest to run all doctests embedded in the documentation if enabled goto end ) if "%1" == "clean" ( for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i del /q /s %BUILDDIR%\* goto end ) %SPHINXBUILD% 2> nul if errorlevel 9009 ( echo. echo.The 'sphinx-build' command was not found. Make sure you have Sphinx echo.installed, then set the SPHINXBUILD environment variable to point echo.to the full path of the 'sphinx-build' executable. Alternatively you echo.may add the Sphinx directory to PATH. echo. echo.If you don't have Sphinx installed, grab it from echo.http://sphinx-doc.org/ exit /b 1 ) if "%1" == "html" ( %SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html if errorlevel 1 exit /b 1 echo. echo.Build finished. The HTML pages are in %BUILDDIR%/html. goto end ) if "%1" == "dirhtml" ( %SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml if errorlevel 1 exit /b 1 echo. echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml. goto end ) if "%1" == "singlehtml" ( %SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml if errorlevel 1 exit /b 1 echo. echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml. goto end ) if "%1" == "pickle" ( %SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle if errorlevel 1 exit /b 1 echo. echo.Build finished; now you can process the pickle files. goto end ) if "%1" == "json" ( %SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json if errorlevel 1 exit /b 1 echo. echo.Build finished; now you can process the JSON files. goto end ) if "%1" == "htmlhelp" ( %SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp if errorlevel 1 exit /b 1 echo. echo.Build finished; now you can run HTML Help Workshop with the ^ .hhp project file in %BUILDDIR%/htmlhelp. goto end ) if "%1" == "qthelp" ( %SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp if errorlevel 1 exit /b 1 echo. echo.Build finished; now you can run "qcollectiongenerator" with the ^ .qhcp project file in %BUILDDIR%/qthelp, like this: echo.^> qcollectiongenerator %BUILDDIR%\qthelp\dateutil.qhcp echo.To view the help file: echo.^> assistant -collectionFile %BUILDDIR%\qthelp\dateutil.ghc goto end ) if "%1" == "devhelp" ( %SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp if errorlevel 1 exit /b 1 echo. echo.Build finished. goto end ) if "%1" == "epub" ( %SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub if errorlevel 1 exit /b 1 echo. echo.Build finished. The epub file is in %BUILDDIR%/epub. goto end ) if "%1" == "latex" ( %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex if errorlevel 1 exit /b 1 echo. echo.Build finished; the LaTeX files are in %BUILDDIR%/latex. goto end ) if "%1" == "latexpdf" ( %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex cd %BUILDDIR%/latex make all-pdf cd %BUILDDIR%/.. echo. echo.Build finished; the PDF files are in %BUILDDIR%/latex. goto end ) if "%1" == "latexpdfja" ( %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex cd %BUILDDIR%/latex make all-pdf-ja cd %BUILDDIR%/.. echo. echo.Build finished; the PDF files are in %BUILDDIR%/latex. goto end ) if "%1" == "text" ( %SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text if errorlevel 1 exit /b 1 echo. echo.Build finished. The text files are in %BUILDDIR%/text. goto end ) if "%1" == "man" ( %SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man if errorlevel 1 exit /b 1 echo. echo.Build finished. The manual pages are in %BUILDDIR%/man. goto end ) if "%1" == "texinfo" ( %SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo if errorlevel 1 exit /b 1 echo. echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo. goto end ) if "%1" == "gettext" ( %SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale if errorlevel 1 exit /b 1 echo. echo.Build finished. The message catalogs are in %BUILDDIR%/locale. goto end ) if "%1" == "changes" ( %SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes if errorlevel 1 exit /b 1 echo. echo.The overview file is in %BUILDDIR%/changes. goto end ) if "%1" == "linkcheck" ( %SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck if errorlevel 1 exit /b 1 echo. echo.Link check complete; look for any errors in the above output ^ or in %BUILDDIR%/linkcheck/output.txt. goto end ) if "%1" == "doctest" ( %SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest if errorlevel 1 exit /b 1 echo. echo.Testing of doctests in the sources finished, look at the ^ results in %BUILDDIR%/doctest/output.txt. goto end ) if "%1" == "xml" ( %SPHINXBUILD% -b xml %ALLSPHINXOPTS% %BUILDDIR%/xml if errorlevel 1 exit /b 1 echo. echo.Build finished. The XML files are in %BUILDDIR%/xml. goto end ) if "%1" == "pseudoxml" ( %SPHINXBUILD% -b pseudoxml %ALLSPHINXOPTS% %BUILDDIR%/pseudoxml if errorlevel 1 exit /b 1 echo. echo.Build finished. The pseudo-XML files are in %BUILDDIR%/pseudoxml. goto end ) :end ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/parser.rst0000644000175100001710000000061500000000000017175 0ustar00runnerdocker====== parser ====== .. automodule:: dateutil.parser Functions --------- .. automethod:: dateutil.parser.parse .. automethod:: dateutil.parser.isoparse Classes ------- .. autoclass:: dateutil.parser.parserinfo :members: :undoc-members: Warnings and Exceptions ----------------------- .. autoclass:: dateutil.parser.ParserError .. autoclass:: dateutil.parser.UnknownTimezoneWarning ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/relativedelta.rst0000644000175100001710000001225700000000000020533 0ustar00runnerdocker============= relativedelta ============= .. automodule:: dateutil.relativedelta :members: :undoc-members: .. testsetup:: relativedelta Examples -------- >>> from datetime import *; from dateutil.relativedelta import * >>> import calendar >>> NOW = datetime(2003, 9, 17, 20, 54, 47, 282310) >>> TODAY = date(2003, 9, 17) Let's begin our trip:: >>> from datetime import *; from dateutil.relativedelta import * >>> import calendar Store some values:: >>> NOW = datetime.now() >>> TODAY = date.today() >>> NOW datetime.datetime(2003, 9, 17, 20, 54, 47, 282310) >>> TODAY datetime.date(2003, 9, 17) Next month .. doctest:: relativedelta >>> NOW+relativedelta(months=+1) datetime.datetime(2003, 10, 17, 20, 54, 47, 282310) Next month, plus one week. .. doctest:: relativedelta >>> NOW+relativedelta(months=+1, weeks=+1) datetime.datetime(2003, 10, 24, 20, 54, 47, 282310) Next month, plus one week, at 10am. .. doctest:: relativedelta >>> TODAY+relativedelta(months=+1, weeks=+1, hour=10) datetime.datetime(2003, 10, 24, 10, 0) Here is another example using an absolute relativedelta. Notice the use of year and month (both singular) which causes the values to be *replaced* in the original datetime rather than performing an arithmetic operation on them. .. doctest:: relativedelta >>> NOW+relativedelta(year=1, month=1) datetime.datetime(1, 1, 17, 20, 54, 47, 282310) Let's try the other way around. Notice that the hour setting we get in the relativedelta is relative, since it's a difference, and the weeks parameter has gone. .. doctest:: relativedelta >>> relativedelta(datetime(2003, 10, 24, 10, 0), TODAY) relativedelta(months=+1, days=+7, hours=+10) One month before one year. .. doctest:: relativedelta >>> NOW+relativedelta(years=+1, months=-1) datetime.datetime(2004, 8, 17, 20, 54, 47, 282310) How does it handle months with different numbers of days? Notice that adding one month will never cross the month boundary. .. doctest:: relativedelta >>> date(2003,1,27)+relativedelta(months=+1) datetime.date(2003, 2, 27) >>> date(2003,1,31)+relativedelta(months=+1) datetime.date(2003, 2, 28) >>> date(2003,1,31)+relativedelta(months=+2) datetime.date(2003, 3, 31) The logic for years is the same, even on leap years. .. doctest:: relativedelta >>> date(2000,2,28)+relativedelta(years=+1) datetime.date(2001, 2, 28) >>> date(2000,2,29)+relativedelta(years=+1) datetime.date(2001, 2, 28) >>> date(1999,2,28)+relativedelta(years=+1) datetime.date(2000, 2, 28) >>> date(1999,3,1)+relativedelta(years=+1) datetime.date(2000, 3, 1) >>> date(2001,2,28)+relativedelta(years=-1) datetime.date(2000, 2, 28) >>> date(2001,3,1)+relativedelta(years=-1) datetime.date(2000, 3, 1) Next friday .. doctest:: relativedelta >>> TODAY+relativedelta(weekday=FR) datetime.date(2003, 9, 19) >>> TODAY+relativedelta(weekday=calendar.FRIDAY) datetime.date(2003, 9, 19) Last friday in this month. .. doctest:: relativedelta >>> TODAY+relativedelta(day=31, weekday=FR(-1)) datetime.date(2003, 9, 26) Next wednesday (it's today!). .. doctest:: relativedelta >>> TODAY+relativedelta(weekday=WE(+1)) datetime.date(2003, 9, 17) Next wednesday, but not today. .. doctest:: relativedelta >>> TODAY+relativedelta(days=+1, weekday=WE(+1)) datetime.date(2003, 9, 24) Following `ISO year week number notation `_ find the first day of the 15th week of 1997. .. doctest:: relativedelta >>> datetime(1997,1,1)+relativedelta(day=4, weekday=MO(-1), weeks=+14) datetime.datetime(1997, 4, 7, 0, 0) How long ago has the millennium changed? .. doctest:: relativedelta :options: +NORMALIZE_WHITESPACE >>> relativedelta(NOW, date(2001,1,1)) relativedelta(years=+2, months=+8, days=+16, hours=+20, minutes=+54, seconds=+47, microseconds=+282310) How old is John? .. doctest:: relativedelta :options: +NORMALIZE_WHITESPACE >>> johnbirthday = datetime(1978, 4, 5, 12, 0) >>> relativedelta(NOW, johnbirthday) relativedelta(years=+25, months=+5, days=+12, hours=+8, minutes=+54, seconds=+47, microseconds=+282310) It works with dates too. .. doctest:: relativedelta >>> relativedelta(TODAY, johnbirthday) relativedelta(years=+25, months=+5, days=+11, hours=+12) Obtain today's date using the yearday: .. doctest:: relativedelta >>> date(2003, 1, 1)+relativedelta(yearday=260) datetime.date(2003, 9, 17) We can use today's date, since yearday should be absolute in the given year: .. doctest:: relativedelta >>> TODAY+relativedelta(yearday=260) datetime.date(2003, 9, 17) Last year it should be in the same day: .. doctest:: relativedelta >>> date(2002, 1, 1)+relativedelta(yearday=260) datetime.date(2002, 9, 17) But not in a leap year: .. doctest:: relativedelta >>> date(2000, 1, 1)+relativedelta(yearday=260) datetime.date(2000, 9, 16) We can use the non-leap year day to ignore this: .. doctest:: relativedelta >>> date(2000, 1, 1)+relativedelta(nlyearday=260) datetime.date(2000, 9, 17) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/requirements-docs.txt0000644000175100001710000000010400000000000021352 0ustar00runnerdockerSphinx>=1.7.3,!=1.8.0 sphinx_rtd_theme>=0.3.0 readme-renderer>=21.0 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/rrule.rst0000644000175100001710000005052000000000000017032 0ustar00runnerdocker===== rrule ===== .. automodule:: dateutil.rrule :undoc-members: Classes ------- .. autoclass:: rrule :members: :undoc-members: :inherited-members: .. autoclass:: rruleset :members: :undoc-members: :inherited-members: Functions --------- .. autofunction:: rrulestr rrule examples -------------- These examples were converted from the RFC. Prepare the environment. .. testsetup:: rrule from dateutil.rrule import * from dateutil.parser import * from datetime import * import pprint import sys sys.displayhook = pprint.pprint .. doctest:: rrule >>> from dateutil.rrule import * >>> from dateutil.parser import * >>> from datetime import * >>> import pprint >>> import sys >>> sys.displayhook = pprint.pprint Daily, for 10 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(DAILY, count=10, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 3, 9, 0), datetime.datetime(1997, 9, 4, 9, 0), datetime.datetime(1997, 9, 5, 9, 0), datetime.datetime(1997, 9, 6, 9, 0), datetime.datetime(1997, 9, 7, 9, 0), datetime.datetime(1997, 9, 8, 9, 0), datetime.datetime(1997, 9, 9, 9, 0), datetime.datetime(1997, 9, 10, 9, 0), datetime.datetime(1997, 9, 11, 9, 0)] Daily until December 24, 1997 .. doctest:: rrule :options: +NORMALIZE_WHITESPACE, +ELLIPSIS >>> list(rrule(DAILY, ... dtstart=parse("19970902T090000"), ... until=parse("19971224T000000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 3, 9, 0), datetime.datetime(1997, 9, 4, 9, 0), ... datetime.datetime(1997, 12, 21, 9, 0), datetime.datetime(1997, 12, 22, 9, 0), datetime.datetime(1997, 12, 23, 9, 0)] Every other day, 5 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(DAILY, interval=2, count=5, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 4, 9, 0), datetime.datetime(1997, 9, 6, 9, 0), datetime.datetime(1997, 9, 8, 9, 0), datetime.datetime(1997, 9, 10, 9, 0)] Every 10 days, 5 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(DAILY, interval=10, count=5, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 12, 9, 0), datetime.datetime(1997, 9, 22, 9, 0), datetime.datetime(1997, 10, 2, 9, 0), datetime.datetime(1997, 10, 12, 9, 0)] Everyday in January, for 3 years. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE, +ELLIPSIS >>> list(rrule(YEARLY, bymonth=1, byweekday=range(7), ... dtstart=parse("19980101T090000"), ... until=parse("20000131T090000"))) [datetime.datetime(1998, 1, 1, 9, 0), datetime.datetime(1998, 1, 2, 9, 0), ... datetime.datetime(1998, 1, 30, 9, 0), datetime.datetime(1998, 1, 31, 9, 0), datetime.datetime(1999, 1, 1, 9, 0), datetime.datetime(1999, 1, 2, 9, 0), ... datetime.datetime(1999, 1, 30, 9, 0), datetime.datetime(1999, 1, 31, 9, 0), datetime.datetime(2000, 1, 1, 9, 0), datetime.datetime(2000, 1, 2, 9, 0), ... datetime.datetime(2000, 1, 30, 9, 0), datetime.datetime(2000, 1, 31, 9, 0)] Same thing, in another way. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE, +ELLIPSIS >>> list(rrule(DAILY, bymonth=1, ... dtstart=parse("19980101T090000"), ... until=parse("20000131T090000"))) [datetime.datetime(1998, 1, 1, 9, 0), ... datetime.datetime(2000, 1, 31, 9, 0)] Weekly for 10 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, count=10, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 9, 9, 0), datetime.datetime(1997, 9, 16, 9, 0), datetime.datetime(1997, 9, 23, 9, 0), datetime.datetime(1997, 9, 30, 9, 0), datetime.datetime(1997, 10, 7, 9, 0), datetime.datetime(1997, 10, 14, 9, 0), datetime.datetime(1997, 10, 21, 9, 0), datetime.datetime(1997, 10, 28, 9, 0), datetime.datetime(1997, 11, 4, 9, 0)] Every other week, 6 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, interval=2, count=6, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 16, 9, 0), datetime.datetime(1997, 9, 30, 9, 0), datetime.datetime(1997, 10, 14, 9, 0), datetime.datetime(1997, 10, 28, 9, 0), datetime.datetime(1997, 11, 11, 9, 0)] Weekly on Tuesday and Thursday for 5 weeks. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, count=10, wkst=SU, byweekday=(TU,TH), ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 4, 9, 0), datetime.datetime(1997, 9, 9, 9, 0), datetime.datetime(1997, 9, 11, 9, 0), datetime.datetime(1997, 9, 16, 9, 0), datetime.datetime(1997, 9, 18, 9, 0), datetime.datetime(1997, 9, 23, 9, 0), datetime.datetime(1997, 9, 25, 9, 0), datetime.datetime(1997, 9, 30, 9, 0), datetime.datetime(1997, 10, 2, 9, 0)] Every other week on Tuesday and Thursday, for 8 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, interval=2, count=8, ... wkst=SU, byweekday=(TU,TH), ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 4, 9, 0), datetime.datetime(1997, 9, 16, 9, 0), datetime.datetime(1997, 9, 18, 9, 0), datetime.datetime(1997, 9, 30, 9, 0), datetime.datetime(1997, 10, 2, 9, 0), datetime.datetime(1997, 10, 14, 9, 0), datetime.datetime(1997, 10, 16, 9, 0)] Monthly on the 1st Friday for ten occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, count=10, byweekday=FR(1), ... dtstart=parse("19970905T090000"))) [datetime.datetime(1997, 9, 5, 9, 0), datetime.datetime(1997, 10, 3, 9, 0), datetime.datetime(1997, 11, 7, 9, 0), datetime.datetime(1997, 12, 5, 9, 0), datetime.datetime(1998, 1, 2, 9, 0), datetime.datetime(1998, 2, 6, 9, 0), datetime.datetime(1998, 3, 6, 9, 0), datetime.datetime(1998, 4, 3, 9, 0), datetime.datetime(1998, 5, 1, 9, 0), datetime.datetime(1998, 6, 5, 9, 0)] Every other month on the 1st and last Sunday of the month for 10 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, interval=2, count=10, ... byweekday=(SU(1), SU(-1)), ... dtstart=parse("19970907T090000"))) [datetime.datetime(1997, 9, 7, 9, 0), datetime.datetime(1997, 9, 28, 9, 0), datetime.datetime(1997, 11, 2, 9, 0), datetime.datetime(1997, 11, 30, 9, 0), datetime.datetime(1998, 1, 4, 9, 0), datetime.datetime(1998, 1, 25, 9, 0), datetime.datetime(1998, 3, 1, 9, 0), datetime.datetime(1998, 3, 29, 9, 0), datetime.datetime(1998, 5, 3, 9, 0), datetime.datetime(1998, 5, 31, 9, 0)] Monthly on the second to last Monday of the month for 6 months. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, count=6, byweekday=MO(-2), ... dtstart=parse("19970922T090000"))) [datetime.datetime(1997, 9, 22, 9, 0), datetime.datetime(1997, 10, 20, 9, 0), datetime.datetime(1997, 11, 17, 9, 0), datetime.datetime(1997, 12, 22, 9, 0), datetime.datetime(1998, 1, 19, 9, 0), datetime.datetime(1998, 2, 16, 9, 0)] Monthly on the third to the last day of the month, for 6 months. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, count=6, bymonthday=-3, ... dtstart=parse("19970928T090000"))) [datetime.datetime(1997, 9, 28, 9, 0), datetime.datetime(1997, 10, 29, 9, 0), datetime.datetime(1997, 11, 28, 9, 0), datetime.datetime(1997, 12, 29, 9, 0), datetime.datetime(1998, 1, 29, 9, 0), datetime.datetime(1998, 2, 26, 9, 0)] Monthly on the 2nd and 15th of the month for 5 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, count=5, bymonthday=(2,15), ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 15, 9, 0), datetime.datetime(1997, 10, 2, 9, 0), datetime.datetime(1997, 10, 15, 9, 0), datetime.datetime(1997, 11, 2, 9, 0)] Monthly on the first and last day of the month for 3 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, count=5, bymonthday=(-1,1,), ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 30, 9, 0), datetime.datetime(1997, 10, 1, 9, 0), datetime.datetime(1997, 10, 31, 9, 0), datetime.datetime(1997, 11, 1, 9, 0), datetime.datetime(1997, 11, 30, 9, 0)] Every 18 months on the 10th thru 15th of the month for 10 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, interval=18, count=10, ... bymonthday=range(10,16), ... dtstart=parse("19970910T090000"))) [datetime.datetime(1997, 9, 10, 9, 0), datetime.datetime(1997, 9, 11, 9, 0), datetime.datetime(1997, 9, 12, 9, 0), datetime.datetime(1997, 9, 13, 9, 0), datetime.datetime(1997, 9, 14, 9, 0), datetime.datetime(1997, 9, 15, 9, 0), datetime.datetime(1999, 3, 10, 9, 0), datetime.datetime(1999, 3, 11, 9, 0), datetime.datetime(1999, 3, 12, 9, 0), datetime.datetime(1999, 3, 13, 9, 0)] Every Tuesday, every other month, 6 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, interval=2, count=6, byweekday=TU, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 9, 9, 0), datetime.datetime(1997, 9, 16, 9, 0), datetime.datetime(1997, 9, 23, 9, 0), datetime.datetime(1997, 9, 30, 9, 0), datetime.datetime(1997, 11, 4, 9, 0)] Yearly in June and July for 10 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(YEARLY, count=4, bymonth=(6,7), ... dtstart=parse("19970610T090000"))) [datetime.datetime(1997, 6, 10, 9, 0), datetime.datetime(1997, 7, 10, 9, 0), datetime.datetime(1998, 6, 10, 9, 0), datetime.datetime(1998, 7, 10, 9, 0)] Every 3rd year on the 1st, 100th and 200th day for 4 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(YEARLY, count=4, interval=3, byyearday=(1,100,200), ... dtstart=parse("19970101T090000"))) [datetime.datetime(1997, 1, 1, 9, 0), datetime.datetime(1997, 4, 10, 9, 0), datetime.datetime(1997, 7, 19, 9, 0), datetime.datetime(2000, 1, 1, 9, 0)] Every 20th Monday of the year, 3 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(YEARLY, count=3, byweekday=MO(20), ... dtstart=parse("19970519T090000"))) [datetime.datetime(1997, 5, 19, 9, 0), datetime.datetime(1998, 5, 18, 9, 0), datetime.datetime(1999, 5, 17, 9, 0)] Monday of week number 20 (where the default start of the week is Monday), 3 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(YEARLY, count=3, byweekno=20, byweekday=MO, ... dtstart=parse("19970512T090000"))) [datetime.datetime(1997, 5, 12, 9, 0), datetime.datetime(1998, 5, 11, 9, 0), datetime.datetime(1999, 5, 17, 9, 0)] The week number 1 may be in the last year. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, count=3, byweekno=1, byweekday=MO, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 12, 29, 9, 0), datetime.datetime(1999, 1, 4, 9, 0), datetime.datetime(2000, 1, 3, 9, 0)] And the week numbers greater than 51 may be in the next year. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, count=3, byweekno=52, byweekday=SU, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 12, 28, 9, 0), datetime.datetime(1998, 12, 27, 9, 0), datetime.datetime(2000, 1, 2, 9, 0)] Only some years have week number 53: .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, count=3, byweekno=53, byweekday=MO, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1998, 12, 28, 9, 0), datetime.datetime(2004, 12, 27, 9, 0), datetime.datetime(2009, 12, 28, 9, 0)] Every Friday the 13th, 4 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(YEARLY, count=4, byweekday=FR, bymonthday=13, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1998, 2, 13, 9, 0), datetime.datetime(1998, 3, 13, 9, 0), datetime.datetime(1998, 11, 13, 9, 0), datetime.datetime(1999, 8, 13, 9, 0)] Every four years, the first Tuesday after a Monday in November, 3 occurrences (U.S. Presidential Election day): .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(YEARLY, interval=4, count=3, bymonth=11, ... byweekday=TU, bymonthday=(2,3,4,5,6,7,8), ... dtstart=parse("19961105T090000"))) [datetime.datetime(1996, 11, 5, 9, 0), datetime.datetime(2000, 11, 7, 9, 0), datetime.datetime(2004, 11, 2, 9, 0)] The 3rd instance into the month of one of Tuesday, Wednesday or Thursday, for the next 3 months: .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, count=3, byweekday=(TU,WE,TH), ... bysetpos=3, dtstart=parse("19970904T090000"))) [datetime.datetime(1997, 9, 4, 9, 0), datetime.datetime(1997, 10, 7, 9, 0), datetime.datetime(1997, 11, 6, 9, 0)] The 2nd to last weekday of the month, 3 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MONTHLY, count=3, byweekday=(MO,TU,WE,TH,FR), ... bysetpos=-2, dtstart=parse("19970929T090000"))) [datetime.datetime(1997, 9, 29, 9, 0), datetime.datetime(1997, 10, 30, 9, 0), datetime.datetime(1997, 11, 27, 9, 0)] Every 3 hours from 9:00 AM to 5:00 PM on a specific day. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(HOURLY, interval=3, ... dtstart=parse("19970902T090000"), ... until=parse("19970902T170000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 2, 12, 0), datetime.datetime(1997, 9, 2, 15, 0)] Every 15 minutes for 6 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MINUTELY, interval=15, count=6, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 2, 9, 15), datetime.datetime(1997, 9, 2, 9, 30), datetime.datetime(1997, 9, 2, 9, 45), datetime.datetime(1997, 9, 2, 10, 0), datetime.datetime(1997, 9, 2, 10, 15)] Every hour and a half for 4 occurrences. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(MINUTELY, interval=90, count=4, ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 2, 10, 30), datetime.datetime(1997, 9, 2, 12, 0), datetime.datetime(1997, 9, 2, 13, 30)] Every 20 minutes from 9:00 AM to 4:40 PM for two days. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE, +ELLIPSIS >>> list(rrule(MINUTELY, interval=20, count=48, ... byhour=range(9,17), byminute=(0,20,40), ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 2, 9, 20), ... datetime.datetime(1997, 9, 2, 16, 20), datetime.datetime(1997, 9, 2, 16, 40), datetime.datetime(1997, 9, 3, 9, 0), datetime.datetime(1997, 9, 3, 9, 20), ... datetime.datetime(1997, 9, 3, 16, 20), datetime.datetime(1997, 9, 3, 16, 40)] An example where the days generated makes a difference because of `wkst`. .. doctest:: rrule :options: +NORMALIZE_WHITESPACE >>> list(rrule(WEEKLY, interval=2, count=4, ... byweekday=(TU,SU), wkst=MO, ... dtstart=parse("19970805T090000"))) [datetime.datetime(1997, 8, 5, 9, 0), datetime.datetime(1997, 8, 10, 9, 0), datetime.datetime(1997, 8, 19, 9, 0), datetime.datetime(1997, 8, 24, 9, 0)] >>> list(rrule(WEEKLY, interval=2, count=4, ... byweekday=(TU,SU), wkst=SU, ... dtstart=parse("19970805T090000"))) [datetime.datetime(1997, 8, 5, 9, 0), datetime.datetime(1997, 8, 17, 9, 0), datetime.datetime(1997, 8, 19, 9, 0), datetime.datetime(1997, 8, 31, 9, 0)] rruleset examples ----------------- Daily, for 7 days, jumping Saturday and Sunday occurrences. .. testsetup:: rruleset import datetime from dateutil.parser import parse from dateutil.rrule import rrule, rruleset from dateutil.rrule import YEARLY, MONTHLY, WEEKLY, DAILY from dateutil.rrule import MO, TU, WE, TH, FR, SA, SU import pprint import sys sys.displayhook = pprint.pprint .. doctest:: rruleset :options: +NORMALIZE_WHITESPACE >>> set = rruleset() >>> set.rrule(rrule(DAILY, count=7, ... dtstart=parse("19970902T090000"))) >>> set.exrule(rrule(YEARLY, byweekday=(SA,SU), ... dtstart=parse("19970902T090000"))) >>> list(set) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 3, 9, 0), datetime.datetime(1997, 9, 4, 9, 0), datetime.datetime(1997, 9, 5, 9, 0), datetime.datetime(1997, 9, 8, 9, 0)] Weekly, for 4 weeks, plus one time on day 7, and not on day 16. .. doctest:: rruleset :options: +NORMALIZE_WHITESPACE >>> set = rruleset() >>> set.rrule(rrule(WEEKLY, count=4, ... dtstart=parse("19970902T090000"))) >>> set.rdate(datetime.datetime(1997, 9, 7, 9, 0)) >>> set.exdate(datetime.datetime(1997, 9, 16, 9, 0)) >>> list(set) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 7, 9, 0), datetime.datetime(1997, 9, 9, 9, 0), datetime.datetime(1997, 9, 23, 9, 0)] rrulestr() examples ------------------- Every 10 days, 5 occurrences. .. testsetup:: rrulestr from dateutil.parser import parse from dateutil.rrule import rruleset, rrulestr import pprint import sys sys.displayhook = pprint.pprint .. doctest:: rrulestr :options: +NORMALIZE_WHITESPACE >>> list(rrulestr(""" ... DTSTART:19970902T090000 ... RRULE:FREQ=DAILY;INTERVAL=10;COUNT=5 ... """)) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 12, 9, 0), datetime.datetime(1997, 9, 22, 9, 0), datetime.datetime(1997, 10, 2, 9, 0), datetime.datetime(1997, 10, 12, 9, 0)] Same thing, but passing only the `RRULE` value. .. doctest:: rrulestr :options: +NORMALIZE_WHITESPACE >>> list(rrulestr("FREQ=DAILY;INTERVAL=10;COUNT=5", ... dtstart=parse("19970902T090000"))) [datetime.datetime(1997, 9, 2, 9, 0), datetime.datetime(1997, 9, 12, 9, 0), datetime.datetime(1997, 9, 22, 9, 0), datetime.datetime(1997, 10, 2, 9, 0), datetime.datetime(1997, 10, 12, 9, 0)] Notice that when using a single rule, it returns an `rrule` instance, unless `forceset` was used. .. doctest:: rrulestr :options: +ELLIPSIS >>> rrulestr("FREQ=DAILY;INTERVAL=10;COUNT=5") >>> rrulestr(""" ... DTSTART:19970902T090000 ... RRULE:FREQ=DAILY;INTERVAL=10;COUNT=5 ... """) >>> rrulestr("FREQ=DAILY;INTERVAL=10;COUNT=5", forceset=True) But when an `rruleset` is needed, it is automatically used. .. doctest:: rrulestr :options: +ELLIPSIS >>> rrulestr(""" ... DTSTART:19970902T090000 ... RRULE:FREQ=DAILY;INTERVAL=10;COUNT=5 ... RRULE:FREQ=DAILY;INTERVAL=5;COUNT=3 ... """) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1658728 python-dateutil-2.8.2/docs/samples/0000755000175100001710000000000000000000000016611 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/samples/EST5EDT.ics0000644000175100001710000000062000000000000020364 0ustar00runnerdockerBEGIN:VTIMEZONE TZID:US-Eastern LAST-MODIFIED:19870101T000000Z TZURL:http://zones.stds_r_us.net/tz/US-Eastern BEGIN:STANDARD DTSTART:19671029T020000 RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=10 TZOFFSETFROM:-0400 TZOFFSETTO:-0500 TZNAME:EST END:STANDARD BEGIN:DAYLIGHT DTSTART:19870405T020000 RRULE:FREQ=YEARLY;BYDAY=1SU;BYMONTH=4 TZOFFSETFROM:-0500 TZOFFSETTO:-0400 TZNAME:EDT END:DAYLIGHT END:VTIMEZONE ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/tz.rst0000644000175100001710000000153100000000000016334 0ustar00runnerdocker== tz == .. py:currentmodule:: dateutil.tz .. automodule:: dateutil.tz Objects ------- .. py:data:: dateutil.tz.UTC A convenience instance of :class:`dateutil.tz.tzutc`. .. versionadded:: 2.7.0 Functions --------- .. autofunction:: gettz .. automethod:: gettz.nocache .. automethod:: gettz.cache_clear .. autofunction:: enfold .. autofunction:: datetime_ambiguous .. autofunction:: datetime_exists .. autofunction:: resolve_imaginary Classes ------- .. autoclass:: tzutc .. autoclass:: tzoffset .. autoclass:: tzlocal .. autoclass:: tzwinlocal :members: display, transitions .. note:: Only available on Windows .. autoclass:: tzrange .. autoclass:: tzstr .. autoclass:: tzical :members: .. autoclass:: tzwin :members: display, transitions, list .. note:: Only available on Windows ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/tzwin.rst0000644000175100001710000000047000000000000017053 0ustar00runnerdocker====== tz.win ====== .. py:currentmodule:: dateutil.tz.win .. automodule:: dateutil.tz.win Classes ------- .. autoclass:: tzres :members: .. autoclass:: tzwin :members: list, display, transitions :undoc-members: .. autoclass:: tzwinlocal :members: display, transitions :undoc-members: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/utils.rst0000644000175100001710000000012100000000000017031 0ustar00runnerdocker===== utils ===== .. automodule:: dateutil.utils :members: :undoc-members: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/docs/zoneinfo.rst0000644000175100001710000000101500000000000017523 0ustar00runnerdocker======== zoneinfo ======== .. automodule:: dateutil.zoneinfo :members: :undoc-members: .. automodule:: dateutil.zoneinfo.rebuild :members: rebuild zonefile_metadata ----------------- The zonefile metadata defines the version and exact location of the timezone database to download. It is used in the ``updatezinfo.py`` script. A json encoded file is included in the source-code, and within each tar file we produce. The json file is attached here: .. literalinclude:: ../zonefile_metadata.json :language: json ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/pyproject.toml0000644000175100001710000000215600000000000017135 0ustar00runnerdocker[build-system] requires = [ "setuptools; python_version != '3.3'", "setuptools<40.0; python_version == '3.3'", "wheel", "setuptools_scm" ] build-backend = "setuptools.build_meta" [tool.towncrier] package = "dateutil" package_dir = "dateutil" filename = "NEWS" directory = "changelog.d" title_format = "Version {version} ({project_date})" issue_format = "GH #{issue}" template = "changelog.d/template.rst" [[tool.towncrier.type]] directory = "data" name = "Data updates" showcontent = true [[tool.towncrier.type]] directory = "deprecations" name = "Deprecations" showcontent = true [[tool.towncrier.type]] directory = "feature" name = "Features" showcontent = true [[tool.towncrier.type]] directory = "bugfix" name = "Bugfixes" showcontent = true [[tool.towncrier.type]] directory = "doc" name = "Documentation changes" showcontent = true [[tool.towncrier.type]] directory = "misc" name = "Misc" showcontent = true ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1658728 python-dateutil-2.8.2/python_dateutil.egg-info/0000755000175100001710000000000000000000000021123 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250753.0 python-dateutil-2.8.2/python_dateutil.egg-info/PKG-INFO0000644000175100001710000001777700000000000022243 0ustar00runnerdockerMetadata-Version: 2.1 Name: python-dateutil Version: 2.8.2 Summary: Extensions to the standard Python datetime module Home-page: https://github.com/dateutil/dateutil Author: Gustavo Niemeyer Author-email: gustavo@niemeyer.net Maintainer: Paul Ganssle Maintainer-email: dateutil@python.org License: Dual License Project-URL: Documentation, https://dateutil.readthedocs.io/en/stable/ Project-URL: Source, https://github.com/dateutil/dateutil Platform: UNKNOWN Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: BSD License Classifier: License :: OSI Approved :: Apache Software License Classifier: Programming Language :: Python Classifier: Programming Language :: Python :: 2 Classifier: Programming Language :: Python :: 2.7 Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.3 Classifier: Programming Language :: Python :: 3.4 Classifier: Programming Language :: Python :: 3.5 Classifier: Programming Language :: Python :: 3.6 Classifier: Programming Language :: Python :: 3.7 Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Topic :: Software Development :: Libraries Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,>=2.7 Description-Content-Type: text/x-rst License-File: LICENSE dateutil - powerful extensions to datetime ========================================== |pypi| |support| |licence| |gitter| |readthedocs| |travis| |appveyor| |pipelines| |coverage| .. |pypi| image:: https://img.shields.io/pypi/v/python-dateutil.svg?style=flat-square :target: https://pypi.org/project/python-dateutil/ :alt: pypi version .. |support| image:: https://img.shields.io/pypi/pyversions/python-dateutil.svg?style=flat-square :target: https://pypi.org/project/python-dateutil/ :alt: supported Python version .. |travis| image:: https://img.shields.io/travis/dateutil/dateutil/master.svg?style=flat-square&label=Travis%20Build :target: https://travis-ci.org/dateutil/dateutil :alt: travis build status .. |appveyor| image:: https://img.shields.io/appveyor/ci/dateutil/dateutil/master.svg?style=flat-square&logo=appveyor :target: https://ci.appveyor.com/project/dateutil/dateutil :alt: appveyor build status .. |pipelines| image:: https://dev.azure.com/pythondateutilazure/dateutil/_apis/build/status/dateutil.dateutil?branchName=master :target: https://dev.azure.com/pythondateutilazure/dateutil/_build/latest?definitionId=1&branchName=master :alt: azure pipelines build status .. |coverage| image:: https://codecov.io/gh/dateutil/dateutil/branch/master/graphs/badge.svg?branch=master :target: https://codecov.io/gh/dateutil/dateutil?branch=master :alt: Code coverage .. |gitter| image:: https://badges.gitter.im/dateutil/dateutil.svg :alt: Join the chat at https://gitter.im/dateutil/dateutil :target: https://gitter.im/dateutil/dateutil .. |licence| image:: https://img.shields.io/pypi/l/python-dateutil.svg?style=flat-square :target: https://pypi.org/project/python-dateutil/ :alt: licence .. |readthedocs| image:: https://img.shields.io/readthedocs/dateutil/latest.svg?style=flat-square&label=Read%20the%20Docs :alt: Read the documentation at https://dateutil.readthedocs.io/en/latest/ :target: https://dateutil.readthedocs.io/en/latest/ The `dateutil` module provides powerful extensions to the standard `datetime` module, available in Python. Installation ============ `dateutil` can be installed from PyPI using `pip` (note that the package name is different from the importable name):: pip install python-dateutil Download ======== dateutil is available on PyPI https://pypi.org/project/python-dateutil/ The documentation is hosted at: https://dateutil.readthedocs.io/en/stable/ Code ==== The code and issue tracker are hosted on GitHub: https://github.com/dateutil/dateutil/ Features ======== * Computing of relative deltas (next month, next year, next Monday, last week of month, etc); * Computing of relative deltas between two given date and/or datetime objects; * Computing of dates based on very flexible recurrence rules, using a superset of the `iCalendar `_ specification. Parsing of RFC strings is supported as well. * Generic parsing of dates in almost any string format; * Timezone (tzinfo) implementations for tzfile(5) format files (/etc/localtime, /usr/share/zoneinfo, etc), TZ environment string (in all known formats), iCalendar format files, given ranges (with help from relative deltas), local machine timezone, fixed offset timezone, UTC timezone, and Windows registry-based time zones. * Internal up-to-date world timezone information based on Olson's database. * Computing of Easter Sunday dates for any given year, using Western, Orthodox or Julian algorithms; * A comprehensive test suite. Quick example ============= Here's a snapshot, just to give an idea about the power of the package. For more examples, look at the documentation. Suppose you want to know how much time is left, in years/months/days/etc, before the next easter happening on a year with a Friday 13th in August, and you want to get today's date out of the "date" unix system command. Here is the code: .. code-block:: python3 >>> from dateutil.relativedelta import * >>> from dateutil.easter import * >>> from dateutil.rrule import * >>> from dateutil.parser import * >>> from datetime import * >>> now = parse("Sat Oct 11 17:13:46 UTC 2003") >>> today = now.date() >>> year = rrule(YEARLY,dtstart=now,bymonth=8,bymonthday=13,byweekday=FR)[0].year >>> rdelta = relativedelta(easter(year), today) >>> print("Today is: %s" % today) Today is: 2003-10-11 >>> print("Year with next Aug 13th on a Friday is: %s" % year) Year with next Aug 13th on a Friday is: 2004 >>> print("How far is the Easter of that year: %s" % rdelta) How far is the Easter of that year: relativedelta(months=+6) >>> print("And the Easter of that year is: %s" % (today+rdelta)) And the Easter of that year is: 2004-04-11 Being exactly 6 months ahead was **really** a coincidence :) Contributing ============ We welcome many types of contributions - bug reports, pull requests (code, infrastructure or documentation fixes). For more information about how to contribute to the project, see the ``CONTRIBUTING.md`` file in the repository. Author ====== The dateutil module was written by Gustavo Niemeyer in 2003. It is maintained by: * Gustavo Niemeyer 2003-2011 * Tomi Pieviläinen 2012-2014 * Yaron de Leeuw 2014-2016 * Paul Ganssle 2015- Starting with version 2.4.1 and running until 2.8.2, all source and binary distributions will be signed by a PGP key that has, at the very least, been signed by the key which made the previous release. A table of release signing keys can be found below: =========== ============================ Releases Signing key fingerprint =========== ============================ 2.4.1-2.8.2 `6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB`_ =========== ============================ New releases *may* have signed tags, but binary and source distributions uploaded to PyPI will no longer have GPG signatures attached. Contact ======= Our mailing list is available at `dateutil@python.org `_. As it is hosted by the PSF, it is subject to the `PSF code of conduct `_. License ======= All contributions after December 1, 2017 released under dual license - either `Apache 2.0 License `_ or the `BSD 3-Clause License `_. Contributions before December 1, 2017 - except those those explicitly relicensed - are released only under the BSD 3-Clause License. .. _6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB: https://pgp.mit.edu/pks/lookup?op=vindex&search=0xCD54FCE3D964BEFB ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250753.0 python-dateutil-2.8.2/python_dateutil.egg-info/SOURCES.txt0000644000175100001710000000415500000000000023014 0ustar00runnerdocker.gitattributes .gitignore .travis.yml AUTHORS.md CONTRIBUTING.md LICENSE MANIFEST.in NEWS README.rst RELEASING appveyor.yml azure-pipelines.yml codecov.yml pyproject.toml requirements-dev.txt setup.cfg setup.py tox.ini updatezinfo.py zonefile_metadata.json .github/pull_request_template.md .github/workflows/publish.yml .github/workflows/validate.yml changelog.d/.gitignore changelog.d/template.rst ci_tools/make_zonefile_metadata.py ci_tools/retry.bat ci_tools/retry.sh ci_tools/run_tz_master_env.sh dateutil/__init__.py dateutil/_common.py dateutil/_version.py dateutil/easter.py dateutil/relativedelta.py dateutil/rrule.py dateutil/tzwin.py dateutil/utils.py dateutil/parser/__init__.py dateutil/parser/_parser.py dateutil/parser/isoparser.py dateutil/test/__init__.py dateutil/test/_common.py dateutil/test/conftest.py dateutil/test/test_easter.py dateutil/test/test_import_star.py dateutil/test/test_imports.py dateutil/test/test_internals.py dateutil/test/test_isoparser.py dateutil/test/test_parser.py dateutil/test/test_relativedelta.py dateutil/test/test_rrule.py dateutil/test/test_tz.py dateutil/test/test_utils.py dateutil/test/property/test_isoparse_prop.py dateutil/test/property/test_parser_prop.py dateutil/test/property/test_tz_prop.py dateutil/tz/__init__.py dateutil/tz/_common.py dateutil/tz/_factories.py dateutil/tz/tz.py dateutil/tz/win.py dateutil/zoneinfo/__init__.py dateutil/zoneinfo/dateutil-zoneinfo.tar.gz dateutil/zoneinfo/rebuild.py docs/Makefile docs/changelog.rst docs/conf.py docs/easter.rst docs/examples.rst docs/index.rst docs/make.bat docs/parser.rst docs/relativedelta.rst docs/requirements-docs.txt docs/rrule.rst docs/tz.rst docs/tzwin.rst docs/utils.rst docs/zoneinfo.rst docs/exercises/index.rst docs/exercises/solutions/mlk-day-rrule.rst docs/exercises/solutions/mlk_day_rrule_solution.py docs/samples/EST5EDT.ics python_dateutil.egg-info/PKG-INFO python_dateutil.egg-info/SOURCES.txt python_dateutil.egg-info/dependency_links.txt python_dateutil.egg-info/requires.txt python_dateutil.egg-info/top_level.txt python_dateutil.egg-info/zip-safe requirements/3.3/constraints.txt requirements/3.3/requirements-dev.txt././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250753.0 python-dateutil-2.8.2/python_dateutil.egg-info/dependency_links.txt0000644000175100001710000000000100000000000025171 0ustar00runnerdocker ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250753.0 python-dateutil-2.8.2/python_dateutil.egg-info/requires.txt0000644000175100001710000000001100000000000023513 0ustar00runnerdockersix>=1.5 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250753.0 python-dateutil-2.8.2/python_dateutil.egg-info/top_level.txt0000644000175100001710000000001100000000000023645 0ustar00runnerdockerdateutil ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250717.0 python-dateutil-2.8.2/python_dateutil.egg-info/zip-safe0000644000175100001710000000000100000000000022553 0ustar00runnerdocker ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1578727 python-dateutil-2.8.2/requirements/0000755000175100001710000000000000000000000016740 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1658728 python-dateutil-2.8.2/requirements/3.3/0000755000175100001710000000000000000000000017243 5ustar00runnerdocker././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/requirements/3.3/constraints.txt0000644000175100001710000000034300000000000022353 0ustar00runnerdockerattrs==18.2.0 colorama==0.3.9 coverage==4.5.3 enum34==1.1.6 freezegun==0.3.10 hypothesis==3.30.4 pip==10.0.1 pluggy==0.5.2 py==1.4.34 pytest==3.2.5 pytest-cov==2.5.1 setuptools==39.2.0 six==1.12.0 tox==2.9.1 virtualenv==15.2.0 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/requirements/3.3/requirements-dev.txt0000644000175100001710000000016600000000000023306 0ustar00runnerdockervirtualenv<16.0 setuptools<40.0 tox<3.8.0 pytest<3.3 freezegun<0.3.11 hypothesis >= 3.30 coverage pytest-cov >= 2.0.0 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/requirements-dev.txt0000644000175100001710000000032400000000000020254 0ustar00runnerdockersix pytest >= 3.0; python_version != '3.3' pytest-cov >= 2.0.0 freezegun ; python_version != '3.3' hypothesis >= 3.30 coverage mock ; python_version < '3.0' build >= 0.3.0 ; python_version >= '3.6' attrs!=21.1.0 ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1626250753.1658728 python-dateutil-2.8.2/setup.cfg0000644000175100001710000000346200000000000016043 0ustar00runnerdocker[bdist_wheel] universal = 1 [metadata] name = python-dateutil description = Extensions to the standard Python datetime module author = Gustavo Niemeyer author_email = gustavo@niemeyer.net maintainer = Paul Ganssle maintainer_email = dateutil@python.org url = https://github.com/dateutil/dateutil project_urls = Documentation = https://dateutil.readthedocs.io/en/stable/ Source = https://github.com/dateutil/dateutil long_description_content_type = text/x-rst license = Dual License license_file = LICENSE classifiers = Development Status :: 5 - Production/Stable Intended Audience :: Developers License :: OSI Approved :: BSD License License :: OSI Approved :: Apache Software License Programming Language :: Python Programming Language :: Python :: 2 Programming Language :: Python :: 2.7 Programming Language :: Python :: 3 Programming Language :: Python :: 3.3 Programming Language :: Python :: 3.4 Programming Language :: Python :: 3.5 Programming Language :: Python :: 3.6 Programming Language :: Python :: 3.7 Programming Language :: Python :: 3.8 Programming Language :: Python :: 3.9 Topic :: Software Development :: Libraries [options] zip_safe = True setup_requires = setuptools_scm install_requires = six >= 1.5 python_requires = >=2.7, !=3.0.*, !=3.1.*, !=3.2.* packages = find: test_suite = dateutil.test [options.packages.find] exclude = dateutil.test [options.package_data] dateutil.zoneinfo = dateutil-zoneinfo.tar.gz [sdist] formats = gztar [tool:pytest] python_files = test_*.py *_test.py *_solution.py xfail_strict = true filterwarnings = error error::DeprecationWarning error::PendingDeprecationWarning markers = gettz import_star isoparser parserinfo rrule rruleset rrulestr smoke tz_resolve_imaginary tzfile tzlocal tzoffset tzstr [egg_info] tag_build = tag_date = 0 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/setup.py0000644000175100001710000000253300000000000015732 0ustar00runnerdocker#!/usr/bin/python from os.path import isfile import os import setuptools from setuptools import setup, find_packages from setuptools.command.test import test as TestCommand from distutils.version import LooseVersion import warnings import io import sys if isfile("MANIFEST"): os.unlink("MANIFEST") if LooseVersion(setuptools.__version__) <= LooseVersion("24.3"): warnings.warn("python_requires requires setuptools version > 24.3", UserWarning) class Unsupported(TestCommand): def run(self): sys.stderr.write("Running 'test' with setup.py is not supported. " "Use 'pytest' or 'tox' to run the tests.\n") sys.exit(1) ### # Load metadata def README(): with io.open('README.rst', encoding='utf-8') as f: readme_lines = f.readlines() # The .. doctest directive is not supported by PyPA lines_out = [] for line in readme_lines: if line.startswith('.. doctest'): lines_out.append('.. code-block:: python3\n') else: lines_out.append(line) return ''.join(lines_out) README = README() # NOQA setup( use_scm_version={ 'write_to': 'dateutil/_version.py', }, ## Needed since doctest not supported by PyPA. long_description = README, cmdclass={ "test": Unsupported } ) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/tox.ini0000644000175100001710000000716200000000000015536 0ustar00runnerdocker[tox] envlist = py27, py33, py34, py35, py36, py37, pypy, pypy3, coverage, docs minversion = 2.9.0 skip_missing_interpreters = true isolated_build = true [testenv:.package] # no additional dependencies besides PEP 517 for building the package # Needed as we are running with an old version of tox. deps = [testenv] description = run the unit tests with pytest under {basepython} setenv = COVERAGE_FILE={toxworkdir}/.coverage.{envname} passenv = DATEUTIL_MAY_CHANGE_TZ TOXENV CI TRAVIS TRAVIS_* APPVEYOR APPVEYOR_* CODECOV_* SYSTEM_* AGENT_* BUILD_* TF_BUILD commands = python -m pytest {posargs: "{toxinidir}/dateutil/test" "{toxinidir}/docs" --cov-config="{toxinidir}/tox.ini" --cov=dateutil} deps = -rrequirements-dev.txt [testenv:py33] description = run the unit tests with pytest under Python 3.3 setenv = COVERAGE_FILE={toxworkdir}/.coverage.{envname} passenv = DATEUTIL_MAY_CHANGE_TZ TOXENV CI TRAVIS TRAVIS_* APPVEYOR APPVEYOR_* CODECOV_* SYSTEM_* AGENT_* BUILD_* TF_BUILD commands = python -m pytest {posargs: "{toxinidir}/dateutil/test" "{toxinidir}/docs" --cov-config="{toxinidir}/tox.ini" --cov=dateutil} deps = -rrequirements/3.3/requirements-dev.txt -crequirements/3.3/constraints.txt [testenv:coverage] description = combine coverage data and create reports deps = coverage skip_install = True changedir = {toxworkdir} setenv = COVERAGE_FILE=.coverage commands = python -m coverage erase python -m coverage combine python -m coverage report --rcfile={toxinidir}/tox.ini python -m coverage xml [testenv:codecov] description = [only run on CI]: upload coverage data to codecov (depends on coverage running first) deps = codecov skip_install = True commands = python -m codecov --file {toxworkdir}/coverage.xml [testenv:dev] description = DEV environment usedevelop = True commands = python -m pip list --format=columns python -c 'import sys; print(sys.executable)' [coverage:run] source = dateutil [coverage:report] skip_covered = True show_missing = True [testenv:tz] # Warning: This will modify the repository and is only intended to be run # as part of the CI process, not locally. description = Run the tests against the master of the tz database basepython = python3.6 deps = -r {toxinidir}/requirements-dev.txt setenv = DATEUTIL_TZPATH = {envtmpdir}/tzdir/usr/share/zoneinfo changedir = {toxworkdir} commands = {toxinidir}/ci_tools/run_tz_master_env.sh {envtmpdir} {toxinidir} [testenv:docs] description = invoke sphinx-build to build the HTML docs, check that URIs are valid basepython = python3.6 deps = -r docs/requirements-docs.txt {[testenv]deps} commands = sphinx-build -d "{toxworkdir}/docs_doctree" docs "{toxworkdir}/docs_out" {posargs:-W --color -bhtml} sphinx-build -d "{toxworkdir}/docs_doctree" docs "{toxworkdir}/docs_out" {posargs:-W --color -blinkcheck} python setup.py check -r -s [testenv:news] description = Invoke towncrier to update the NEWS file basepython = python3.7 passenv = * deps = towncrier commands = towncrier {posargs} [testenv:build] description = Build an sdist and bdist basepython = python3.9 skip_install = true passenv = * deps = build[virtualenv] >= 0.3.0 commands = python -m build --wheel --sdist --outdir dist . [testenv:release] description = Make a release; must be called after "build" skip_install = True deps = twine depends = build passenv = TWINE_* commands = twine check {toxinidir}/dist/* twine upload {toxinidir}/dist/* \ {posargs:-r {env:TWINE_REPOSITORY:testpypi} --non-interactive} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/updatezinfo.py0000644000175100001710000000361700000000000017126 0ustar00runnerdocker#!/usr/bin/env python import os import hashlib import json import io from six.moves.urllib import request from six.moves.urllib import error as urllib_error from dateutil.zoneinfo import rebuild METADATA_FILE = "zonefile_metadata.json" def main(metadata_file): with io.open(metadata_file, 'r') as f: metadata = json.load(f) releases_urls = metadata['releases_url'] if metadata['metadata_version'] < 2.0: # In later versions the releases URL is a mirror URL releases_urls = [releases_urls] if not os.path.isfile(metadata['tzdata_file']): for ii, releases_url in enumerate(releases_urls): print("Downloading tz file from mirror {ii}".format(ii=ii)) try: request.urlretrieve(os.path.join(releases_url, metadata['tzdata_file']), metadata['tzdata_file']) except urllib_error.URLError as e: print("Download failed, trying next mirror.") last_error = e continue last_error = None break if last_error is not None: raise last_error with open(metadata['tzdata_file'], 'rb') as tzfile: sha_hasher = hashlib.sha512() sha_hasher.update(tzfile.read()) sha_512_file = sha_hasher.hexdigest() assert metadata['tzdata_file_sha512'] == sha_512_file, "SHA failed for" print("Updating timezone information...") rebuild.rebuild(metadata['tzdata_file'], zonegroups=metadata['zonegroups'], metadata=metadata) print("Done.") if __name__ == "__main__": import argparse parser = argparse.ArgumentParser() parser.add_argument('metadata', metavar='METADATA_FILE', default=METADATA_FILE, nargs='?') args = parser.parse_args() main(args.metadata) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1626250707.0 python-dateutil-2.8.2/zonefile_metadata.json0000644000175100001710000000116700000000000020570 0ustar00runnerdocker{ "metadata_version": 2.0, "releases_url": [ "https://dateutil.github.io/tzdata/tzdata/", "ftp://ftp.iana.org/tz/releases/" ], "tzdata_file": "tzdata2021a.tar.gz", "tzdata_file_sha512": "7cdd762ec90ce12a30fa36b1d66d1ea82d9fa21e514e2b9c7fcbe2541514ee0fadf30843ff352c65512fb270857b51d1517b45e1232b89c6f954ba9ff1833bb3", "tzversion": "2021a", "zonegroups": [ "africa", "antarctica", "asia", "australasia", "europe", "northamerica", "southamerica", "etcetera", "factory", "backzone", "backward" ] }