seecr-stdlib 0.6.4__py3-none-any.whl

seecr_stdlib/format/date_test.py

@@ -0,0 +1,147 @@
+## begin license ##
+#
+# Seecr StdLib provides convenient tools for Seecr developers
+#
+# Copyright (C) 2025-2026 Seecr (Seek You Too B.V.) https://seecr.nl
+#
+# This file is part of "Seecr Standard Library"
+#
+# "Seecr Standard Library" is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# "Seecr Standard Library" is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with "Seecr Standard Library".  If not, see <http://www.gnu.org/licenses/>.
+#
+## end license ##
+
+import pytest
+
+from seecr_stdlib.format import format_date
+from datetime import datetime, timezone, date
+
+
+@pytest.mark.parametrize(
+    "date,expected",
+    [
+        (None, ""),
+        (datetime(2024, 6, 15, 13, 45, 30), "2024-06-15"),
+        (datetime(2023, 1, 1), "2023-01-01"),
+        (datetime(2022, 12, 31, 23, 59, 59), "2022-12-31"),
+        (date(2022, 12, 31), "2022-12-31"),
+    ],
+)
+def test_format_date(date, expected):
+    assert format_date(date) == expected
+
+
+@pytest.mark.parametrize(
+    "date,expected",
+    [
+        (None, ""),
+        (datetime(2024, 6, 15, 13, 45, 30), "15-06-2024"),
+        (datetime(2023, 1, 1), "01-01-2023"),
+        (date(2023, 1, 1), "01-01-2023"),
+        (datetime(2022, 12, 31, 23, 59, 59), "31-12-2022"),
+    ],
+)
+def test_format_date_nl(date, expected):
+    assert format_date(date, "nl") == expected
+
+
+@pytest.mark.parametrize(
+    "date,expected",
+    [
+        (None, ""),
+        (datetime(2024, 6, 15, 13, 45, 30), "15-06-2024 13:45"),
+        (datetime(2023, 1, 1), "01-01-2023 00:00"),
+        (datetime(2022, 12, 31, 23, 59, 59), "31-12-2022 23:59"),
+        (
+            datetime(2026, 7, 13, 13, 40, 48, 727405, tzinfo=timezone.utc),
+            "13-07-2026 15:40",
+        ),
+    ],
+)
+def test_format_date_nl_tijd(date, expected):
+    assert format_date(date, "nl_tijd") == expected
+    assert format_date(date, "nl-t") == expected
+
+
+@pytest.mark.parametrize(
+    "date,expected",
+    [
+        (None, ""),
+        (datetime(2024, 6, 15, 13, 45, 30), "zaterdag 15 juni 2024"),
+        (datetime(2023, 1, 1), "zondag 1 januari 2023"),
+        (date(2023, 1, 1), "zondag 1 januari 2023"),
+        (datetime(2022, 12, 31, 23, 59, 59), "zaterdag 31 december 2022"),
+        (datetime(2025, 12, 9), "dinsdag 9 december 2025"),
+    ],
+)
+def test_format_date_nllang(date, expected):
+    assert format_date(date, "nllang") == expected
+
+
+@pytest.mark.parametrize(
+    "date,expected",
+    [
+        (None, ""),
+        (datetime(2024, 6, 15, 13, 45, 30), "za 15 jun 2024"),
+        (datetime(2023, 1, 1), "zo 1 jan 2023"),
+        (datetime(2022, 12, 31, 23, 59, 59), "za 31 dec 2022"),
+        (datetime(2025, 12, 9), "di 9 dec 2025"),
+    ],
+)
+def test_format_date_nlkort(date, expected):
+    assert format_date(date, "nlkort") == expected
+
+
+@pytest.mark.parametrize(
+    "date,expected",
+    [
+        (None, ""),
+        (datetime(2024, 6, 15, 13, 45, 30), "zaterdag 15 juni 2024 13:45"),
+        (datetime(2023, 1, 1, 0, 0), "zondag 1 januari 2023 00:00"),
+    ],
+)
+def test_format_date_nllang_tijd(date, expected):
+    assert format_date(date, "nllang_tijd") == expected
+    assert format_date(date, "nl-lt") == expected
+
+
+@pytest.mark.parametrize(
+    "string_date,style,expected",
+    [
+        ("", "iso", ""),
+        ("2024-06-15", "iso", "2024-06-15"),
+        ("invalid-date", "iso", "invalid-date"),
+        ("2024-06-15", "nllang", "zaterdag 15 juni 2024"),
+        ("2023-01-01", "nlkort", "zo 1 jan 2023"),
+        ("gewoon tekst", "nlkort", "gewoon tekst"),
+        ("2023-01-01", "unknown-style", "2023-01-01"),
+        ("2026-07-30 09:53:55", "nllang_tijd", "donderdag 30 juli 2026 09:53"),
+    ],
+)
+def test_format_date_with_string_input(string_date, style, expected):
+    assert format_date(string_date, style) == expected
+
+
+@pytest.mark.parametrize(
+    "nr,style,expected",
+    [
+        (0, "iso", "1970-01-01"),
+        (0, "nllang", "donderdag 1 januari 1970"),
+        (0, "nlkort", "do 1 jan 1970"),
+        (1789395323, "iso", "2026-09-14"),
+        (1789395323, "nllang_tijd", "maandag 14 september 2026 16:15"),
+        (1789395323, "zulu", "2026-09-14T14:15:23Z"),
+    ],
+)
+def test_format_date_from_timestamp(nr, style, expected):
+    assert format_date(nr, style) == expected

seecr_stdlib/time.py

@@ -0,0 +1,73 @@
+## begin license ##
+#
+# Seecr StdLib provides convenient tools for Seecr developers
+#
+# Copyright (C) 2026 Seecr (Seek You Too B.V.) https://seecr.nl
+#
+# This file is part of "Seecr Standard Library"
+#
+# "Seecr Standard Library" is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# "Seecr Standard Library" is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with "Seecr Standard Library".  If not, see <http://www.gnu.org/licenses/>.
+#
+## end license ##
+
+from datetime import datetime, timedelta, timezone
+from dateutil import tz
+from uuid import UUID
+
+tz_utc = timezone.utc
+
+
+def now_utc():
+    return datetime.now(tz=tz_utc)
+
+
+def now_local():
+    return datetime.now(tz=tz.tzlocal())
+
+
+def datetime_as_float(dt):
+    return dt.timestamp()
+
+
+def isoformat_as_datetime_utc(isoformat, timezone=None):
+    dt = datetime.fromisoformat(isoformat)
+    tzinfo = tz_utc
+    if timezone:
+        tzinfo = tz.gettz(timezone) or tz_utc
+    dt = dt.replace(tzinfo=tzinfo)
+    return dt.astimezone(tz=tz_utc)
+
+
+def timestamp_local_to_utc(t):
+    local_time = datetime.fromtimestamp(t, tz.tzlocal())
+    utc_time = datetime_local_to_utc(local_time)
+    return datetime_as_float(utc_time)
+
+
+def datetime_local_to_utc(dt):
+    return dt.replace(tzinfo=tz.tzlocal()).astimezone(tz=tz_utc)
+
+
+def datetime_utc_to_local(dt):
+    return dt.replace(tzinfo=tz_utc).astimezone(tz=tz.tzlocal())
+
+
+def uuid_as_datetime_utc(uuid):
+    tz_unaware = datetime(1582, 10, 15) + timedelta(microseconds=UUID(uuid).time // 10)
+
+    return tz_unaware.replace(tzinfo=tz_utc)
+
+
+def float_as_datetime(timestamp):
+    return datetime.fromtimestamp(timestamp, tz=tz_utc)

seecr_stdlib/time_test.py

@@ -0,0 +1,84 @@
+## begin license ##
+#
+# Seecr StdLib provides convenient tools for Seecr developers
+#
+# Copyright (C) 2026 Seecr (Seek You Too B.V.) https://seecr.nl
+#
+# This file is part of "Seecr Standard Library"
+#
+# "Seecr Standard Library" is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# "Seecr Standard Library" is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with "Seecr Standard Library".  If not, see <http://www.gnu.org/licenses/>.
+#
+## end license ##
+
+from .time import (
+    now_utc,
+    now_local,
+    datetime_as_float,
+    float_as_datetime,
+    isoformat_as_datetime_utc,
+)
+from datetime import timezone, datetime
+
+from dateutil import tz
+import pytest
+
+
+def test_now_utc():
+    now = now_utc()
+    assert now.strftime("%Z") == "UTC"
+    assert now.tzinfo == timezone.utc
+
+
+def test_now_local():
+    now = now_local()
+    assert isinstance(now.tzinfo, tz.tzlocal)
+    assert now.utcoffset() == datetime.now().astimezone().utcoffset()
+
+
+def test_datetime_as_float():
+    t = datetime(1970, 1, 1, 0, 0, 0, tzinfo=timezone.utc)
+    assert t.timestamp() == 0.0
+    assert datetime_as_float(t) == 0.0
+
+
+def test_timestamp_as_datetime():
+    now = now_utc()
+    now_dt = float_as_datetime(datetime_as_float(now))
+    assert now_dt == now
+
+
+@pytest.mark.parametrize(
+    "isoformat, timezone_str, expected_timestamp",
+    [
+        ("2026-09-16 10:47:54", "Europe/Amsterdam", 1789548474.0),
+        ("2026-09-16 05:47:54", "America/Sao_Paulo", 1789548474.0),
+        ("2026-09-16 08:47:54", "UTC", 1789548474.0),
+        ("1970-01-01 12:00", "UTC", 43200.0),
+        ("1970-01-01 12:00", "Europe/Amsterdam", 43200.0 - 3600.0),
+        ("1970-01-01 12:00", "America/Sao_Paulo", 43200.0 + 3 * 3600.0),
+        ("1970-01-01 12:00", None, 43200.0),
+        ("1970-01-01 12:00", "From/Nowhere", 43200.0),
+    ],
+)
+def test_fromisoformat(isoformat, timezone_str, expected_timestamp):
+    dt = isoformat_as_datetime_utc(isoformat, timezone_str)
+    assert dt.timestamp() == expected_timestamp
+    assert dt.tzinfo == timezone.utc
+
+
+def test_isformat_as_datetime_utc_compared_to_datetime_fromisoformat():
+    isoformat = "2026-09-16 10:47:54"
+    dt1 = isoformat_as_datetime_utc(isoformat)
+    dt2 = datetime.fromisoformat(isoformat + "+00:00")
+    assert dt1.timestamp() == dt2.timestamp()

seecr_stdlib-0.6.4.dist-info/METADATA

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: seecr-stdlib
+Version: 0.6.4
+Summary: Standard tools for seecr
+Author-email: Thijs Janssen <thijs@seecr.nl>, Johan Jonkers <johan@seecr.nl>
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/seecr/seecr-stdlib
+Project-URL: Source, https://github.com/seecr/seecr-stdlib
+Project-URL: Issues, https://github.com/seecr/seecr-stdlib/issues
+Keywords: tools
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pytest<10,>=9.0.1
+Requires-Dist: python-dateutil<3,>=2.9.0
+Dynamic: license-file
+
+# Seecr Standard Library
+
+Small, dependency-light Python utilities shared across [Seecr](https://seecr.nl) projects.
+
+[![Tests](https://github.com/seecr/seecr-stdlib/actions/workflows/test.yml/badge.svg)](https://github.com/seecr/seecr-stdlib/actions/workflows/test.yml)
+[![PyPI](https://img.shields.io/pypi/v/seecr-stdlib.svg)](https://pypi.org/project/seecr-stdlib/)
+
+## Installation
+
+```sh
+pip install seecr-stdlib
+```
+
+Requires Python 3.11 or newer.
+
+## What's inside
+
+### `Dict`: attribute access for dicts
+
+```python
+from seecr_stdlib import Dict
+
+d = Dict(answer=42)
+d.answer           # 42
+d.question = "?"   # same as d["question"] = "?"
+```
+
+Keys never shadow dict methods: `Dict(items=1).items` is still the method, and
+assigning `d.items = 1` raises `AttributeError`.
+
+### `first`
+
+```python
+from seecr_stdlib import first
+
+first([1, 2, 3])   # 1
+first([])          # None
+```
+
+### `Config`: dotted-path access to JSON configuration
+
+```python
+from pathlib import Path
+from seecr_stdlib.config import Config
+
+config = Config.read(Path("config.json"), required=["db.host"])
+config.get("db.host")
+config.get("db.ports.0")                   # list indices work too
+config.get("db.user", default="postgres")  # default for missing keys
+
+# Fill in {placeholders} in all string values
+config = config.expand_with({"host": "localhost"})
+```
+
+### `seecr_stdlib.time`: timezone-aware helpers
+
+`now_utc()`, `now_local()`, `datetime_as_float()`, `float_as_datetime()`,
+`isoformat_as_datetime_utc()`, `datetime_local_to_utc()`,
+`datetime_utc_to_local()`, `timestamp_local_to_utc()` and
+`uuid_as_datetime_utc()` (the timestamp of a version 1 UUID).
+
+### `format_date`: uniform date formatting
+
+Accepts `date`/`datetime` objects, ISO 8601 strings and Unix timestamps.
+Dutch styles that show time convert to `Europe/Amsterdam`.
+
+```python
+from datetime import datetime, timezone
+from seecr_stdlib.format import format_date
+
+d = datetime(2026, 10, 29, 13, 45, tzinfo=timezone.utc)
+format_date(d)                   # '2026-10-29'
+format_date(d, "nl")             # '29-10-2026'
+format_date(d, "nl_tijd")        # '29-10-2026 14:45'
+format_date(d, "nllang")         # 'donderdag 29 oktober 2026'
+format_date(d, "nlkort_tijd")    # 'do 29 okt 2026 14:45'
+format_date(d, "zulu")           # '2026-10-29T13:45:00Z'
+```
+
+Short aliases: `nl-t`, `nl-l`, `nl-k`, `nl-lt`, `nl-kt`. It also works as a
+Jinja filter:
+
+```python
+env.filters["format_date"] = format_date
+```
+
+```jinja
+{{ created | format_date('nl') }}
+```
+
+## Development
+
+```sh
+python -m venv env --prompt seecr-stdlib
+source env/bin/activate
+pip install -e .
+pytest
+```
+
+Tests live next to the code as `<module>_test.py`.
+
+## License
+
+Copyright (C) 2025-2026 Seecr (Seek You Too B.V.)
+
+Licensed under the [GNU General Public License v3.0 or later](LICENSE).

seecr_stdlib-0.6.4.dist-info/RECORD

@@ -0,0 +1,19 @@
+seecr_stdlib/.gitignore,sha256=tWvEr3sBkY2ODntRp4_IUz3cidH-xu1efiOQK9DfK04,12
+seecr_stdlib/__init__.py,sha256=t5dSC6iiDADZBqVm2fGSY-E7u_4JbeU_NXEiTjuncR8,946
+seecr_stdlib/_version.py,sha256=l1_a_8HzaDJqVbw1kdSMo2iFfWIhkl-b6lAgabjQrx0,528
+seecr_stdlib/config.py,sha256=vjXOJbxwYWthGgthsX0LlwIS5tD4r3rGuMiR7f_j70Q,2675
+seecr_stdlib/config_test.py,sha256=CSXYWSWeEZbq_BXwDMBGNMVRW1ge2wbsYQFJ66SgmXM,3889
+seecr_stdlib/dict.py,sha256=Pep3gJ1m3Bgi2UbLynj3-INBvYO7Q2XUggjBEEJf9FM,2526
+seecr_stdlib/dict_test.py,sha256=Eab1LjPAxzA5FmHpLkSd8zAIm0ZEfVeGaBqE3kyukIk,2834
+seecr_stdlib/first.py,sha256=ENhw5Hm4imQs3zfmzDU0wM7p4-uMo9KiOLW286ER0XU,979
+seecr_stdlib/first_test.py,sha256=HU52jc_FQv3Lcc0kDgs8x8WyNmfEvviF4bdCytZo8to,999
+seecr_stdlib/time.py,sha256=frFfdJSqiXU9XMvMoggHoOu60xgzVg4daWtin_jM4Ro,2070
+seecr_stdlib/time_test.py,sha256=JGwSAus1YEVebhT0hxDvVt42T_EoBE4yPWjL5mFVKwU,2722
+seecr_stdlib/format/__init__.py,sha256=tzPzQ3jnZMqXYsmDFrpB70a24HttoyytbjSfDpm92t4,913
+seecr_stdlib/format/date.py,sha256=eo39JcEHELaJG8GI99PFRi6Zpk4aYuHf0jTeM4pDwxY,4081
+seecr_stdlib/format/date_test.py,sha256=B6-NzlQp2gdCu7bXRN6_Uq-QVAR8bTlP3ULG6cqM40Y,4667
+seecr_stdlib-0.6.4.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+seecr_stdlib-0.6.4.dist-info/METADATA,sha256=eECHJ7VdHlvNne2jDo4gWO7W7daAD2LFbLB-3CbRHdQ,3870
+seecr_stdlib-0.6.4.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+seecr_stdlib-0.6.4.dist-info/top_level.txt,sha256=DVSY49-2DFcrvvqtYe4o8WvwttWLdGrKyrQhyBKmCRY,13
+seecr_stdlib-0.6.4.dist-info/RECORD,,

seecr_stdlib-0.6.4.dist-info/WHEEL

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