ironflock 0.1.1__py3-none-any.whl → 1.0.1__py3-none-any.whl

ironflock/AutobahnConnection.py

@@ -9,8 +9,18 @@ try:
 except:
     raise Exception("Environment variable SWARM_KEY not set!")
 
-CB_REALM = "userapps"
-# CB_REALM = f"swarm{SWARM_KEY}"
+try:
+    APP_KEY = os.environ["APP_KEY"]
+except:
+    raise Exception("Environment variable APP_KEY not set!")
+
+try:
+    ENV = os.environ["ENV"].lower()
+except:
+    raise Exception("Environment variable ENV not set!")
+
+# CB_REALM = "userapps"
+CB_REALM = f"realm-{SWARM_KEY}-{APP_KEY}-{ENV}"
 
 DATAPODS_WS_URI = "wss://cbw.datapods.io/ws-ua-usr"
 STUDIO_WS_URI_OLD = "wss://cbw.record-evolution.com/ws-ua-usr"
@@ -69,7 +79,7 @@ class AppSession(ApplicationSession):
 def create_application_session(
     serial_number: str = None,
 ) -> Tuple[ApplicationSession, ApplicationRunner]:
-    """Creates an Autobahn ApplicationSession and ApplicationRunner, which connects to the RE Platform
+    """Creates an Autobahn ApplicationSession and ApplicationRunner, which connects to the IronFlock Platform
 
     Args:
         serial_number (str, optional): serial_number of device.
@@ -91,7 +101,7 @@ def create_application_session(
 
 
 def create_application_component(serial_number: str = None) -> Component:
-    """Creates an Autobahn Component, which connects to the RE Platform
+    """Creates an Autobahn Component, which connects to the IronFlock Platform
 
     Args:
         serial_number (str, optional): serial_number of device.

ironflock/ironflock.py

@@ -9,22 +9,22 @@ from ironflock.AutobahnConnection import getSerialNumber, create_application_com
 
 
 class IronFlock:
-    """Convenience class for easy to use message publishing to the RE platform.
+    """Conveniance class for easy-to-use message publishing in the IronFlock platform.
 
     Example:
 
-        rw = IronFlock()
+        ironFlock = IronFlock()
 
         async def main():
             while True:
-                publication = await rw.publish("test.publish.pw", 1, "two", 3, foo="bar")
+                publication = await ironFlock.publish("test.publish.pw", 1, "two", 3, foo="bar")
                 print(publication)
                 await asyncio.sleep(3)
 
 
         if __name__ == "__main__":
             asyncio.get_event_loop().create_task(main())
-            rw.run()
+            ironFlock.run()
     """
 
     def __init__(self, serial_number: str = None, mainFunc=None) -> None:
@@ -36,6 +36,7 @@ class IronFlock:
         """
         self._serial_number = getSerialNumber(serial_number)
         self._device_name = os.environ.get("DEVICE_NAME")
+        self._device_key = os.environ.get("DEVICE_KEY")
         self._component = create_application_component(serial_number)
         self._session: ISession = None
         self.mainFunc = mainFunc
@@ -76,7 +77,7 @@ class IronFlock:
         return self._session
 
     async def publish(self, topic: str, *args, **kwargs) -> Optional[Publication]:
-        """Publishes to the RE Platform Message Router
+        """Publishes to the IronFlock Platform Message Router
 
         Args:
             topic (str): The URI of the topic to publish to, e.g. "com.myapp.mytopic1"
@@ -88,6 +89,7 @@ class IronFlock:
 
         extra = {
             "DEVICE_SERIAL_NUMBER": self._serial_number,
+            "DEVICE_KEY": self._device_key,
             "DEVICE_NAME": self._device_name,
             "options": PublishOptions(acknowledge=True),
         }
@@ -102,6 +104,8 @@ class IronFlock:
         """Update the location of the device registered in the platform
             This will update the device's location in the master data of the platform.
             The maps in the device or group overviews will reflect the new device location in realtime.
+            The location history will not be stored in the platform. 
+            If you need location history, then create a dedicated table for it.
         """
 
         payload = {
@@ -111,6 +115,7 @@ class IronFlock:
         
         extra = {
             "DEVICE_SERIAL_NUMBER": self._serial_number,
+            "DEVICE_KEY": self._device_key,
             "DEVICE_NAME": self._device_name
         }
         
@@ -121,8 +126,14 @@ class IronFlock:
     async def publish_to_table(
         self, tablename: str, *args, **kwargs
     ) -> Optional[Publication]:
-        """Publishes Data to a Table in the RE Platform
-
+        """Publishes Data to a Table in the IronFlock Platform. This is a conveniance function.
+            You can achieve the same results by simply publishing a payload to the topic
+            
+            [SWARM_KEY].[APP_KEY].[your_table_name]
+            
+            The SWARM_KEY and APP_KEY are provided as environment variables to the device container.
+            The also provided ENV variable holds either PROD or DEV to decide which topic to use, above.
+            This function automatically detects the environment and publishes to the correct table.
         Args:
             tablename (str): The table name of the table to publish to, e.g. "sensordata"
 
@@ -144,16 +155,7 @@ class IronFlock:
         if app_key is None:
             raise Exception("Environment variable APP_KEY not set!")
 
-        if env_value is None:
-            raise Exception("Environment variable ENV not set!")
-
-        if not env_value in ["DEV", "PROD"]:
-            raise Exception("Environment variable ENV must be 'PROD' or 'DEV'!")
-
-        if env_value == "PROD":
-            topic = f"{swarm_key}.{app_key}.{tablename}"
-        else:
-            topic = f"dev.{swarm_key}.{app_key}.{tablename}"
+        topic = f"{swarm_key}.{app_key}.{tablename}"
 
         pub = await self.publish(topic, *args, **kwargs)
         return pub

{ironflock-0.1.1.dist-info → ironflock-1.0.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ironflock
-Version: 0.1.1
+Version: 1.0.1
 Summary: Publishing data to a IronFlock Fleet Storage
 Home-page: https://github.com/RecordEvolution/ironflock-python
 Author: Record Evolution GmbH
@@ -9,16 +9,19 @@ License: MIT
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: autobahn[asyncio,compression,serialization] ==22.3.2
+Requires-Dist: autobahn[asyncio,serialization] ==22.3.2
 
 # ironflock
 
 ## About
 
-With this library you can publishing data to IronFlock fleet storage. When this library is used on a certain device the library automatically uses the private messaging realm (Unified Name Space) of the device's fleet and the data is collected in the respective fleet database.
+With this library you can publish data from your apps on your IoT edge hardware to the fleet data storage of the [IronFlock](https://studio.ironflock.com) devops platform.
+When this library is used on a certain device the library automatically uses the private messaging realm (Unified Name Space)
+of the device's fleet and the data is collected in the respective fleet database.
 
 So if you use the library in your app, the data collection will always be private to the app user's fleet.
 
+For more information on the IronFlock IoT Devops Platform for engineers and developers visit our [IronFlock](https://www.ironflock.com) home page.
 ## Usage
 
 ```python
@@ -73,8 +76,7 @@ pip install --upgrade setuptools wheel twine
 Build and publish a new pypi package:
 
 ```shell
-python setup.py sdist bdist_wheel
-twine upload dist/*
+make publish
 ```
 
 Check the package at https://pypi.org/project/ironflock/.

ironflock-1.0.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+ironflock/AutobahnConnection.py,sha256=clwEsptqQFjDFn4dUGN4bQyb1cOnPmmNjetfTrRqckY,3687
+ironflock/__init__.py,sha256=LsyyAenv7GrvQSmPc3QJDu7_VsK7BDIvbwGC8ebEI9A,265
+ironflock/ironflock.py,sha256=ZVshk0ky9rOPbNlLHUW-LgjuFl_YJbm3zqLvKSLjRs8,5892
+ironflock-1.0.1.dist-info/LICENSE,sha256=GpUKjPB381nmkbBIdX74vxXhsNZaNpngTOciss39Pjk,1073
+ironflock-1.0.1.dist-info/METADATA,sha256=ONGtcs6swb7JV50gQZIIUYQSEOcVBsp3rXQ-2NJ_rV8,2491
+ironflock-1.0.1.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
+ironflock-1.0.1.dist-info/top_level.txt,sha256=hmMdMPJuvnOTlFKYl1XQOn81vg1DE2LT7xrEXgyxcRA,10
+ironflock-1.0.1.dist-info/RECORD,,

{ironflock-0.1.1.dist-info → ironflock-1.0.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (70.1.1)
+Generator: setuptools (72.1.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

ironflock-0.1.1.dist-info/RECORD

@@ -1,8 +0,0 @@
-ironflock/AutobahnConnection.py,sha256=IX5VjUhRGq4-zo8cx2CH964pmoPH29sWc0eQAAG60gM,3438
-ironflock/__init__.py,sha256=LsyyAenv7GrvQSmPc3QJDu7_VsK7BDIvbwGC8ebEI9A,265
-ironflock/ironflock.py,sha256=I0T3NvY8kL7TzdjPdn7HfOxMDxsTF2qRhnklRU09dZ4,5385
-ironflock-0.1.1.dist-info/LICENSE,sha256=GpUKjPB381nmkbBIdX74vxXhsNZaNpngTOciss39Pjk,1073
-ironflock-0.1.1.dist-info/METADATA,sha256=HRePXC8dtOLvc-5tkJ347ZJEpTO0__K1pFJp_PsdzaA,2295
-ironflock-0.1.1.dist-info/WHEEL,sha256=mguMlWGMX-VHnMpKOjjQidIo1ssRlCFu4a4mBpz1s2M,91
-ironflock-0.1.1.dist-info/top_level.txt,sha256=hmMdMPJuvnOTlFKYl1XQOn81vg1DE2LT7xrEXgyxcRA,10
-ironflock-0.1.1.dist-info/RECORD,,