infdate 0.2.4__tar.gz → 0.2.5__tar.gz

{infdate-0.2.4 → infdate-0.2.5}/.gitlab-ci.yml

@@ -12,7 +12,7 @@ include:
   - component: $CI_SERVER_FQDN/blackstream-x/generic-components/meta-gitlab-security@~latest
   - component: $CI_SERVER_FQDN/blackstream-x/python-components/meta-uv-pipeline@feature/uv-version
     inputs:
-      uv-version: "0.7.13"
+      uv-version: "0.7.17"
       mypy-args: "--exclude tools/"
       python-version: "3.13"
       python-variant: "alpine"

{infdate-0.2.4 → infdate-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: infdate
-Version: 0.2.4
+Version: 0.2.5
 Summary: Date object wrapper supporting infinity
 Project-URL: Homepage, https://gitlab.com/blackstream-x/infdate
 Project-URL: CI, https://gitlab.com/blackstream-x/infdate/-/pipelines
@@ -49,10 +49,10 @@ contain the two possible **InfinityDate** instance variations.
 The module -level constants **REAL_MIN** and **REAL_MAX** are the eqivalents
 of **datetime.date.min** and **datetime.date.max** as **RealDate** instances.
 
-For any valid **RealDate** instance, the following is **True**:
+For any **RealDate** instance, the following is **True**:
 
 ``` python
-infdate.MIN < infdate.REAL_MIN <= real_date_instance <= infdate.REAL_MAX < infdate.MAX
+infdate.INFINITE_PAST < infdate.REAL_MIN <= real_date_instance <= infdate.REAL_MAX < infdate.INFINITE_FUTURE
 ```
 
 ### Module-level constants
@@ -61,8 +61,8 @@ infdate.MIN < infdate.REAL_MIN <= real_date_instance <= infdate.REAL_MAX < infda
 *   **INFINITE_FUTURE** = **InfinityDate(**_past_bound_=`False`**)** → infinity after any date
 *   **MIN** = **INFINITE_PAST**
 *   **MAX** = **INFINITE_FUTURE**
-*   **REAL_MIN** = **RealDate(**_`1`, `1`, `1`_**)** → the same date as **datetime.date.min**
-*   **REAL_MAX** = **RealDate(**_`9999`, `12`, `31`_**)** → the same date as **datetime.date.max**
+*   **REAL_MIN** = **RealDate(**`1`, `1`, `1`**)** → the same date as **datetime.date.min**
+*   **REAL_MAX** = **RealDate(**`9999`, `12`, `31`**)** → the same date as **datetime.date.max**
 *   **MIN_ORDINAL** = `1` → the same value as **datetime.date.min.toordinal()**
 *   **MAX_ORDINAL** = `3652059` → the same value as **datetime.date.max.toordinal()**
 *   **RESOLUTION** = `1` → represents the lowest possible date difference: _one day_
@@ -109,8 +109,17 @@ Some notable difference from the **datetime.date** class, mainly due to the desi
     from an **InfinityDate** or **RealDate**, only **float** or **int**
     (support for adding and subtracting datetime.timedelta instances might be added in the future, [see the feature request]).
 
-*   infdate module classes have a **.pretty()** method that can be used to format **RealDate** instances with a format string like **.strftime()** (provided with the _fmt_ argument that defaults to the ISO format `%Y-%m-%d`),
-    or to apply a custom format to **InfinityDate** classes using the _inf_common_prefix_, _inf_past_suffix_ and _inf_future_suffix_ arguments.
+
+### Additional methods
+
+*   **.pretty()** can be used to format **RealDate** instances with a format string like **.strftime()** (provided with the _fmt_ argument that defaults to the ISO format `%Y-%m-%d`),
+    or to apply a custom format to **InfinityDate** classes using the _inf_common_prefix_, _inf_past_suffix_, and _inf_future_suffix_ arguments.
+
+*   **.tonative()** is the inverse function of   the **fromnative()** constructor, returning a value tha can be used e.g. as a value for an API.
+
+    For **InfinityDate** instances, it returns the **.toordinal()** result if the _exact_ argument is set `True`, or `None` if it is left at the default (`False`).
+ 
+    For **RealDate** instances, this method works the same way as **.pretty()**, using the _fmt_ argument with the same default as above.
 
 
 ## Example usage

{infdate-0.2.4 → infdate-0.2.5}/README.md

@@ -24,10 +24,10 @@ contain the two possible **InfinityDate** instance variations.
 The module -level constants **REAL_MIN** and **REAL_MAX** are the eqivalents
 of **datetime.date.min** and **datetime.date.max** as **RealDate** instances.
 
-For any valid **RealDate** instance, the following is **True**:
+For any **RealDate** instance, the following is **True**:
 
 ``` python
-infdate.MIN < infdate.REAL_MIN <= real_date_instance <= infdate.REAL_MAX < infdate.MAX
+infdate.INFINITE_PAST < infdate.REAL_MIN <= real_date_instance <= infdate.REAL_MAX < infdate.INFINITE_FUTURE
 ```
 
 ### Module-level constants
@@ -36,8 +36,8 @@ infdate.MIN < infdate.REAL_MIN <= real_date_instance <= infdate.REAL_MAX < infda
 *   **INFINITE_FUTURE** = **InfinityDate(**_past_bound_=`False`**)** → infinity after any date
 *   **MIN** = **INFINITE_PAST**
 *   **MAX** = **INFINITE_FUTURE**
-*   **REAL_MIN** = **RealDate(**_`1`, `1`, `1`_**)** → the same date as **datetime.date.min**
-*   **REAL_MAX** = **RealDate(**_`9999`, `12`, `31`_**)** → the same date as **datetime.date.max**
+*   **REAL_MIN** = **RealDate(**`1`, `1`, `1`**)** → the same date as **datetime.date.min**
+*   **REAL_MAX** = **RealDate(**`9999`, `12`, `31`**)** → the same date as **datetime.date.max**
 *   **MIN_ORDINAL** = `1` → the same value as **datetime.date.min.toordinal()**
 *   **MAX_ORDINAL** = `3652059` → the same value as **datetime.date.max.toordinal()**
 *   **RESOLUTION** = `1` → represents the lowest possible date difference: _one day_
@@ -84,8 +84,17 @@ Some notable difference from the **datetime.date** class, mainly due to the desi
     from an **InfinityDate** or **RealDate**, only **float** or **int**
     (support for adding and subtracting datetime.timedelta instances might be added in the future, [see the feature request]).
 
-*   infdate module classes have a **.pretty()** method that can be used to format **RealDate** instances with a format string like **.strftime()** (provided with the _fmt_ argument that defaults to the ISO format `%Y-%m-%d`),
-    or to apply a custom format to **InfinityDate** classes using the _inf_common_prefix_, _inf_past_suffix_ and _inf_future_suffix_ arguments.
+
+### Additional methods
+
+*   **.pretty()** can be used to format **RealDate** instances with a format string like **.strftime()** (provided with the _fmt_ argument that defaults to the ISO format `%Y-%m-%d`),
+    or to apply a custom format to **InfinityDate** classes using the _inf_common_prefix_, _inf_past_suffix_, and _inf_future_suffix_ arguments.
+
+*   **.tonative()** is the inverse function of   the **fromnative()** constructor, returning a value tha can be used e.g. as a value for an API.
+
+    For **InfinityDate** instances, it returns the **.toordinal()** result if the _exact_ argument is set `True`, or `None` if it is left at the default (`False`).
+ 
+    For **RealDate** instances, this method works the same way as **.pretty()**, using the _fmt_ argument with the same default as above.
 
 
 ## Example usage

{infdate-0.2.4 → infdate-0.2.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "infdate"
-version = "0.2.4"
+version = "0.2.5"
 description = "Date object wrapper supporting infinity"
 readme = "README.md"
 authors = [

infdate-0.2.5/reports/docs/build-info.json

@@ -0,0 +1,8 @@
+{
+  "ci_pipeline_created_at": "2025-07-01T05:16:16Z",
+  "ci_pipeline_id": "1899192252",
+  "ci_pipeline_url": "https://gitlab.com/blackstream-x/infdate/-/pipelines/1899192252",
+  "ci_project_title": "infdate",
+  "ci_project_url": "https://gitlab.com/blackstream-x/infdate",
+  "ci_commit_sha": "1a7174f522c13a615675c5760cb5d4707696cc1b"
+}

{infdate-0.2.4 → infdate-0.2.5}/reports/docs/build-info.md

@@ -4,6 +4,6 @@ _provided by [glsr-present](https://pypi.org/project/glsr-present/) 0.3.6_
 
 [infdate](https://gitlab.com/blackstream-x/infdate)
 built with pipeline
-[1898767076](https://gitlab.com/blackstream-x/infdate/-/pipelines/1898767076)
-(build started 2025-06-30T21:43:23Z)
+[1899192252](https://gitlab.com/blackstream-x/infdate/-/pipelines/1899192252)
+(build started 2025-07-01T05:16:16Z)
 

infdate-0.2.5/reports/test-junit.xml

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="utf-8"?><testsuites name="pytest tests"><testsuite name="pytest" errors="0" failures="0" skipped="0" tests="48" time="1.173" timestamp="2025-07-01T05:16:48.730103+00:00" hostname="runner-j1aldqxs-project-71015407-concurrent-0"><testcase classname="tests.test_dates.GenericDateBase" name="test_bool" time="0.003" /><testcase classname="tests.test_dates.GenericDateBase" name="test_eq" time="0.002" /><testcase classname="tests.test_dates.GenericDateBase" name="test_ge" time="0.056" /><testcase classname="tests.test_dates.GenericDateBase" name="test_gt" time="0.046" /><testcase classname="tests.test_dates.GenericDateBase" name="test_hash" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_isoformat" time="0.002" /><testcase classname="tests.test_dates.GenericDateBase" name="test_le" time="0.056" /><testcase classname="tests.test_dates.GenericDateBase" name="test_lt" time="0.046" /><testcase classname="tests.test_dates.GenericDateBase" name="test_nan_not_allowed" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_ne" time="0.047" /><testcase classname="tests.test_dates.GenericDateBase" name="test_pretty" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_replace" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_repr" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_str" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_strftime" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_tonative" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_toordinal" time="0.001" /><testcase classname="tests.test_dates.GenericDateArithmetics" name="test_add_and_radd" time="0.007" /><testcase classname="tests.test_dates.GenericDateArithmetics" name="test_add_days" time="0.004" /><testcase classname="tests.test_dates.GenericDateArithmetics" name="test_rsub_stdlib_date" time="0.001" /><testcase classname="tests.test_dates.GenericDateArithmetics" name="test_sub_date" time="0.001" /><testcase classname="tests.test_dates.GenericDateArithmetics" name="test_sub_number" time="0.004" /><testcase classname="tests.test_dates.GenericDateArithmetics" name="test_sub_stdlib_date" time="0.001" /><testcase classname="tests.test_dates.InfinityDate" name="test_pretty" time="0.001" /><testcase classname="tests.test_dates.InfinityDate" name="test_replace" time="0.001" /><testcase classname="tests.test_dates.InfinityDate" name="test_repr" time="0.001" /><testcase classname="tests.test_dates.InfinityDate" name="test_strftime" time="0.001" /><testcase classname="tests.test_dates.InfinityDate" name="test_tonative" time="0.001" /><testcase classname="tests.test_dates.RealDate" name="test_attributes" time="0.002" /><testcase classname="tests.test_dates.RealDate" name="test_bool" time="0.001" /><testcase classname="tests.test_dates.RealDate" name="test_pretty" time="0.001" /><testcase classname="tests.test_dates.RealDate" name="test_proxied_methods" time="0.001" /><testcase classname="tests.test_dates.RealDate" name="test_random_date_within_limits" time="0.295" /><testcase classname="tests.test_dates.RealDate" name="test_replace" time="0.002" /><testcase classname="tests.test_dates.RealDate" name="test_repr" time="0.001" /><testcase classname="tests.test_dates.RealDate" name="test_strftime" time="0.003" /><testcase classname="tests.test_dates.RealDate" name="test_tonative" time="0.001" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_deprecated_from_datetime_object" time="0.003" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_deprecated_from_native_type" time="0.005" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_fromisocalendar" time="0.002" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_fromisoformat" time="0.002" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_fromnative" time="0.004" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_fromordinal" time="0.002" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_fromtimestamp" time="0.003" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_fromtimestamp_errors" time="0.001" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_private__from_datetime_object" time="0.002" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_today" time="0.002" /><testcase classname="tests.test_factories.FactoryFunctions" name="testdatetime" time="0.002" /></testsuite></testsuites>

{infdate-0.2.4 → infdate-0.2.5}/src/infdate/__init__.py

@@ -164,6 +164,16 @@ class GenericDate:
         """Return the date, pretty printed"""
         raise NotImplementedError
 
+    def tonative(
+        self: _GD,
+        /,
+        *,
+        exact: bool = False,
+        fmt: str = ISO_DATE_FORMAT,
+    ) -> str | float | None:
+        """Return the native equivalent of the date"""
+        raise NotImplementedError
+
 
 class InfinityDate(GenericDate):
     """Infinity Date object"""
@@ -193,7 +203,6 @@ class InfinityDate(GenericDate):
             f"{self.__class__.__name__} instances do not support .replace()"
         )
 
-    @final
     def pretty(
         self,
         /,
@@ -212,6 +221,19 @@ class InfinityDate(GenericDate):
         #
         return pretty_result or self.isoformat()
 
+    def tonative(
+        self,
+        /,
+        *,
+        exact: bool = False,
+        fmt: str = ISO_DATE_FORMAT,
+    ) -> str | float | None:
+        """Return the native equivalent of the date"""
+        if not exact:
+            return None
+        #
+        return self.toordinal()
+
 
 # pylint: disable=too-many-instance-attributes
 class RealDate(GenericDate):
@@ -255,7 +277,6 @@ class RealDate(GenericDate):
             )
         )
 
-    @final
     def pretty(
         self,
         /,
@@ -268,6 +289,16 @@ class RealDate(GenericDate):
         """Return the date, pretty printed"""
         return self.strftime(fmt)
 
+    def tonative(
+        self,
+        /,
+        *,
+        exact: bool = False,
+        fmt: str = ISO_DATE_FORMAT,
+    ) -> str | float | None:
+        """Return the native equivalent of the date"""
+        return self.strftime(fmt)
+
 
 # -----------------------------------------------------------------------------
 # Private module functions

{infdate-0.2.4 → infdate-0.2.5}/tests/test_dates.py

@@ -236,6 +236,11 @@ class GenericDateBase(tb.VerboseTestCase):
         gd = infdate.GenericDate(inf)
         self.assertRaises(NotImplementedError, gd.pretty)
 
+    def test_tonative(self):
+        """.tonative() method"""
+        gd = infdate.GenericDate(inf)
+        self.assertRaises(NotImplementedError, gd.tonative)
+
 
 class GenericDateArithmetics(tb.VerboseTestCase):
     """GenericDate objects - arithmetics"""
@@ -540,6 +545,34 @@ class InfinityDate(tb.VerboseTestCase):
             #
         #
 
+    def test_tonative(self):
+        """.tonative() method"""
+        infinite_past = infdate.InfinityDate(past_bound=True)
+        infinite_future = infdate.InfinityDate()
+        for exact, infinite_past_result, infinite_future_result in (
+            (True, -inf, inf),
+            (False, None, None),
+        ):
+            with self.subTest(
+                "infinite past", exact=exact, infinite_past_result=infinite_past_result
+            ):
+                self.assertEqual(
+                    infinite_past.tonative(exact=exact), infinite_past_result
+                )
+                #
+            #
+            with self.subTest(
+                "infinite furture",
+                exact=exact,
+                infinite_future_result=infinite_future_result,
+            ):
+                self.assertEqual(
+                    infinite_future.tonative(exact=exact), infinite_future_result
+                )
+                #
+            #
+        #
+
 
 class RealDate(tb.VerboseTestCase):
     """RealDate class"""
@@ -710,6 +743,20 @@ class RealDate(tb.VerboseTestCase):
             #
         #
 
+    def test_tonative(self):
+        """.tonative() method"""
+        for year, month, day, fmt, expected_result in (
+            (1996, 6, 25, "%d.%m.%Y", "25.06.1996"),
+            (1, 2, 3, "%m/%d/%y", "02/03/01"),
+            (9999, 12, 31, "%Y-%m", "9999-12"),
+            (2025, 6, 25, "", "2025-06-25"),
+        ):
+            rd = infdate.RealDate(year, month, day)
+            with self.subTest("result value", fmt=fmt, expected_result=expected_result):
+                self.assertEqual(rd.tonative(fmt=fmt), expected_result)
+            #
+        #
+
     def test_random_date_within_limits(self):
         """The following relation
         infdate.INFINITE_PAST < infdate.REAL_MIN <= real_date_instance <= …

infdate-0.2.4/reports/docs/build-info.json

@@ -1,8 +0,0 @@
-{
-  "ci_pipeline_created_at": "2025-06-30T21:43:23Z",
-  "ci_pipeline_id": "1898767076",
-  "ci_pipeline_url": "https://gitlab.com/blackstream-x/infdate/-/pipelines/1898767076",
-  "ci_project_title": "infdate",
-  "ci_project_url": "https://gitlab.com/blackstream-x/infdate",
-  "ci_commit_sha": "f9583fe4843bff2787558b26ed227473639049c5"
-}

infdate-0.2.4/reports/test-junit.xml

@@ -1 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?><testsuites name="pytest tests"><testsuite name="pytest" errors="0" failures="0" skipped="0" tests="45" time="1.183" timestamp="2025-06-30T21:43:54.387222+00:00" hostname="runner-zxwgkjap-project-71015407-concurrent-0"><testcase classname="tests.test_dates.GenericDateBase" name="test_bool" time="0.003" /><testcase classname="tests.test_dates.GenericDateBase" name="test_eq" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_ge" time="0.055" /><testcase classname="tests.test_dates.GenericDateBase" name="test_gt" time="0.046" /><testcase classname="tests.test_dates.GenericDateBase" name="test_hash" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_isoformat" time="0.002" /><testcase classname="tests.test_dates.GenericDateBase" name="test_le" time="0.056" /><testcase classname="tests.test_dates.GenericDateBase" name="test_lt" time="0.046" /><testcase classname="tests.test_dates.GenericDateBase" name="test_nan_not_allowed" time="0.002" /><testcase classname="tests.test_dates.GenericDateBase" name="test_ne" time="0.046" /><testcase classname="tests.test_dates.GenericDateBase" name="test_pretty" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_replace" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_repr" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_str" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_strftime" time="0.001" /><testcase classname="tests.test_dates.GenericDateBase" name="test_toordinal" time="0.001" /><testcase classname="tests.test_dates.GenericDateArithmetics" name="test_add_and_radd" time="0.007" /><testcase classname="tests.test_dates.GenericDateArithmetics" name="test_add_days" time="0.005" /><testcase classname="tests.test_dates.GenericDateArithmetics" name="test_rsub_stdlib_date" time="0.001" /><testcase classname="tests.test_dates.GenericDateArithmetics" name="test_sub_date" time="0.001" /><testcase classname="tests.test_dates.GenericDateArithmetics" name="test_sub_number" time="0.004" /><testcase classname="tests.test_dates.GenericDateArithmetics" name="test_sub_stdlib_date" time="0.001" /><testcase classname="tests.test_dates.InfinityDate" name="test_pretty" time="0.001" /><testcase classname="tests.test_dates.InfinityDate" name="test_replace" time="0.001" /><testcase classname="tests.test_dates.InfinityDate" name="test_repr" time="0.001" /><testcase classname="tests.test_dates.InfinityDate" name="test_strftime" time="0.001" /><testcase classname="tests.test_dates.RealDate" name="test_attributes" time="0.001" /><testcase classname="tests.test_dates.RealDate" name="test_bool" time="0.001" /><testcase classname="tests.test_dates.RealDate" name="test_pretty" time="0.001" /><testcase classname="tests.test_dates.RealDate" name="test_proxied_methods" time="0.001" /><testcase classname="tests.test_dates.RealDate" name="test_random_date_within_limits" time="0.291" /><testcase classname="tests.test_dates.RealDate" name="test_replace" time="0.002" /><testcase classname="tests.test_dates.RealDate" name="test_repr" time="0.001" /><testcase classname="tests.test_dates.RealDate" name="test_strftime" time="0.003" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_deprecated_from_datetime_object" time="0.003" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_deprecated_from_native_type" time="0.005" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_fromisocalendar" time="0.002" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_fromisoformat" time="0.002" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_fromnative" time="0.004" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_fromordinal" time="0.002" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_fromtimestamp" time="0.003" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_fromtimestamp_errors" time="0.001" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_private__from_datetime_object" time="0.002" /><testcase classname="tests.test_factories.FactoryFunctions" name="test_today" time="0.002" /><testcase classname="tests.test_factories.FactoryFunctions" name="testdatetime" time="0.002" /></testsuite></testsuites>