plesty-lib 0.2.4__tar.gz → 0.2.6__tar.gz

plesty_lib-0.2.6/.gitlab-ci.yml

@@ -0,0 +1,24 @@
+workflow:
+  rules:
+    # Create pipelines for merge requests
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    # Create branch pipelines for main and exp
+    - if: $CI_COMMIT_BRANCH == "main"
+    - if: $CI_COMMIT_BRANCH == "exp"
+    # Create pipelines for tags (dev and stable releases)
+    - if: $CI_COMMIT_TAG
+    # Otherwise do not create a pipeline
+    - when: never
+
+stages:
+  - check
+  - security
+  - deploy
+  - release
+
+include:
+  - component: $CI_SERVER_FQDN/plesty/plesty-ci/plesty-standard-ci@exp
+    inputs:
+      standard: quantum
+      extra_branch: exp
+      access_token: $CI_BOT_TOKEN

plesty_lib-0.2.6/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## Unreleased — 2026-06-25
+
+- Add `FuncMeta` and `SCPISolver.solve_func` for schema-driven operation dispatch
+- Fix mypy type annotations across all public modules
+- Migrate CI pipeline to `plesty-standard-ci@exp`

{plesty_lib-0.2.4 → plesty_lib-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plesty-lib
-Version: 0.2.4
+Version: 0.2.6
 Summary: A library for the Plesty ecosystem.
 Author-email: Yunshuang Yuan <yunshuang.yuan@fkp.uni-hannover.de>
 Maintainer-email: Plesty Development Team <yunshuang.yuan@fkp.uni-hannover.de>
@@ -69,6 +69,7 @@ class PowermeterDevice(BaseVisaScpiDevice):
 ### 2. Use the device
 
 ```python
+# replace the serial number P0000001 with that of your own device
 address = "USB0::0x1313::0x8078::P0000001::INSTR"
 
 with PowermeterDevice(address) as dev:

{plesty_lib-0.2.4 → plesty_lib-0.2.6}/README.md

@@ -52,6 +52,7 @@ class PowermeterDevice(BaseVisaScpiDevice):
 ### 2. Use the device
 
 ```python
+# replace the serial number P0000001 with that of your own device
 address = "USB0::0x1313::0x8078::P0000001::INSTR"
 
 with PowermeterDevice(address) as dev:

plesty_lib-0.2.6/gl-secret-detection-report.json

@@ -0,0 +1,50 @@
+{
+  "scan": {
+    "analyzer": {
+      "id": "secrets",
+      "name": "secrets",
+      "url": "https://gitlab.com/gitlab-org/security-products/analyzers/secrets",
+      "vendor": {
+        "name": "GitLab"
+      },
+      "version": "7.37.0"
+    },
+    "scanner": {
+      "id": "gitleaks",
+      "name": "Gitleaks",
+      "url": "https://github.com/gitleaks/gitleaks",
+      "vendor": {
+        "name": "GitLab"
+      },
+      "version": "8.30.1"
+    },
+    "type": "secret_detection",
+    "start_time": "2026-06-26T14:45:00",
+    "end_time": "2026-06-26T14:45:01",
+    "status": "success",
+    "observability": {
+      "events": [
+        {
+          "event": "collect_secrets_analyzer_scan_metrics_from_pipeline",
+          "time_s": 0.483231567,
+          "exit_code": 0,
+          "git_strategy": "FetchShallow",
+          "repo_size_kb": 1260,
+          "commit_count": 1,
+          "bytes_scanned": 23,
+          "pipeline_type": "Tag"
+        },
+        {
+          "event": "collect_secrets_analyzer_ruleset_adoption_metrics_from_pipeline",
+          "custom_ruleset": false,
+          "passthrough_types": null,
+          "passthrough_count": 0,
+          "passthrough_auth_used": false,
+          "rules_version": "0.24.3"
+        }
+      ]
+    }
+  },
+  "version": "15.2.4",
+  "vulnerabilities": []
+}

{plesty_lib-0.2.4 → plesty_lib-0.2.6}/plesty/lib/data/array.py

@@ -16,7 +16,7 @@ from typing import List, Dict, Any, Tuple, Optional
 from .units import Units
 
 
-class _PlestyArrayMeta(type(np.ndarray)):
+class _PlestyArrayMeta(type(np.ndarray)):  # type: ignore[misc]
     """Forward NumPy top-level callables as class methods for PlestyArray.
 
     Example:
@@ -81,7 +81,13 @@ class PlestyArray(np.ndarray, metaclass=_PlestyArrayMeta):
     _META_KEYS = {"name", "range", "options", "unit", "description"}
     __array_priority__ = 1000
 
-    def update_meta(self, **kwargs):
+    name: Optional[str]
+    range: Optional[Tuple[float, float] | Tuple[int, int]]
+    options: Optional[List[Any]]
+    unit: Optional[str]
+    description: Optional[str]
+
+    def update_meta(self, **kwargs) -> None:
         """Update meta information for the PlestyArray.
 
         Example:
@@ -141,12 +147,8 @@ class PlestyArray(np.ndarray, metaclass=_PlestyArrayMeta):
         }
 
     @classmethod
-    def _split_meta_kwargs(
-        cls, kwargs: Dict[str, Any]
-    ) -> Tuple[Dict[str, Any], Dict[str, Any]]:
-        meta_kwargs = {
-            k: kwargs.pop(k) for k in list(kwargs.keys()) if k in cls._META_KEYS
-        }
+    def _split_meta_kwargs(cls, kwargs: Dict[str, Any]) -> Tuple[Dict[str, Any], Dict[str, Any]]:
+        meta_kwargs = {k: kwargs.pop(k) for k in list(kwargs.keys()) if k in cls._META_KEYS}
         return kwargs, meta_kwargs
 
     @classmethod
@@ -176,7 +178,7 @@ class PlestyArray(np.ndarray, metaclass=_PlestyArrayMeta):
         description: Optional[str] = None,
     ):
         """Create a new PlestyArray instance with optional metadata."""
-        obj = np.asarray(input_array).view(cls)
+        obj: "PlestyArray" = np.asarray(input_array).view(cls)  # type: ignore[assignment]
         obj.name = name
         obj.range = range
         obj.options = options
@@ -205,9 +207,7 @@ class PlestyArray(np.ndarray, metaclass=_PlestyArrayMeta):
                 x.view(np.ndarray) if isinstance(x, PlestyArray) else x for x in out
             )
 
-        np_inputs = tuple(
-            x.view(np.ndarray) if isinstance(x, PlestyArray) else x for x in inputs
-        )
+        np_inputs = tuple(x.view(np.ndarray) if isinstance(x, PlestyArray) else x for x in inputs)
 
         result = getattr(ufunc, method)(*np_inputs, **kwargs)
 
@@ -246,9 +246,7 @@ class PlestyArray(np.ndarray, metaclass=_PlestyArrayMeta):
                         right_scale = right_expr.conversion_scale_to(left_expr)
                         np_inputs_scaled = list(np_inputs)
                         np_inputs_scaled[1] = np_inputs_scaled[1] * right_scale
-                        result = getattr(ufunc, method)(
-                            *tuple(np_inputs_scaled), **kwargs
-                        )
+                        result = getattr(ufunc, method)(*tuple(np_inputs_scaled), **kwargs)
                         meta["unit"] = Units.standardize(left.unit)
                     else:
                         lu = left.unit or "-"
@@ -286,11 +284,7 @@ class PlestyArray(np.ndarray, metaclass=_PlestyArrayMeta):
                             meta["unit"] = f"({lu})^({ru})"
                     else:
                         lu = left.unit or "-"
-                        ru = (
-                            right.unit
-                            if isinstance(right, PlestyArray) and right.unit
-                            else "-"
-                        )
+                        ru = right.unit if isinstance(right, PlestyArray) and right.unit else "-"
                         meta["unit"] = f"({lu})^({ru})"
 
             elif isinstance(left, PlestyArray) and np.isscalar(right):
@@ -313,12 +307,9 @@ class PlestyArray(np.ndarray, metaclass=_PlestyArrayMeta):
         if source is None:
             source = self._find_meta_source(kwargs.values()) if kwargs else None
 
-        np_args = tuple(
-            a.view(np.ndarray) if isinstance(a, PlestyArray) else a for a in args
-        )
+        np_args = tuple(a.view(np.ndarray) if isinstance(a, PlestyArray) else a for a in args)
         np_kwargs = {
-            k: (v.view(np.ndarray) if isinstance(v, PlestyArray) else v)
-            for k, v in kwargs.items()
+            k: (v.view(np.ndarray) if isinstance(v, PlestyArray) else v) for k, v in kwargs.items()
         }
 
         result = func(*np_args, **np_kwargs)

{plesty_lib-0.2.4 → plesty_lib-0.2.6}/plesty/lib/data/ctype_manager.py

@@ -8,6 +8,7 @@
 
 import ctypes as ct
 from ctypes import POINTER
+from typing import Any
 
 
 class CtypeParam:
@@ -20,7 +21,7 @@ class CtypeParam:
         self.ptype = self.get_pytype(ctype_str) if ptype is None else ptype
         self.ctype = self.get_ctype(ctype_str)
 
-    def get_pytype(self, ctype_str):
+    def get_pytype(self, ctype_str: str) -> type:
         """Map a string representation of a C type to an actual ctypes type."""
         self.pytype_mapping = {
             "c_int": int,
@@ -35,15 +36,13 @@ class CtypeParam:
             "c_unsigned char": int,
         }
 
-        clean_ctype_str = (
-            ctype_str.replace("*", "").replace("ref", "").replace("ptr", "").strip()
-        )
+        clean_ctype_str = ctype_str.replace("*", "").replace("ref", "").replace("ptr", "").strip()
         if clean_ctype_str in self.pytype_mapping:
             return self.pytype_mapping[clean_ctype_str]
         else:
             raise ValueError(f"Unsupported C type for Python mapping: {ctype_str}")
 
-    def get_ctype(self, ctype_str):
+    def get_ctype(self, ctype_str: str) -> Any:
         """Map a string representation of a C type to an actual ctypes type."""
         ctype_mapping = {
             "c_int": ct.c_int,
@@ -70,13 +69,13 @@ class CtypeParam:
         else:
             raise ValueError(f"Unsupported C type: {ctype_str}")
 
-    def to_pytype(self):
+    def to_pytype(self) -> Any:
         """Convert the C type value to its corresponding Python type."""
         if self.ptype is None:
             raise ValueError("Python type mapping is not defined for this C type.")
         return self.ptype(self.value)
 
-    def to_ctype(self):
+    def to_ctype(self) -> Any:
         """Convert the Python value to its corresponding C type."""
         if self.ctype is None:
             raise ValueError("C type mapping is not defined for this value.")

{plesty_lib-0.2.4 → plesty_lib-0.2.6}/plesty/lib/data/table.py

@@ -10,6 +10,7 @@ in a structured way.
 """
 
 from dataclasses import dataclass
+from typing import Any
 from .array import PlestyArray
 
 
@@ -18,7 +19,7 @@ class TableHeader:
     """Represents the header of a PlestyTable, defining column names and types."""
 
     name: str
-    dtype: type | None = None
+    dtype: Any = None
     unit: str | None = None
     description: str | None = None
 

{plesty_lib-0.2.4 → plesty_lib-0.2.6}/plesty/lib/data/types.py

@@ -16,7 +16,7 @@ from .table import PlestyTable2D
 from .ctype_manager import CtypeParam
 
 
-def resolve_dtype(dtype: Any) -> type | None:
+def resolve_dtype(dtype: Any) -> type[Any] | CtypeParam | None:
     """Resolve schema dtype strings into Python types.
 
     Supports scalar aliases and array types in the form array_<numpy_dtype>,
@@ -26,7 +26,7 @@ def resolve_dtype(dtype: Any) -> type | None:
         return dtype
 
     dtype_str = str(dtype).strip().lower()
-    aliases = {
+    aliases: dict[str, type[Any]] = {
         "str": str,
         "string": str,
         "int": int,
@@ -58,9 +58,7 @@ def resolve_dtype(dtype: Any) -> type | None:
             np.dtype(item_token)
             return PlestyArray
         except TypeError as exc:
-            raise ValueError(
-                f"Unsupported numpy dtype token in array type: {dtype!r}"
-            ) from exc
+            raise ValueError(f"Unsupported numpy dtype token in array type: {dtype!r}") from exc
 
     raise ValueError(f"Unsupported dtype in schema: {dtype!r}")
 
@@ -88,7 +86,7 @@ def normalize_shape(shape: Any) -> tuple[Any, ...] | None:
     return tuple(shape)
 
 
-def istype(value, dtype):
+def istype(value: Any, dtype: Any) -> bool:
     """Check if a value is of a specified data type, including basic and iterable types."""
     if dtype in [int, float, str, bool]:
         return isinstance(value, dtype)
@@ -103,11 +101,9 @@ def istype(value, dtype):
     return False
 
 
-def cast_basic_type(value, dtype):
+def cast_basic_type(value: Any, dtype: Any) -> Any:
     """Cast a value to the given basic type, raising ValueError on failure."""
     try:
         return dtype(value)
     except Exception as e:
-        raise ValueError(
-            f"Value {value} cannot be cast to expected type {dtype.__name__}: {e}"
-        )
+        raise ValueError(f"Value {value} cannot be cast to expected type {dtype.__name__}: {e}")

{plesty_lib-0.2.4 → plesty_lib-0.2.6}/plesty/lib/data/units.py

@@ -7,7 +7,7 @@
 """Unit parsing, composition, and conversion utilities for Plesty."""
 
 import re
-from typing import Dict, Optional
+from typing import Any, Dict, Optional
 
 
 class Units:
@@ -18,7 +18,7 @@ class Units:
     - ``factor``: numeric scaling factor to SI base units
     """
 
-    SYMBOLS = {
+    SYMBOLS: dict[str, dict[str, Any]] = {
         # length
         "km": {"dim": "L", "factor": 1.0e3},
         "m": {"dim": "L", "factor": 1.0},
@@ -92,12 +92,12 @@ class Units:
                 i += 2
 
             applied_exp = sign * exponent
-            dim = entry["dim"]
+            dim: str = str(entry["dim"])
             dims[dim] = dims.get(dim, 0) + applied_exp
             if dims[dim] == 0:
                 dims.pop(dim)
 
-            factor *= entry["factor"] ** applied_exp
+            factor *= float(entry["factor"]) ** applied_exp
             sign = 1
             i += 1
 
@@ -167,9 +167,7 @@ class Units:
                 numerator.append(symbol if power == 1 else f"{symbol}^{power}")
             else:
                 pos_power = -power
-                denominator.append(
-                    symbol if pos_power == 1 else f"{symbol}^{pos_power}"
-                )
+                denominator.append(symbol if pos_power == 1 else f"{symbol}^{pos_power}")
 
         num_text = "*".join(numerator) if numerator else "1"
         if not denominator:

{plesty_lib-0.2.4 → plesty_lib-0.2.6}/plesty/lib/device/async_wrapper.py

@@ -11,6 +11,7 @@ import threading
 import weakref
 from queue import Queue
 from functools import wraps
+from typing import Any
 import inspect
 
 
@@ -28,7 +29,7 @@ class AsyncWrapperBase:
         ``async def _call(self, func, *args, **kwargs)``
     """
 
-    _registry = weakref.WeakKeyDictionary()
+    _registry: weakref.WeakKeyDictionary[Any, Any] = weakref.WeakKeyDictionary()
 
     def __new__(cls, obj):
         """Return the existing wrapper for obj if one exists, otherwise create a new one."""
@@ -66,7 +67,7 @@ class AsyncWrapperBase:
                 return attr  # already async
 
             @wraps(attr)
-            async def async_method(*args, timeout=None, **kwargs):
+            async def async_method(*args: Any, timeout: Any = None, **kwargs: Any) -> Any:
                 coro = self._call(attr, *args, **kwargs)
                 if timeout is not None:
                     return await asyncio.wait_for(coro, timeout)
@@ -240,7 +241,7 @@ class AsyncDeviceThread:
         - When the underlying API is already fully asynchronous.
     """
 
-    _registry = weakref.WeakKeyDictionary()  # optional singleton per device
+    _registry: weakref.WeakKeyDictionary[Any, Any] = weakref.WeakKeyDictionary()
 
     def __new__(cls, device):
         """Return the existing wrapper for device if one exists, otherwise create a new one."""