seecr-stdlib 0.6.4__py3-none-any.whl

seecr_stdlib/.gitignore

@@ -0,0 +1 @@
+_version.py

seecr_stdlib/__init__.py

@@ -0,0 +1,25 @@
+## 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 ##
+
+from .dict import Dict
+from .first import first

seecr_stdlib/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.6.4'
+__version_tuple__ = version_tuple = (0, 6, 4)
+
+__commit_id__ = commit_id = 'gc79af26a3'

seecr_stdlib/config.py

@@ -0,0 +1,78 @@
+## 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 ##
+
+import json
+import pathlib
+import warnings
+
+
+def expand_dict(obj, context):
+    if isinstance(obj, dict):
+        return {k: expand_dict(v, context) for k, v in obj.items()}
+    if isinstance(obj, list):
+        return [expand_dict(v, context) for v in obj]
+    if isinstance(obj, str):
+        return obj.format_map(context)
+    return obj  # ints, None, etc. unchanged
+
+
+class Config:
+    @classmethod
+    def read(cls, path, **kwargs):
+        return cls(json.loads(path.read_text()), **kwargs)
+
+    def __init__(self, config_file, required=None):
+        if isinstance(config_file, pathlib.Path):
+            warnings.warn(
+                "Specifying path in __init__ is deprecated, use Config.read(path, ..) instead",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            config = json.loads(config_file.read_text())
+        elif isinstance(config_file, dict):
+            config = config_file
+        else:
+            raise ValueError("config_file should be either a Path or dict")
+
+        self._config = config
+        if required is not None:
+            for key in required:
+                if self.get(key) is None:
+                    raise RuntimeError(f"Mandatory key '{key}' not found in config")
+
+    def get(self, key, default=None):
+        value = self._config
+        for k in key.split("."):
+            if k.isdigit() and isinstance(value, list):
+                try:
+                    value = value[int(k)]
+                except IndexError:
+                    return default
+            else:
+                value = value.get(k)
+            if value is None:
+                return default
+        return value
+
+    def expand_with(self, values_dict):
+        return Config(expand_dict(self._config, values_dict))

seecr_stdlib/config_test.py

@@ -0,0 +1,120 @@
+## 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 ##
+
+import pytest
+import json
+
+from .config import Config
+
+
+def test_config_get():
+    config = {
+        "root": {
+            "text": "The text",
+            "number": 42,
+            "boolean": True,
+            "values": [1, 2, 3, 4, 5],
+            "sub": {
+                "boolean": False,
+            },
+        },
+        "complex": {"values": [{"1": ["one"]}, {"2": "two"}]},
+    }
+
+    config = Config(config)
+    assert config.get("root.text") == "The text"
+    assert config.get("root.texts") is None
+    assert config.get("root.texts", default="X") == "X"
+    assert config.get("root.number") == 42
+    assert config.get("root.boolean") is True
+    assert config.get("root.sub.boolean") is False
+    assert config.get("root.values") == [1, 2, 3, 4, 5]
+    assert config.get("root.values.0") == 1
+    assert config.get("root.values.0") == 1
+    assert config.get("root.values.5") is None
+    assert config.get("root.values.5", default="X") == "X"
+    assert config.get("values.sub") is None
+    assert config.get("values.sub", default=1) == 1
+
+    assert config.get("complex.values.0.1.0") == "one"
+    assert config.get("complex.values.1.2") == "two"
+
+
+def test_config_required(tmp_path):
+    with pytest.raises(RuntimeError) as e:
+        Config({}, required=["root"])
+
+    assert str(e.value) == "Mandatory key 'root' not found in config"
+
+
+def test_config_arg(tmp_path):
+    (config_file := tmp_path / "config.json").write_text(json.dumps({"key": "value"}))
+    with pytest.warns(DeprecationWarning) as warnings:
+        assert Config(config_file=config_file).get("key") == "value"
+
+    assert len(warnings) == 1
+    assert (
+        "Specifying path in __init__ is deprecated, use Config.read(path, ..) instead"
+        in str(warnings[0].message)
+    )
+
+    assert Config({"key": "value"}).get("key") == "value"
+
+    with pytest.raises(ValueError) as e:
+        Config([])
+
+    assert str(e.value) == "config_file should be either a Path or dict"
+
+
+def test_config_expand():
+    config = Config(
+        {
+            "root": {
+                "text": "The text {name}",
+            },
+            "deeper": {"levels": {"work": {"too": "The answer is {answer}"}}},
+        }
+    )
+
+    expanded_config = config.expand_with(dict(name="has no name", answer=42))
+
+    assert config.get("root.text") == "The text {name}"
+    assert expanded_config.get("root.text") == "The text has no name"
+
+    assert config.get("deeper.levels.work.too") == "The answer is {answer}"
+    assert expanded_config.get("deeper.levels.work.too") == "The answer is 42"
+
+
+def test_my_config(tmp_path):
+    (config_file := tmp_path / "config.json").write_text(
+        json.dumps({"key": "value", "nested": {"key": "nested_value"}})
+    )
+
+    class MyConfig(Config):
+        def __init__(self, config):
+            super().__init__(config, required=["key", "nested.key"])
+
+    config = MyConfig.read(config_file)
+
+    assert config.get("key") == "value"
+    assert config.get("nested.key") == "nested_value"

seecr_stdlib/dict.py

@@ -0,0 +1,63 @@
+## 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 ##
+
+class Dict(dict):
+    """A dict whose keys can also be read and written as attributes:
+    d.answer is d["answer"].
+
+    Attributes of the class itself (methods like get, items, keys, update,
+    and dunder names) always win, so a key can never hide a method:
+    d["items"] = 1 leaves d.items as the method; use d["items"] for the value.
+    Assigning such a name as an attribute (d.items = 1) raises AttributeError
+    instead of silently storing a key that could not be read back as d.items.
+    """
+
+    __slots__ = ()  # no instance __dict__: every attribute write goes to the keys
+
+    def __getattr__(self, key):
+        # Only called when normal lookup fails, i.e. never for methods.
+        try:
+            return self[key]
+        except KeyError:
+            raise AttributeError(
+                f"{type(self).__name__!r} object has no attribute or key {key!r}"
+            ) from None
+
+    def __setattr__(self, key, value):
+        if hasattr(type(self), key):
+            raise AttributeError(
+                f"{key!r} is a {type(self).__name__} attribute; use d[{key!r}] = ... instead"
+            )
+        self[key] = value
+
+    def __delattr__(self, key):
+        if hasattr(type(self), key):
+            raise AttributeError(f"cannot delete {type(self).__name__} attribute {key!r}")
+        try:
+            del self[key]
+        except KeyError:
+            raise AttributeError(key) from None
+
+    def __dir__(self):
+        # Include string keys that are valid identifiers, for tab completion.
+        return sorted(set(super().__dir__()) | {k for k in self if isinstance(k, str) and k.isidentifier()})

seecr_stdlib/dict_test.py

@@ -0,0 +1,101 @@
+## 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 copy
+import json
+import pickle
+
+import pytest
+
+from .dict import Dict
+
+
+def test_dict():
+    d = Dict()
+    d["answer"] = 42
+    assert d["answer"] == 42
+    assert d.answer == 42
+
+    d = Dict()
+    d.answer = 42
+
+    assert d.answer == 42
+    assert d["answer"] == 42
+
+
+def test_keys_do_not_override_methods():
+    d = Dict(items=1, get=2, keys=3, update=4)
+    assert callable(d.items) and callable(d.get) and callable(d.keys)
+    assert d["items"] == 1 and d.get("get") == 2
+    assert sorted(d.keys()) == ["get", "items", "keys", "update"]
+    d.update(answer=42)
+    assert d.answer == 42
+
+
+def test_setting_method_name_as_attribute_is_refused():
+    d = Dict()
+    with pytest.raises(AttributeError):
+        d.items = 1
+    with pytest.raises(AttributeError):
+        d.__class__ = dict
+    assert d == {}
+    d["items"] = 1                      # item syntax still works
+    assert d["items"] == 1 and callable(d.items)
+
+
+def test_missing_attribute():
+    d = Dict(a=1)
+    with pytest.raises(AttributeError):
+        d.missing
+    assert getattr(d, "missing", None) is None
+    assert hasattr(d, "a") and not hasattr(d, "missing")
+
+
+def test_delete_attribute():
+    d = Dict(a=1)
+    del d.a
+    assert d == {}
+    with pytest.raises(AttributeError):
+        del d.a
+    with pytest.raises(AttributeError):
+        del d.items
+
+
+def test_no_instance_dict():
+    d = Dict()
+    d.answer = 42
+    assert d == {"answer": 42}
+    assert not hasattr(d, "__dict__")
+
+
+def test_dir_includes_keys():
+    d = Dict(Name="x", **{"not valid": 1})
+    assert "Name" in dir(d) and "items" in dir(d) and "not valid" not in dir(d)
+
+
+def test_still_a_dict():
+    d = Dict(a=1, b=Dict(c=2))
+    assert isinstance(d, dict)
+    assert json.loads(json.dumps(d)) == {"a": 1, "b": {"c": 2}}
+    for clone in (copy.copy(d), copy.deepcopy(d), pickle.loads(pickle.dumps(d))):
+        assert clone == d and type(clone) is Dict and clone.b.c == 2

seecr_stdlib/first.py

@@ -0,0 +1,25 @@
+## 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 ##
+
+def first(collection):
+    return collection[0] if len(collection) > 0 else None

seecr_stdlib/first_test.py

@@ -0,0 +1,29 @@
+## 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 ##
+
+from .first import first
+
+
+def test_first():
+    assert first([]) is None
+    assert first([1]) == 1

seecr_stdlib/format/__init__.py

@@ -0,0 +1,24 @@
+## 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 .date import *

seecr_stdlib/format/date.py

@@ -0,0 +1,155 @@
+## 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 ##
+
+__all__ = ["format_date"]
+
+import zoneinfo
+from functools import partial
+
+from seecr_stdlib.time import float_as_datetime
+from dateutil import parser
+import datetime
+
+NL_TZ = zoneinfo.ZoneInfo("Europe/Amsterdam")
+
+
+def _in_tz(date, tzinfo):
+    # Naive datetimes are taken to be in tzinfo already; astimezone() would
+    # assume the server's local time and make the output machine dependent.
+    if date.tzinfo is None:
+        return date.replace(tzinfo=tzinfo)
+    return date.astimezone(tzinfo)
+
+
+def _iso_style(date):
+    return date.isoformat().split("T")[0]
+
+
+def _zulu_style(date):
+    return date.isoformat(timespec="seconds").replace("+00:00", "Z")
+
+
+def _nl_style(date, time=False, tzinfo=NL_TZ):
+    if isinstance(date, datetime.datetime) and time:
+        date = _in_tz(date, tzinfo)
+
+    fmt = "%d-%m-%Y"
+    if time:
+        fmt += " %H:%M"
+    return date.strftime(fmt)
+
+
+days_nl = list(
+    zip(
+        (
+            "maandag",
+            "dinsdag",
+            "woensdag",
+            "donderdag",
+            "vrijdag",
+            "zaterdag",
+            "zondag",
+        ),
+        ("ma", "di", "wo", "do", "vr", "za", "zo"),
+    )
+)
+months_nl = list(
+    zip(
+        (
+            "januari",
+            "februari",
+            "maart",
+            "april",
+            "mei",
+            "juni",
+            "juli",
+            "augustus",
+            "september",
+            "oktober",
+            "november",
+            "december",
+        ),
+        (
+            "jan",
+            "feb",
+            "mrt",
+            "apr",
+            "mei",
+            "jun",
+            "jul",
+            "aug",
+            "sep",
+            "okt",
+            "nov",
+            "dec",
+        ),
+    )
+)
+
+
+def _nllang_style(date, pos, time=False, tzinfo=NL_TZ):
+    if isinstance(date, datetime.datetime) and time:
+        date = _in_tz(date, tzinfo)
+
+    day_name = days_nl[date.weekday()][pos]
+    month_name = months_nl[date.month - 1][pos]
+    result = f"{day_name} {date.day} {month_name} {date.year}"
+    if time:
+        result += f" {date.hour:02}:{date.minute:02}"
+    return result
+
+
+styles = {
+    "nl": _nl_style,
+    "nl_tijd": partial(_nl_style, time=True),
+    "nllang": partial(_nllang_style, pos=0),
+    "nlkort": partial(_nllang_style, pos=1),
+    "nllang_tijd": partial(_nllang_style, pos=0, time=True),
+    "nlkort_tijd": partial(_nllang_style, pos=1, time=True),
+    "zulu": _zulu_style,
+}
+styles["nl-t"] = styles["nl_tijd"]
+styles["nl-l"] = styles["nllang"]
+styles["nl-k"] = styles["nlkort"]
+styles["nl-lt"] = styles["nllang_tijd"]
+styles["nl-kt"] = styles["nlkort_tijd"]
+
+
+def format_date(date, style="iso"):
+    """Uniformly format a date according to the given style.
+
+    To use as jinja filter, add 'format_date' to the filters dict in your jinja environment.
+    Usage:
+        {{ date | format_date('nl') }}
+    """
+    if date is None:
+        return ""
+    if isinstance(date, str):
+        try:
+            date = parser.isoparse(date)
+        except ValueError:
+            return date
+    if isinstance(date, (int, float)):
+        date = float_as_datetime(date)
+    fn = styles.get(style, _iso_style)
+    return fn(date)