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

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

@@ -1,3 +1,19 @@
+## 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
+
+- **ia**: use Any as argument instead of PyObject (#33)
+
 ## 8.3.6.post1 (2026-04-29)
 
 ## 8.3.6 (2026-04-29)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ignition_api
-Version: 8.3.6.post1
+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.post1 → ignition_api-8.3.7}/setup.cfg

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

{ignition_api-8.3.6.post1 → ignition_api-8.3.7}/src/com/inductiveautomation/factorypmi/application/script/builtin/__init__.py

@@ -523,7 +523,7 @@ class VisionUtilities(Object):
         pass
 
     def openDesktop(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> JFrame
+        # type: (*Any, **Union[str, unicode]) -> JFrame
         pass
 
     def openFile(self, *args, **kwargs):
@@ -834,7 +834,7 @@ class WindowUtilities(Object):
         pass
 
     def openDesktop(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> JFrame
+        # type: (*Any, **Union[str, unicode]) -> JFrame
         pass
 
     def openDiagnostics(self):
@@ -873,7 +873,7 @@ class WindowUtilities(Object):
         pass
 
     def transform(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> PyObject
+        # type: (*Any, **Union[str, unicode]) -> PyObject
         pass
 
     def warningBox(self, message, title="Warning"):

{ignition_api-8.3.6.post1 → 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",
@@ -119,7 +120,7 @@ class MutableJythonMap(object):
         raise NotImplementedError
 
     def update(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> None
+        # type: (*Any, **Union[str, unicode]) -> None
         raise NotImplementedError
 
     def __setitem__(self, pyKey, pyValue):
@@ -154,7 +155,7 @@ class MutableJythonSequence(JythonSequence):
         raise NotImplementedError
 
     def sort(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> None
+        # type: (*Any, **Union[str, unicode]) -> None
         raise NotImplementedError
 
     def __add__(self, other):
@@ -243,7 +244,7 @@ class AbstractMutableJythonMap(MutableJythonMap):
         pass
 
     def update(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> None
+        # type: (*Any, **Union[str, unicode]) -> None
         raise NotImplementedError
 
     def __setitem__(self, pyKey, pyValue):
@@ -278,5 +279,19 @@ class AbstractMutableJythonSequence(AbstractJythonSequence, MutableJythonSequenc
         raise NotImplementedError
 
     def sort(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> None
+        # 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.6.post1 → ignition_api-8.3.7}/src/com/inductiveautomation/ignition/common/script/adapters/__init__.py

@@ -69,7 +69,7 @@ class PyJsonObjectAdapter(Object):
         pass
 
     def update(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> None
+        # type: (*Any, **Union[str, unicode]) -> None
         pass
 
     def values(self):

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

@@ -78,7 +78,7 @@ class AbstractOPCUtilities(Object):
         ]
 
     def getServers(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> List[Union[str, unicode]]  # noqa: W505
+        # type: (*Any, **Union[str, unicode]) -> List[Union[str, unicode]]  # noqa: W505
         pass
 
     def getServerState(self, opcServer):
@@ -110,11 +110,11 @@ class AbstractOPCUtilities(Object):
         pass
 
     def writeValue(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> QualityCode
+        # type: (*Any, **Union[str, unicode]) -> QualityCode
         pass
 
     def writeValues(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> List[QualityCode]
+        # type: (*Any, **Union[str, unicode]) -> List[QualityCode]
         pass
 
 
@@ -422,7 +422,7 @@ class DatasetUtilities(Object):
 
     @staticmethod
     def toCSV(*args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> Union[str, unicode]  # noqa: W505
+        # type: (*Any, **Union[str, unicode]) -> Union[str, unicode]  # noqa: W505
         pass
 
     @staticmethod
@@ -442,7 +442,7 @@ class DatasetUtilities(Object):
 
     @staticmethod
     def toExcel(*args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> bytearray
+        # type: (*Any, **Union[str, unicode]) -> bytearray
         pass
 
     @staticmethod
@@ -806,5 +806,5 @@ class SystemUtilities(Object):
 
     @staticmethod
     def parseTranslateArguments(*args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> Tuple[Union[str, unicode], Union[str, unicode], bool]  # noqa: E501, W505  # pylint: disable=line-too-long
+        # type: (*Any, **Union[str, unicode]) -> Tuple[Union[str, unicode], Union[str, unicode], bool]  # noqa: E501, W505  # pylint: disable=line-too-long
         pass

{ignition_api-8.3.6.post1 → ignition_api-8.3.7}/src/com/inductiveautomation/ignition/common/script/builtin/http/__init__.py

@@ -30,19 +30,19 @@ class JythonHttpClient(Object):
     """
 
     def delete(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> Response
+        # type: (*Any, **Union[str, unicode]) -> Response
         pass
 
     def deleteAsync(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> Promise
+        # type: (*Any, **Union[str, unicode]) -> Promise
         pass
 
     def get(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> Response
+        # type: (*Any, **Union[str, unicode]) -> Response
         pass
 
     def getAsync(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> Promise
+        # type: (*Any, **Union[str, unicode]) -> Promise
         pass
 
     def getConnectTimeout(self):
@@ -276,7 +276,7 @@ class Promise(Object):
         return True
 
     def get(self, *args, **kwargs):
-        # type: (*PyObject, **Union[str, unicode]) -> Any
+        # type: (*Any, **Union[str, unicode]) -> Any
         pass
 
     def getFuture(self):

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.post1 → 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.post1
+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.post1 → 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.post1 → ignition_api-8.3.7}/src/org/python/core/__init__.py

@@ -1333,7 +1333,7 @@ class PyList(PySequenceList):
         pass
 
     def sort(self, *args):
-        # type: (*PyObject) -> None
+        # type: (*Any) -> None
         pass
 
     def subList(self, fromIndex, toIndex):

{ignition_api-8.3.6.post1 → 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())