f40-sdk 0.1.0__tar.gz

f40_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 40-Factory
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

f40_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: f40-sdk
+Version: 0.1.0
+Summary: SDK clients for MAT platform services (Auth Manager, Data Manager, AI Agents, CMMS, Wilson).
+Author-email: 40F ECSD <m.domenicale@40-factory.com>
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: f40-toolkit>=1.3.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: key-vault-interface==1.0.8
+Provides-Extra: cache-redis
+Requires-Dist: f40-toolkit[cache-redis]>=1.3.0; extra == "cache-redis"
+Provides-Extra: bsw
+Requires-Dist: numpy>=1.24; extra == "bsw"
+Requires-Dist: tzdata>=2023.3; extra == "bsw"
+Provides-Extra: all
+Requires-Dist: f40-toolkit[cache-redis]>=1.3.0; extra == "all"
+Requires-Dist: numpy>=1.24; extra == "all"
+Requires-Dist: tzdata>=2023.3; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: mypy>=1.11; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# README #
+
+This README would normally document whatever steps are necessary to get your application up and running.
+
+### What is this repository for? ###
+
+* Quick summary
+* Version
+* [Learn Markdown](https://bitbucket.org/tutorials/markdowndemo)
+
+### How do I get set up? ###
+
+* Summary of set up
+* Configuration
+* Dependencies
+* Database configuration
+* How to run tests
+* Deployment instructions
+
+### Contribution guidelines ###
+
+* Writing tests
+* Code review
+* Other guidelines
+
+### Who do I talk to? ###
+
+* Repo owner or admin
+* Other community or team contact

f40_sdk-0.1.0/README.md

@@ -0,0 +1,29 @@
+# README #
+
+This README would normally document whatever steps are necessary to get your application up and running.
+
+### What is this repository for? ###
+
+* Quick summary
+* Version
+* [Learn Markdown](https://bitbucket.org/tutorials/markdowndemo)
+
+### How do I get set up? ###
+
+* Summary of set up
+* Configuration
+* Dependencies
+* Database configuration
+* How to run tests
+* Deployment instructions
+
+### Contribution guidelines ###
+
+* Writing tests
+* Code review
+* Other guidelines
+
+### Who do I talk to? ###
+
+* Repo owner or admin
+* Other community or team contact

f40_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,80 @@
+[project]
+name = "f40-sdk"
+version = "0.1.0"
+description = "SDK clients for MAT platform services (Auth Manager, Data Manager, AI Agents, CMMS, Wilson)."
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "40F ECSD", email = "m.domenicale@40-factory.com" }]
+
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries",
+]
+
+# Core building blocks come from f40-toolkit; httpx is needed because the SDK
+# always performs HTTP requests (f40_toolkit.common.http imports it lazily).
+dependencies = [
+    "f40-toolkit>=1.3.0",
+    "httpx>=0.27",
+    "key-vault-interface==1.0.8",
+]
+
+[project.optional-dependencies]
+# Redis-backed cache wiring in MatDataManagerClient (delegates to f40-toolkit's cache).
+cache-redis = ["f40-toolkit[cache-redis]>=1.3.0"]
+
+# The centralized BSW framework (`f40_sdk.mat`) vendors a slice of mat_utilities
+# (calculator / data_frame / dt) that needs numpy at runtime. Timezones use the
+# stdlib `zoneinfo` (Python >= 3.9) instead of pytz; `tzdata` provides the IANA
+# database where the OS doesn't ship one (Windows, slim containers). pandas is
+# optional (data_frame.core imports it in a try/except for `.to_pandas()` only).
+bsw = ["numpy>=1.24", "tzdata>=2023.3"]
+
+# NOTE: `mat_utilities` (MatDataFrame / MatCmmsHierarchy) is an internal package, not
+# declared here — read_tables / get_hierarchy import it lazily and fall back gracefully.
+
+all = ["f40-toolkit[cache-redis]>=1.3.0", "numpy>=1.24", "tzdata>=2023.3"]
+
+dev = [
+    "pytest>=8",
+    "mypy>=1.11",
+    "ruff>=0.6",
+    "build>=1.2",
+    "twine>=5.0",
+]
+
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["f40_sdk*"]
+
+[tool.setuptools.package-data]
+"f40_sdk" = ["py.typed"]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I"]
+
+[tool.mypy]
+files = ["src"]
+python_version = "3.12"
+ignore_missing_imports = true
+warn_unused_ignores = false
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

f40_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

f40_sdk-0.1.0/src/f40_sdk/__init__.py

@@ -0,0 +1,48 @@
+"""
+f40_sdk — SDK clients for the MAT Auth Manager, Data Manager and related services.
+
+Built on the dependency-light HTTP building block in :mod:`f40_toolkit.common.http`
+(a dependency of this package). Those primitives are re-exported here under their
+historical ``Mat*`` names for convenience:
+
+    MatHttpClient -> f40_toolkit.common.http.HttpClient
+    MatHttpToken  -> f40_toolkit.common.http.BearerToken
+    MatHttpError  -> f40_toolkit.common.http.HttpError
+    MatAuthError  -> f40_toolkit.common.http.HttpAuthError
+
+Requires: ``pip install f40-sdk``
+
+Quick imports
+-------------
+    from f40_sdk import MatDataManagerClient, MatAuthManagerClient
+    from f40_sdk import MatHttpClient, MatBasicClient   # building blocks
+    from f40_sdk import MatHttpError                    # exception
+"""
+
+from f40_toolkit.common.http import BearerToken as MatHttpToken
+from f40_toolkit.common.http import HttpAuthError as MatAuthError
+from f40_toolkit.common.http import HttpClient as MatHttpClient
+from f40_toolkit.common.http import HttpError as MatHttpError
+from .clients import (
+    MatAiAgentsMngClient,
+    MatAuthManagerClient,
+    MatBasicClient,
+    MatCmmsMngClient,
+    MatCompData,
+    MatDataManagerClient,
+    WilsonMngClient,
+)
+
+__all__ = [
+    "MatHttpClient",
+    "MatBasicClient",
+    "MatHttpToken",
+    "MatAuthManagerClient",
+    "MatDataManagerClient",
+    "MatCompData",
+    "MatAiAgentsMngClient",
+    "MatCmmsMngClient",
+    "WilsonMngClient",
+    "MatHttpError",
+    "MatAuthError",
+]

f40_sdk-0.1.0/src/f40_sdk/clients/__init__.py

@@ -0,0 +1,19 @@
+"""Service SDK clients for the MAT platform."""
+
+from .ai_agents import MatAiAgentsMngClient
+from .auth_manager import MatAuthManagerClient
+from .base import MatBasicClient
+from .cmms import MatCmmsMngClient
+from .data_manager import MatDataManagerClient
+from .models import MatCompData
+from .wilson import WilsonMngClient
+
+__all__ = [
+    "MatBasicClient",
+    "MatAuthManagerClient",
+    "MatDataManagerClient",
+    "MatCompData",
+    "MatAiAgentsMngClient",
+    "MatCmmsMngClient",
+    "WilsonMngClient",
+]

f40_sdk-0.1.0/src/f40_sdk/clients/ai_agents.py

@@ -0,0 +1,61 @@
+"""
+SDK client for the MAT AI-Agents (IoT-Agents) service.
+
+Auth is handled by the parent :class:`MatBasicClient` (auth_mng / basic /
+bearer_token / env_name). This client adds the agent listing and invocation API.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+from typing import TYPE_CHECKING, List, Optional, Union
+
+from .base import MatBasicClient
+
+if TYPE_CHECKING:
+    from key_vault_interface.key_vault_interface import KeyVaultInterface  # type: ignore[import]
+
+logger = logging.getLogger(__name__)
+
+
+class MatAiAgentsMngClient(MatBasicClient):
+    """SDK client for the MAT AI-Agents service."""
+
+    def get_agents(self) -> List[dict]:
+        """Return the list of agents (empty list when none / unexpected shape)."""
+        res = self._send("GET", "iota/agents")
+        if isinstance(res, dict):
+            res = res.get("agents")
+        return res if isinstance(res, list) else []
+
+    def run_agent(self, agent_id: str, run_message: str) -> None:
+        """Invoke an agent with an alert message."""
+        self._send(
+            "POST", f"iota/agents/invoke/{agent_id}",
+            data=json.dumps({"alertMessage": run_message}), res_type="code",
+        )
+
+    @classmethod
+    def from_json(  # type: ignore[override]
+        cls,
+        _json: Union[dict, str],
+        kvi: Optional["KeyVaultInterface"] = None,
+    ) -> "MatAiAgentsMngClient":
+        """
+        Construct from a config dict or a path to a JSON file.
+
+        The JSON may have the config nested under an ``"ai_agents"`` key::
+
+            {"ai_agents": {"url": "...", "auth": {...}}}
+        """
+        if isinstance(_json, str):
+            with open(_json, "r") as fh:
+                _json = json.load(fh)
+            if isinstance(_json, dict) and "ai_agents" in _json:
+                _json = _json["ai_agents"]
+
+        if not isinstance(_json, dict):
+            raise TypeError(f"Expected a dict or JSON file path, got {type(_json).__name__}.")
+
+        return cls.from_dict(_json, kvi=kvi)