dateutilx 0.1.0__tar.gz → 0.2.0__tar.gz

{dateutilx-0.1.0 → dateutilx-0.2.0}/.gitignore

@@ -13,7 +13,7 @@ dist/
 .tox/
 .pytest_cache/
 venv/
-.venv/
+.venv*/
 .hypothesis/
 .coverage
 

dateutilx-0.2.0/LICENSE

@@ -0,0 +1,58 @@
+Copyright 2017- Paul Ganssle <paul@ganssle.io>
+Copyright 2017- dateutil contributors (see AUTHORS file)
+Copyright 2026- Rishabh B
+Copyright 2026- dateutilx 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).
+--------------------------------------------------------------------------------
+dateutilx - Extensions to the standard Python datetime module.
+
+Copyright (c) 2003-2011 - Gustavo Niemeyer <gustavo@niemeyer.net>
+Copyright (c) 2012-2014 - Tomi Pieviläinen <tomi.pievilainen@iki.fi>
+Copyright (c) 2014-2016 - Yaron de Leeuw <me@jarondl.net>
+Copyright (c) 2015-2026 - Paul Ganssle <paul@ganssle.io>
+Copyright (c) 2015-2026 - dateutil contributors (see AUTHORS file)
+Copyright (c) 2026-     - Rishabh B <>
+Copyright (c) 2026-     - dateutilx 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.

dateutilx-0.2.0/PKG-INFO

@@ -0,0 +1,191 @@
+Metadata-Version: 2.4
+Name: dateutilx
+Version: 0.2.0
+Summary: Modern extension to the standard Python datetime module
+Project-URL: Homepage, https://github.com/rsb-23/dateutilx
+Project-URL: Documentation, https://dateutilx.readthedocs.io/en/stable/
+Project-URL: Source, https://github.com/rsb-23/dateutilx
+Author: Rishabh B
+License: Copyright 2017- Paul Ganssle <paul@ganssle.io>
+        Copyright 2017- dateutil contributors (see AUTHORS file)
+        Copyright 2026- Rishabh B
+        Copyright 2026- dateutilx 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).
+        --------------------------------------------------------------------------------
+        dateutilx - Extensions to the standard Python datetime module.
+        
+        Copyright (c) 2003-2011 - Gustavo Niemeyer <gustavo@niemeyer.net>
+        Copyright (c) 2012-2014 - Tomi Pieviläinen <tomi.pievilainen@iki.fi>
+        Copyright (c) 2014-2016 - Yaron de Leeuw <me@jarondl.net>
+        Copyright (c) 2015-2026 - Paul Ganssle <paul@ganssle.io>
+        Copyright (c) 2015-2026 - dateutil contributors (see AUTHORS file)
+        Copyright (c) 2026-     - Rishabh B <>
+        Copyright (c) 2026-     - dateutilx 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.
+License-File: LICENSE
+Keywords: date,datetime,dateutil,time,timezone
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Requires-Dist: tzdata; sys_platform == 'win32'
+Description-Content-Type: text/markdown
+
+> [!NOTE]
+> This package is rewrite of `python-dateutil v2.9.0.post0` as base, to support active python versions only.  
+> It is not related with the base project and its authors.  
+> Docs of base project are under `.base_project/`
+
+# dateutilx - powerful extensions to datetime
+
+|                |                                                                                             |
+|----------------|---------------------------------------------------------------------------------------------|
+| Compatibility  | ![Py-Version]                                                                               |
+| Quality Checks | [![lint check][lint-badge]]() [![tests][tests-badge]]() [![pre-commit][pre-commit-badge]]() |
+| Package        | ![pypi-v] ![pypi-downloads]                                                                 |
+| MetaData       | [![license-badge]][license]                                                                 |                                                                                                                                                                                           
+
+The `dateutilx` module provides powerful extensions to the standard `datetime` module, available in Python.
+
+## Installation
+
+`dateutilx` can be installed from PyPI using `pip`
+
+```
+pip install dateutilx
+```
+
+## Download
+
+dateutilx is available on PyPI
+https://pypi.org/project/dateutilx/
+
+The documentation is hosted at:
+https://dateutilx.readthedocs.io/en/stable/
+
+## Code
+
+The code and issue tracker are hosted on GitHub:
+https://github.com/rsb-23/dateutilx/
+
+## 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](https://www.ietf.org/rfc/rfc2445.txt) 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:
+
+```pycon
+>>> from datetime import *
+>>> from dateutilx.easter import *
+>>> from dateutilx.parser import *
+>>> from dateutilx.relativedelta import RelativeDelta
+>>> from dateutilx.rrule 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 dateutilx module is improved/re-written by rsb-23 in 2026.
+
+## License
+
+All contributions after December 1, 2017 released under dual license -
+either [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0) or
+the [BSD 3-Clause License](https://opensource.org/licenses/BSD-3-Clause). Contributions before December 1, 2017 - except
+those those explicitly relicensed - are released only under the BSD 3-Clause License.
+
+
+[license]: https://github.com/rsb-23/dateutilx/blob/main/LICENSE
+[lint-badge]: https://github.com/rsb-23/dateutilx/actions/workflows/code-lint.yml/badge.svg
+[tests-badge]: https://github.com/rsb-23/dateutilx/actions/workflows/code-test.yml/badge.svg
+
+[license-badge]: https://img.shields.io/pypi/l/dateutilx.svg?style=flat-square
+[pre-commit-badge]: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white
+[py-version]: https://img.shields.io/pypi/pyversions/dateutilx
+[pypi-downloads]: https://img.shields.io/pypi/dm/dateutilx?label=Downloads
+[pypi-v]: https://img.shields.io/pypi/v/dateutilx?label=pypi

dateutilx-0.2.0/README.md

@@ -0,0 +1,107 @@
+> [!NOTE]
+> This package is rewrite of `python-dateutil v2.9.0.post0` as base, to support active python versions only.  
+> It is not related with the base project and its authors.  
+> Docs of base project are under `.base_project/`
+
+# dateutilx - powerful extensions to datetime
+
+|                |                                                                                             |
+|----------------|---------------------------------------------------------------------------------------------|
+| Compatibility  | ![Py-Version]                                                                               |
+| Quality Checks | [![lint check][lint-badge]]() [![tests][tests-badge]]() [![pre-commit][pre-commit-badge]]() |
+| Package        | ![pypi-v] ![pypi-downloads]                                                                 |
+| MetaData       | [![license-badge]][license]                                                                 |                                                                                                                                                                                           
+
+The `dateutilx` module provides powerful extensions to the standard `datetime` module, available in Python.
+
+## Installation
+
+`dateutilx` can be installed from PyPI using `pip`
+
+```
+pip install dateutilx
+```
+
+## Download
+
+dateutilx is available on PyPI
+https://pypi.org/project/dateutilx/
+
+The documentation is hosted at:
+https://dateutilx.readthedocs.io/en/stable/
+
+## Code
+
+The code and issue tracker are hosted on GitHub:
+https://github.com/rsb-23/dateutilx/
+
+## 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](https://www.ietf.org/rfc/rfc2445.txt) 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:
+
+```pycon
+>>> from datetime import *
+>>> from dateutilx.easter import *
+>>> from dateutilx.parser import *
+>>> from dateutilx.relativedelta import RelativeDelta
+>>> from dateutilx.rrule 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 dateutilx module is improved/re-written by rsb-23 in 2026.
+
+## License
+
+All contributions after December 1, 2017 released under dual license -
+either [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0) or
+the [BSD 3-Clause License](https://opensource.org/licenses/BSD-3-Clause). Contributions before December 1, 2017 - except
+those those explicitly relicensed - are released only under the BSD 3-Clause License.
+
+
+[license]: https://github.com/rsb-23/dateutilx/blob/main/LICENSE
+[lint-badge]: https://github.com/rsb-23/dateutilx/actions/workflows/code-lint.yml/badge.svg
+[tests-badge]: https://github.com/rsb-23/dateutilx/actions/workflows/code-test.yml/badge.svg
+
+[license-badge]: https://img.shields.io/pypi/l/dateutilx.svg?style=flat-square
+[pre-commit-badge]: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white
+[py-version]: https://img.shields.io/pypi/pyversions/dateutilx
+[pypi-downloads]: https://img.shields.io/pypi/dm/dateutilx?label=Downloads
+[pypi-v]: https://img.shields.io/pypi/v/dateutilx?label=pypi

{dateutilx-0.1.0 → dateutilx-0.2.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 name = "dateutilx"
 dynamic = ["version"]
 description = "Modern extension to the standard Python datetime module"
-readme = "README.rst"
+readme = "README.md"
 license = { file = "LICENSE" }
 authors = [{ name = "Rishabh B" }]
 
@@ -18,7 +18,6 @@ classifiers = [
     "License :: OSI Approved :: Apache Software License",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
@@ -27,7 +26,7 @@ classifiers = [
     "Topic :: Software Development :: Libraries",
 ]
 
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 dependencies = ["tzdata; sys_platform == 'win32'"]
 
 [dependency-groups]
@@ -37,21 +36,22 @@ test = ["hypothesis", "pytest", "pytest-cov"]
 
 [project.urls]
 Homepage = "https://github.com/rsb-23/dateutilx"
-Documentation = "https://dateutil.readthedocs.io/en/stable/"
+Documentation = "https://dateutilx.readthedocs.io/en/stable/"
 Source = "https://github.com/rsb-23/dateutilx"
 
 # Build Config
 [tool.hatch.version]
 source = "vcs"
 [tool.hatch.build.targets.sdist]
-include = ["src/dateutilx", "src/dateutil", "LICENSE", "README.md", "pyproject.toml"]
+include = ["src", "LICENSE", "README.md", "pyproject.toml"]
 [tool.hatch.build.targets.wheel]
-packages = ["src/dateutilx", "src/dateutil"]
+packages = ["src"]
 
+[tool.coverage.run]
+source = ["src"]
 [tool.coverage.report]
 fail_under = 85.0
-[tool.coverage.run]
-source = ["src/"]
+skip_covered = true
 
 [tool.pytest.ini_options]
 python_files = ["test_*.py", "*_test.py", "*_solution.py", ]

{dateutilx-0.1.0/src/dateutilx → dateutilx-0.2.0/src}/easter.py

@@ -66,7 +66,7 @@ def easter(year, method: EasterAlgo | int = EasterAlgo.WESTERN):
     # e - Extra days to add for method 2 (converting Julian
     #     date to Gregorian date)
 
-    y = year
+    y = int(year)
     g = y % 19
     e = 0
     if method < 3:
@@ -90,4 +90,4 @@ def easter(year, method: EasterAlgo | int = EasterAlgo.WESTERN):
     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))
+    return datetime.date(y, m, d)

dateutilx-0.2.0/src/helper/__init__.py

@@ -0,0 +1,4 @@
+from .constants import Day, Frequency, Month
+from .funcs import is_windows_os
+
+__all__ = ["Day", "Frequency", "Month", "is_windows_os"]

{dateutilx-0.1.0/src/dateutilx → dateutilx-0.2.0/src}/helper/constants.py

@@ -1,12 +1,7 @@
 import calendar
-import sys
 from enum import IntEnum
 
 
-def is_windows_os() -> bool:
-    return sys.platform.startswith("win")
-
-
 class Frequency(IntEnum):
     YEARLY = 0
     MONTHLY = 1

dateutilx-0.2.0/src/helper/funcs.py

@@ -0,0 +1,5 @@
+import sys
+
+
+def is_windows_os() -> bool:
+    return sys.platform.startswith("win")