shvcli-ell 0.1.0__py3-none-any.whl

shvcli_ell/__init__.py

@@ -0,0 +1,8 @@
+"""Simple counter of strings of this package name.
+
+This package is base for the packages to be implemented.
+"""
+
+from .__version__ import VERSION
+
+__all__ = ["VERSION"]

shvcli_ell/__version__.py

@@ -0,0 +1 @@
+VERSION = "0.1.0"

shvcli_ell/plugin.py

@@ -0,0 +1,6 @@
+"""The top level loaded for the plugin."""
+
+import importlib
+
+importlib.import_module(".timesync", __package__)
+importlib.import_module(".timezone", __package__)

shvcli_ell/timesync.py

@@ -0,0 +1,56 @@
+"""The builtin to sync time of NuttX based devices."""
+
+import collections.abc
+import datetime
+
+from prompt_toolkit.completion import Completion
+from shvcli import Builtin, Builtins, Client, CliItems, State, Tree
+from shvcli.tools.complet import comp_path
+
+
+class BuiltinTimeSync(Builtin):
+    """The builtin for time synchronization of ``utcTime`` with local one."""
+
+    def __init__(self, builtins: Builtins, state: State) -> None:
+        super().__init__(builtins, state)
+        builtins["timesync"] = self
+
+    @property
+    def description(self) -> tuple[str, str]:  # noqa: D102
+        return "[PATH]", "Synchronize the time of the board with the local time."
+
+    def completion(  # noqa: D102
+        self, items: CliItems, client: Client
+    ) -> collections.abc.Iterable[Completion]:
+        yield from comp_path(items.param, self.state.path, Tree(self.state), "")
+
+    async def completion_async(  # noqa: D102
+        self, items: CliItems, client: Client
+    ) -> collections.abc.AsyncGenerator[Completion, None]:
+        await client.probe(
+            items.path_param if items.param.endswith("/") else items.path_param.parent
+        )
+
+        async for res in super().completion_async(items, client):
+            yield res
+
+    async def run(self, items: CliItems, client: Client) -> None:  # noqa: PLR6301, D102
+        path = items.path_param
+        if path.name != "utcTime":
+            path /= "utcTime"
+        got = await client.call(str(path), "get")
+        if not isinstance(got, datetime.datetime):
+            print(f"Unexpected result of {path}:get: {got}")
+            return
+
+        now = datetime.datetime.now(datetime.UTC)
+        diff = now - got
+        drift = datetime.timedelta(milliseconds=500)
+        if not (-drift <= diff <= drift):
+            await client.call(str(path), "set", now)
+            print(f"Time synchronized. The difference: {diff}")
+        else:
+            print(
+                "Time is syncrhonized withing half a second tolerance. "
+                f"The difference: {diff}"
+            )

shvcli_ell/timezone.py

@@ -0,0 +1,56 @@
+"""The builtin to set local time time of NuttX based devices."""
+
+import collections.abc
+import pathlib
+import zoneinfo
+
+from prompt_toolkit.completion import Completion
+from prompt_toolkit.validation import ValidationError
+from shvcli import Builtin, Builtins, Client, CliItems, State
+from shvcli.file import copy_file
+from shvcli.tools.complet import comp_from
+
+
+class BuiltinTimeSync(Builtin):
+    """The builtin for setting local time zone."""
+
+    def __init__(self, builtins: Builtins, state: State) -> None:
+        super().__init__(builtins, state)
+        builtins["timezone"] = self
+
+    @property
+    def description(self) -> tuple[str, str]:  # noqa: D102
+        return (
+            "[TZ]",
+            "Upload the given time zone (or local time zone in default).",
+        )
+
+    def completion(  # noqa: PLR6301, D102
+        self, items: CliItems, client: Client
+    ) -> collections.abc.Iterable[Completion]:
+        yield from comp_from(items.param, zoneinfo.available_timezones())
+
+    def validate(self, items: CliItems, client: Client) -> None:  # noqa: D102
+        param = items.param
+        if param and self._zonefile(items.param) is None:
+            raise ValidationError(message=f"No such zoneinfo: {param}")
+
+    async def run(self, items: CliItems, client: Client) -> None:  # noqa: D102
+        dest = items.path
+        if dest.name != "timeZone":
+            dest /= "timeZone"
+
+        param = items.param
+        src = self._zonefile(param) if param else pathlib.Path("/etc/localtime")
+        if src is not None:
+            await copy_file(client, src, dest)
+        else:
+            print(f"No such zoneinfo: {param}")
+
+    @staticmethod
+    def _zonefile(param: str) -> pathlib.Path | None:
+        for tzpath in map(pathlib.Path, zoneinfo.TZPATH):
+            path = tzpath / param
+            if path.is_file():
+                return path
+        return None

shvcli_ell-0.1.0.dist-info/METADATA

@@ -0,0 +1,23 @@
+Metadata-Version: 2.4
+Name: shvcli-ell
+Version: 0.1.0
+Summary: Silicon Heaven CLI Elektroline extension
+Author: Elektroline a.s.
+Project-URL: source, https://gitlab.com/elektroline-predator/shvcli-ell
+Project-URL: changelog, https://gitlab.com/elektroline-predator/shvcli-ell/-/blob/master/CHANGELOG.md
+Project-URL: issues, https://gitlab.com/elektroline-predator/shvcli-ell/-/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/x-rst
+Requires-Dist: shvcli>=0.7.0
+
+Silicon Heaven CLI Elektroline extension
+========================================
+
+The extension for the Silicon Heaven CLI access application to provide utilities
+to work with Elektroline developed SHV systems.
+
+* `📃 Sources <https://gitlab.com/elektroline-predator/shvcli-ell>`__
+* `⁉️ Issue tracker <https://gitlab.com/elektroline-predator/shvcli-ell/-/issues>`__
+* `Silicon Heaven CLI <https://gitlab.com/silicon-heaven/shvcli>`__

shvcli_ell-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+shvcli_ell/__init__.py,sha256=GlvcFG-HPLFpelk93WSeb9tUwD3oUkoIT3TJcQSOBdc,170
+shvcli_ell/__version__.py,sha256=CpXi3jGlx23RvRyU7iytOMZrnspdWw4yofS8lpP1AJU,18
+shvcli_ell/plugin.py,sha256=vNT4X7m-gvF1zQpn3omOKZ7S2FYTdPkH3oMUMq5n-CA,162
+shvcli_ell/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+shvcli_ell/timesync.py,sha256=mTuKcsn4gbjUk74-KkUD5hptqfGKyP7PlMTjSL3xpiE,2063
+shvcli_ell/timezone.py,sha256=E9f7oE6WUaymTw2oW_czVMzdpoKj1j4W5336qYApWRw,1904
+shvcli_ell-0.1.0.dist-info/METADATA,sha256=dctkP1-fh_2ZO3mBY01wbOdg17unkJ_RZ3eiaHcHW1w,1012
+shvcli_ell-0.1.0.dist-info/WHEEL,sha256=RhQGVt03AJtd1CDOm-ItnBQkdEMFvyyspQepe14x5Ds,97
+shvcli_ell-0.1.0.dist-info/entry_points.txt,sha256=aDXfsHL8yuROUEsEPC3nN8Qien6TRaRRN8q7DMIqdFo,41
+shvcli_ell-0.1.0.dist-info/top_level.txt,sha256=IvTYz-vcRBC0fzai0ggMEPLusy0N5HQ57rEU8t-RhMw,11
+shvcli_ell-0.1.0.dist-info/RECORD,,

shvcli_ell-0.1.0.dist-info/WHEEL

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

shvcli_ell-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[shvcli.plugins]
+ell = shvcli_ell.plugin

shvcli_ell-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+shvcli_ell