ignition-api 8.3.6.post2__tar.gz → 8.3.7__tar.gz

{ignition_api-8.3.6.post2 → ignition_api-8.3.7}/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 8.3.7 (2026-06-10)
+
+### Feat
+
+- **system**: add secrets module (#41)
+
+### Refactor
+
+- **ia**: use Any as argument instead of PyObject (#33)
+
 ## 8.3.6.post2 (2026-05-28)
 
 ### Refactor

{ignition_api-8.3.6.post2 → ignition_api-8.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ignition_api
-Version: 8.3.6.post2
+Version: 8.3.7
 Summary: Ignition Scripting API
 Home-page: https://github.com/ignition-devs/ignition-api
 Author: César Román

{ignition_api-8.3.6.post2 → ignition_api-8.3.7}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = ignition_api
-version = 8.3.6.post2
+version = 8.3.7
 description = Ignition Scripting API
 long_description = file: README.md
 long_description_content_type = text/markdown

{ignition_api-8.3.6.post2 → ignition_api-8.3.7}/src/com/inductiveautomation/ignition/common/script/abc/__init__.py

@@ -5,6 +5,7 @@ __all__ = [
     "AbstractJythonSequence",
     "AbstractMutableJythonMap",
     "AbstractMutableJythonSequence",
+    "ContextManager",
     "JythonMap",
     "JythonSequence",
     "MutableJythonMap",
@@ -280,3 +281,17 @@ class AbstractMutableJythonSequence(AbstractJythonSequence, MutableJythonSequenc
     def sort(self, *args, **kwargs):
         # type: (*Any, **Union[str, unicode]) -> None
         pass
+
+
+class ContextManager(PyObject):
+    def __init__(self):
+        # type: () -> None
+        super(ContextManager, self).__init__()
+
+    def __enter__(self):
+        # type: () -> None
+        print("Enter")
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        # type: (object, object, object) -> None
+        print("Exit")

ignition_api-8.3.7/src/com/inductiveautomation/ignition/common/secrets/__init__.py

@@ -0,0 +1,66 @@
+from __future__ import print_function
+
+from typing import Union
+
+from java.lang import Record
+
+from com.inductiveautomation.ignition.common.script.abc import ContextManager
+from com.inductiveautomation.ignition.gateway.secrets import Plaintext
+
+
+class PyPlaintext(ContextManager):
+    def __init__(self, plaintext):
+        # type: (Plaintext) -> None
+        super(PyPlaintext, self).__init__()
+
+    def clear(self):
+        # type: () -> None
+        pass
+
+    def getSecretsAsBytes(self):
+        # type: () -> bytearray
+        pass
+
+    def getSecretsAsString(self, charsetName=None):
+        # type: (Union[str, unicode, None]) -> Union[str, unicode]
+        pass
+
+
+class SecretMeta(Record):
+    def __init__(
+        self,
+        name,  # type: Union[str, unicode]
+    ):
+        # type: (...) -> None
+        super(SecretMeta, self).__init__()
+        self._name = name
+
+    def name(self):
+        # type: () -> Union[str, unicode]
+        return self._name
+
+
+class SecretProviderMeta(Record):
+    def __init__(
+        self,
+        name,  # type: Union[str, unicode]
+        description,  # type: Union[str, unicode]
+        type_,  # type: Union[str, unicode]
+    ):
+        # type: (...) -> None
+        super(SecretProviderMeta, self).__init__()
+        self._name = name
+        self._description = description
+        self._type = type_
+
+    def description(self):
+        # type: () -> Union[str, unicode]
+        return self._description
+
+    def name(self):
+        # type: () -> Union[str, unicode]
+        return self._name
+
+    def type(self):
+        # type: () -> Union[str, unicode]
+        return self._type

ignition_api-8.3.7/src/com/inductiveautomation/ignition/gateway/secrets/__init__.py

@@ -0,0 +1,37 @@
+from typing import Optional, Union
+
+from java.io import Closeable
+from java.lang import Object
+from java.nio.charset import Charset
+
+
+class Plaintext(Object, Closeable):
+    def __init__(self):
+        # type: () -> None
+        super(Plaintext, self).__init__()
+
+    def clear(self):
+        # type: () -> None
+        pass
+
+    def close(self):
+        # type: () -> None
+        pass
+
+    @staticmethod
+    def fromBytes(bytes):
+        # type: (bytearray) -> Plaintext
+        return Plaintext()
+
+    @staticmethod
+    def fromString(str, charset=None):
+        # type: (Union[str, unicode], Optional[Charset]) -> Plaintext
+        return Plaintext()
+
+    def getAsString(self):
+        # type: () -> Union[str, unicode]
+        pass
+
+    def getBytes(self):
+        # type: () -> bytearray
+        pass

{ignition_api-8.3.6.post2 → ignition_api-8.3.7}/src/ignition_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ignition-api
-Version: 8.3.6.post2
+Version: 8.3.7
 Summary: Ignition Scripting API
 Home-page: https://github.com/ignition-devs/ignition-api
 Author: César Román

{ignition_api-8.3.6.post2 → ignition_api-8.3.7}/src/ignition_api.egg-info/SOURCES.txt

@@ -83,6 +83,7 @@ src/com/inductiveautomation/ignition/common/script/builtin/http/__init__.py
 src/com/inductiveautomation/ignition/common/script/builtin/ialabs/__init__.py
 src/com/inductiveautomation/ignition/common/script/hints/__init__.py
 src/com/inductiveautomation/ignition/common/script/message/__init__.py
+src/com/inductiveautomation/ignition/common/secrets/__init__.py
 src/com/inductiveautomation/ignition/common/sqltags/__init__.py
 src/com/inductiveautomation/ignition/common/sqltags/history/__init__.py
 src/com/inductiveautomation/ignition/common/sqltags/history/annotations/__init__.py
@@ -105,6 +106,7 @@ src/com/inductiveautomation/ignition/common/xmlserialization/serialization/__ini
 src/com/inductiveautomation/ignition/common/xmlserialization/serialization/equalitydelegates/__init__.py
 src/com/inductiveautomation/ignition/gateway/__init__.py
 src/com/inductiveautomation/ignition/gateway/project/__init__.py
+src/com/inductiveautomation/ignition/gateway/secrets/__init__.py
 src/com/inductiveautomation/ignition/modules/__init__.py
 src/com/inductiveautomation/ignition/modules/serial/__init__.py
 src/com/inductiveautomation/ignition/modules/serial/scripting/__init__.py
@@ -204,6 +206,7 @@ src/system/print.py
 src/system/project.py
 src/system/report.py
 src/system/roster.py
+src/system/secrets.py
 src/system/secsgem.py
 src/system/security.py
 src/system/serial.py

{ignition_api-8.3.6.post2 → ignition_api-8.3.7}/src/system/db.py

@@ -68,7 +68,6 @@ __all__ = [
     "runPrepUpdate",
     "runSFPrepUpdate",
     "runScalarPrepQuery",
-    "runUpdateQuery",
     "setDatasourceConnectURL",
     "setDatasourceEnabled",
     "setDatasourceMaxConnections",
@@ -714,52 +713,6 @@ def runScalarPrepQuery(
     return 42
 
 
-def runUpdateQuery(
-    query,  # type: Union[str, unicode]
-    database="",  # type: Union[str, unicode]
-    tx=None,  # type: Union[str, unicode, None]
-    getKey=False,  # type: bool
-    skipAudit=True,  # type: bool
-):
-    # type: (...) -> int
-    """Runs a query against a database connection, returning the number
-    of rows affected.
-
-    Typically this is an UPDATE, INSERT, or DELETE query. If no database
-    is specified, or the database is the empty-string "", then the
-    current project's default database connection will be used.
-
-    Note:
-        You may want to use the runPrepUpdate query if your query is
-        constructed with user input (to avoid the user's input from
-        breaking your syntax) or if you need to insert binary or BLOB
-        data.
-
-    Args:
-        query: A SQL query, usually an INSERT, UPDATE, or DELETE query,
-            to run.
-        database: The name of the database connection to execute
-            against. If omitted or "", the project's default database
-            connection will be used.
-        tx: A transaction identifier. If omitted, the update will be
-            executed in its own transaction.
-        getKey: A flag indicating whether or not the result should be
-            the number of rows returned (getKey=0) or the newly
-            generated key value that was created as a result of the
-            update (getKey=1). Not all databases support automatic
-            retrieval of generated keys.
-        skipAudit: A flag which, if set to True, will cause the update
-            query to skip the audit system. Useful for some queries that
-            have fields which won't fit into the audit log.
-
-    Returns:
-        The number of rows affected by the query, or the key value that
-        was generated, depending on the value of the getKey flag.
-    """
-    print(query, database, tx, getKey, skipAudit)
-    return 1
-
-
 def setDatasourceConnectURL(name, connectUrl):
     # type: (Union[str, unicode], Union[str, unicode]) -> None
     """Changes the connect URL for a given database connection.

ignition_api-8.3.7/src/system/secrets.py

@@ -0,0 +1,113 @@
+"""Secrets Functions.
+
+The following functions are used to interact with encrypted secrets for
+Secret Providers on the Gateway.
+"""
+
+from __future__ import print_function
+
+__all__ = [
+    "decrypt",
+    "encrypt",
+    "getProviders",
+    "getSecrets",
+    "readSecretValue",
+]
+
+from typing import Any, Dict, List, Union
+
+from com.inductiveautomation.ignition.common.secrets import (
+    PyPlaintext,
+    SecretMeta,
+    SecretProviderMeta,
+)
+from com.inductiveautomation.ignition.gateway.secrets import Plaintext
+
+
+def decrypt(json):
+    # type: (Any) -> PyPlaintext
+    """Decrypts the given JSON object containing an encrypted secret
+    using the system encryption service.
+
+    Args:
+        json: The JSON object containing the encrypted secret to
+            decrypt.
+
+    Returns:
+        The decrypted value of the JSON string.
+    """
+    return PyPlaintext(Plaintext.fromString(json))
+
+
+def encrypt(*args):
+    # type: (*Any) -> Dict[Union[str, unicode], Any]
+    """Encrypts supplied data using the Secrets Management system
+    encryption service and returns a JSON object containing the
+    encrypted secret.
+
+    Args:
+        *args: Variable length argument list.
+
+    Returns:
+        A PyDictionary containing the encrypted secret or None if the
+        JSON is empty.
+    """
+    return {
+        "ciphertext": None,
+        "encrypted_key": None,
+        "iv": None,
+        "protected": True,
+        "tag": None,
+    }
+
+
+def getProviders():
+    # type: () -> List[SecretProviderMeta]
+    """Returns a list of Secret Providers configured in the Secrets
+    Management system on the Gateway. Each list entry includes the name,
+    description, and type of the provider.
+
+    Returns:
+        A List of SecretProviderMeta instances that represent all of
+        the Secret Providers.
+    """
+    return [
+        SecretProviderMeta(
+            "SecretProviderName", "SecretProviderDescription", "SecretProviderType"
+        )
+    ]
+
+
+def getSecrets(providerName):
+    # type: (Union[str, unicode]) -> List[SecretMeta]
+    """Returns a list of objects representing all secrets available for
+    the named Secret Provider.
+
+    Each list entry includes the name of the secret.
+
+    Args:
+        providerName: The name of the Secret Provider to fetch secrets
+            from.
+
+    Returns:
+        A list of SecretMeta instances that represent all secret names.
+    """
+    print(providerName)
+    return [SecretMeta("SecretName")]
+
+
+def readSecretValue(providerName, secretName):
+    # type: (Union[str, unicode], Union[str, unicode]) -> PyPlaintext
+    """Reads the plaintext value of a secret given the name of the
+    Secret Provider and the name of the secret.
+
+    Args:
+        providerName: The name of the Secret Provider to read the secret
+            from.
+        secretName: The name of the secret to read.
+
+    Returns:
+        A PyPlaintext instance that contains the secret.
+    """
+    print(providerName, secretName)
+    return PyPlaintext(Plaintext())