cgse-common 0.16.10__py3-none-any.whl → 0.16.12__py3-none-any.whl

{cgse_common-0.16.10.dist-info → cgse_common-0.16.12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cgse-common
-Version: 0.16.10
+Version: 0.16.12
 Summary: Software framework to support hardware testing
 Author: IvS KU Leuven
 Maintainer-email: Rik Huygen <rik.huygen@kuleuven.be>, Sara Regibo <sara.regibo@kuleuven.be>
@@ -22,6 +22,7 @@ Requires-Dist: pandas>=2.2.0; python_version >= '3.10'
 Requires-Dist: prometheus-client>=0.21.1
 Requires-Dist: psutil>=6.1.1
 Requires-Dist: psycopg>=3.2.9
+Requires-Dist: python-dotenv>=1.1.1
 Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: pyzmq==23.2.1; python_version == '3.9'
 Requires-Dist: pyzmq>=25.1.0; python_version >= '3.10'

{cgse_common-0.16.10.dist-info → cgse_common-0.16.12.dist-info}/RECORD

@@ -8,7 +8,7 @@ egse/counter.py,sha256=7UwBeTAu213xdNdGAOYpUWNQ4jD4yVM1bOG10Ax4UFs,5097
 egse/decorators.py,sha256=B-zRa1WdLO71zqS5M27JBglcThYPho7seYfa4HOGj5c,27171
 egse/device.py,sha256=nn2HkN1KIHAmo37WZcqig-p2mQz1LgqpIfj1wPrUTLc,13240
 egse/dicts.py,sha256=dUAq7PTPvs73OrZb2Fh3loxvYv4ifUiK6bBcgrFU77Y,3972
-egse/env.py,sha256=7HKzb61Mtd5f-kNoN6-Lrik1ZriWkplqE36CnBdRtAM,29074
+egse/env.py,sha256=0z57ESbD9qtJSQiK_7CcpEZm5sxwrKkOMQaJGANmTho,29090
 egse/exceptions.py,sha256=QB3MZRJizecWOj1cPbvG0UcIqFn7NRJ6rw1xtdNSFxw,1225
 egse/heartbeat.py,sha256=xt5mePu9Zr9fLAhN1MLq1Z7aCOKtNIhRVCAmWhtNwP8,3039
 egse/hk.py,sha256=AumSpB8SYXes75CB2iiKXfLkMK5IkVDHITFKrf8IT6g,32010
@@ -28,18 +28,18 @@ egse/response.py,sha256=F04uqOYv1ClpHgDLYZlKTuOCSldHs5TezI_4x6zf2Fw,2717
 egse/scpi.py,sha256=WJ73EaLgRUV6ah1V41l0L7AXI-Dc6Jct7hPHlbbCIcg,15461
 egse/settings.py,sha256=YrRsMUn_IpOVnhTqUGREQUjMw8-AQ6aUBulQiij9MwY,15486
 egse/settings.yaml,sha256=mz9O2QqmiptezsMvxJRLhnC1ROwIHENX0nbnhMaXUpE,190
-egse/setup.py,sha256=1k-5CjzY3_tZ6XCitNOIyZEWyAUC8LqGcnmdKS68vYw,33945
+egse/setup.py,sha256=iWFe3zx4bIkzaUabpbxedteG8qEc3JYHgpu2HjU7s4E,33973
 egse/signal.py,sha256=f5pyOiNW9iTSIxV_ce5stIfG0ub9MRbaekE85kQOVzs,7992
 egse/socketdevice.py,sha256=R8XwYHTH3lFhFngfsGbi_L7bTnTLHxMTEKIF7gmm5rc,7465
 egse/state.py,sha256=HdU2MFOlYRbawYRZmizV6Y8MgnZrUF0bx4fXaYU-M_s,3023
-egse/system.py,sha256=tBlhNoKvop_QpOGQhyhGUBPuAixCDOiClwqeZM-eC4I,75538
+egse/system.py,sha256=3aycoK15UvNdk2yxQ8hx4N-s2Ag4BqTTPQ8eFuJa3Ko,76111
 egse/task.py,sha256=ODSLE05f31CgWsSVcVFFq1WYUZrJMb1LioPTx6VM824,2804
 egse/version.py,sha256=e9GvelUZ9mfCDlRju4MWEJeMHJW9kUzK6SKzJpyj91s,6156
-egse/zmq_ser.py,sha256=d2lETLkLUll_F1Phc1pI7MEeA41uX7YZ8lhSFmBQZVw,3022
+egse/zmq_ser.py,sha256=YJFupsxuvhI8TJMeS2Hem9oMMcVmSBx0rZv93gvN-hA,3263
 egse/plugins/metrics/duckdb.py,sha256=E2eeNo3I7ajRuByodaYiPNvC0Zwyc7hsIlhr1W_eXdo,16148
 egse/plugins/metrics/influxdb.py,sha256=ecxjA_csYwf8RW3sXjiQxZHREfyrfStH1HA_rAs1AA8,6690
 egse/plugins/metrics/timescaledb.py,sha256=Ug0NWDV1Ky2VeFY6tDZL9xg6AFgnAEh2F_llVPnlRBA,21191
-cgse_common-0.16.10.dist-info/METADATA,sha256=X5pqCJ3yD_lj8MFWQnYPPkbmLcY_-Iu0k9niufOMDrY,3033
-cgse_common-0.16.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-cgse_common-0.16.10.dist-info/entry_points.txt,sha256=erQovXd1bGzsngB0_sfY7IYRNwHIhwq3K8fmQvGS12o,198
-cgse_common-0.16.10.dist-info/RECORD,,
+cgse_common-0.16.12.dist-info/METADATA,sha256=NKwp0OrE3-uPhtgcJN2z21aDqPMOIsgIXiQrHIHdZc0,3069
+cgse_common-0.16.12.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+cgse_common-0.16.12.dist-info/entry_points.txt,sha256=erQovXd1bGzsngB0_sfY7IYRNwHIhwq3K8fmQvGS12o,198
+cgse_common-0.16.12.dist-info/RECORD,,

egse/env.py

@@ -42,6 +42,7 @@ locations and settings.
 from __future__ import annotations
 
 __all__ = [
+    "bool_env",
     "env_var",
     "get_conf_data_location",
     "get_conf_data_location_env_name",

egse/setup.py

@@ -117,6 +117,7 @@ from __future__ import annotations
 __all__ = [
     "Setup",
     "setup_ctx",
+    "disentangle_filename",
     "navdict",  # noqa: ignore typo
     "list_setups",
     "load_setup_from_disk",

egse/system.py

@@ -71,19 +71,32 @@ TIME_FORMAT = "%Y-%m-%dT%H:%M:%S.%f%z"
 class Periodic:
     """A timer that periodically invokes a function in the background.
 
-    If no callback is provided, a warning message will be logged. In a future, we might send out an event to the
-    application (will need an event handler).
+    This class schedules a callback to be executed at regular intervals using asyncio.
+    If no callback is provided, a warning message will be logged. If the callback execution
+    takes longer than the interval, and `skip` is True (default), the timer will skip missed
+    intervals to maintain the schedule.
 
-    When the function execution takes longer then the interval there re several options:
-
-    - if skip is True (default) the interval will take precedence and the
     Args:
-        interval: The time between timer events, in seconds.
-        name: A name to assign the event (for debugging), defaults to `Periodic#`.
-        callback: A optional callback to invoke when the event is handled.
-        repeat: The number of times to repeat the timer, or None to repeat forever.
-        skip: Enable skipping of scheduled function calls that couldn't be sent in time.
-        pause: Start the timer paused. Use `resume()` to activate the timer.
+        interval (float): The time between timer events, in seconds.
+        name (str, optional): A name to assign the event (for debugging), defaults to `Periodic#`.
+        callback (Callable, optional): A callback to invoke when the event is handled.
+        repeat (int, optional): The number of times to repeat the timer, or None to repeat forever.
+        skip (bool, optional): Enable skipping of scheduled function calls that couldn't be sent in time.
+        pause (bool, optional): Start the timer paused. Use `resume()` to activate the timer.
+
+    Methods:
+        start(): Start the timer.
+        stop(): Stop the timer.
+        is_running(): Return True if the timer is running.
+        is_paused(): Return True if the timer is paused.
+        pause(): Pause the timer.
+        reset(): Reset the timer to start from the beginning.
+        resume(): Resume a paused timer.
+
+    Note:
+        The timer runs asynchronously and is suitable for use in asyncio-based applications.
+        If the callback is a coroutine, it will be awaited.
+
     """
 
     _periodic_count: int = 0

egse/zmq_ser.py

@@ -44,17 +44,26 @@ def recv_zipped_pickle(socket, flags=0, protocol=-1):
     return pickle.loads(p)
 
 
-def get_port_number(socket: zmq.Socket) -> int | None:
+def get_port_number(socket: zmq.Socket | None) -> int:
     """
-    Returns the port number associated with this socket. Returns None for sockets
-    that do not bind to a TCP or IPC transport.
+    Returns the port number associated with this socket.
+
+    If the socket is bound to a TCP or IPC transport, the port number is extracted from the
+    LAST_ENDPOINT socket option.
+
+    Returns:
+        - 0 for sockets that do not bound to a TCP or IPC transport.
+        - 0 if the socket is None.
     """
+    if socket is None:
+        return 0
+
     endpoint = socket.getsockopt(zmq.LAST_ENDPOINT)
-    if endpoint:
+    if endpoint and isinstance(endpoint, bytes):
         port = endpoint.decode("utf-8").split(":")[-1]
         return int(port)
     else:
-        return None
+        return 0
 
 
 def zmq_string_request(request: str) -> list: