uns-kit 0.0.3__py3-none-any.whl → 0.0.4__py3-none-any.whl

uns_kit/cli.py

@@ -2,6 +2,9 @@ from __future__ import annotations
 
 import asyncio
 import json
+import os
+import shutil
+import importlib.resources
 from pathlib import Path
 from typing import Optional
 
@@ -120,6 +123,22 @@ async def _run_subscribe(
             print(f"{msg.topic} <binary {len(msg.payload)} bytes>")
 
 
+@cli.command("create", help="Create a new UNS Python app (default template).")
+@click.argument("dest")
+def create(dest: str):
+    template_root = importlib.resources.files("uns_kit").joinpath("templates/default")
+    dest_path = os.path.abspath(dest)
+    if os.path.exists(dest_path):
+        raise click.ClickException(f"Destination already exists: {dest_path}")
+    shutil.copytree(template_root, dest_path)
+    click.echo(f"Created UNS Python app at {dest_path}")
+    click.echo("Next steps:")
+    click.echo(f"  1) cd {dest_path}")
+    click.echo("  2) poetry install")
+    click.echo("  3) poetry run python src/main.py")
+    click.echo("  4) Edit config.json with your MQTT host/credentials")
+
+
 @cli.command("write-config", help="Write a minimal config.json scaffold.")
 @click.option("--path", default="config.json", show_default=True)
 def write_config(path: str):

uns_kit/templates/default/README.md

@@ -0,0 +1,10 @@
+# UNS Python App Template
+
+## Setup
+```bash
+poetry install
+poetry run python src/main.py
+```
+
+## Config
+Edit `config.json` with your MQTT host/auth.

uns_kit/templates/default/pyproject.toml

@@ -0,0 +1,17 @@
+[tool.poetry]
+name = "uns-py-app"
+version = "0.1.0"
+description = "Example UNS Python application"
+authors = ["Your Name <you@example.com>"]
+package-mode = false
+
+[tool.poetry.dependencies]
+python = "^3.10"
+uns-kit = "*"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.3.3"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

uns_kit/templates/default/src/main.py

@@ -0,0 +1,27 @@
+import asyncio
+import json
+from pathlib import Path
+from uns_kit import UnsMqttClient, TopicBuilder, UnsPacket
+
+
+async def main():
+    cfg = json.loads(Path("config.json").read_text())
+    tb = TopicBuilder(cfg["packageName"], cfg["packageVersion"], cfg["processName"])
+    client = UnsMqttClient(
+        cfg["host"],
+        port=cfg.get("port"),
+        username=cfg.get("username") or None,
+        password=cfg.get("password") or None,
+        tls=cfg.get("tls", False),
+        client_id=cfg.get("clientId"),
+        topic_builder=tb,
+        reconnect_interval=1,
+    )
+    await client.connect()
+    await client.publish_packet("raw/data/", UnsPacket.data(value=1, uom="count"))
+    async for msg in client.resilient_messages("uns-infra/#"):
+        print(msg.topic, msg.payload.decode())
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

{uns_kit-0.0.3.dist-info → uns_kit-0.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uns-kit
-Version: 0.0.3
+Version: 0.0.4
 Summary: Lightweight Python UNS MQTT client (pub/sub + infra topics)
 License: MIT
 Author: Aljoša Vister
@@ -70,6 +70,14 @@ async for msg in client.resilient_messages("uns-infra/#"):
 - `examples/publish.py` — publish 5 data packets.
 - `examples/subscribe.py` — resilient subscription with auto-reconnect.
 
+### Create a new project
+```bash
+uns-kit-py create my-uns-py-app
+cd my-uns-py-app
+poetry install
+poetry run python src/main.py
+```
+
 ## Notes
 - Default QoS is 0; will message is retained on `<statusTopic>alive`.
 - Uptime is published every 10 seconds on `<statusTopic>uptime`.

uns_kit-0.0.4.dist-info/RECORD

@@ -0,0 +1,13 @@
+uns_kit/__init__.py,sha256=-4R72u-uzg2ib2Z1SFQiSX5KSNYY6oMqVvGoVPI3eQs,290
+uns_kit/cli.py,sha256=USq7bHl6sL75s--Y_nV2j7v1JScZWehZp92GyqYgjyw,5552
+uns_kit/client.py,sha256=bFXAKmuR06mSlO8tsAoeB7jv9RQgw1a_AIbXQNpNFTw,5815
+uns_kit/config.py,sha256=mRMiuxGV6CEIBDVZUJQqYIeGxKzfBhlXCcGNXnVtBj4,869
+uns_kit/packet.py,sha256=qd6BrCv_JE8fxh-iaJBAVhUZvY28lhiDr9F1At8CXjw,1675
+uns_kit/templates/default/README.md,sha256=IQ1zvCSzigE3foKBLkDv9UZnZEScuS6V19oCSCJPvXw,149
+uns_kit/templates/default/pyproject.toml,sha256=dxSghe6RiljsXfz4Gt_YXB1g-P_W2jiYUJk6ug4TytE,362
+uns_kit/templates/default/src/main.py,sha256=0mxq9Oa00UwqlEiJIBnlDiulBPECJ4YSojqjv6tonTk,850
+uns_kit/topic_builder.py,sha256=JGYdYynRWWSwzXaCaRLjap0-du13eSc6qe1V0GrD_ak,1492
+uns_kit-0.0.4.dist-info/METADATA,sha256=CjegZQzS1ZMvRyMEXB7p21RaejS7cidggXYvKgZ_QMs,2736
+uns_kit-0.0.4.dist-info/WHEEL,sha256=3ny-bZhpXrU6vSQ1UPG34FoxZBp3lVcvK0LkgUz6VLk,88
+uns_kit-0.0.4.dist-info/entry_points.txt,sha256=sLvTioiJQfGczUD-ODVx2xwwtHcGKjlIOn8t_Lt87Pg,47
+uns_kit-0.0.4.dist-info/RECORD,,

uns_kit-0.0.3.dist-info/RECORD

@@ -1,10 +0,0 @@
-uns_kit/__init__.py,sha256=-4R72u-uzg2ib2Z1SFQiSX5KSNYY6oMqVvGoVPI3eQs,290
-uns_kit/cli.py,sha256=BVqLPNegmbEasBr_k2Qt4S_A3fQuP8tn5d5Z_bO5t5w,4800
-uns_kit/client.py,sha256=bFXAKmuR06mSlO8tsAoeB7jv9RQgw1a_AIbXQNpNFTw,5815
-uns_kit/config.py,sha256=mRMiuxGV6CEIBDVZUJQqYIeGxKzfBhlXCcGNXnVtBj4,869
-uns_kit/packet.py,sha256=qd6BrCv_JE8fxh-iaJBAVhUZvY28lhiDr9F1At8CXjw,1675
-uns_kit/topic_builder.py,sha256=JGYdYynRWWSwzXaCaRLjap0-du13eSc6qe1V0GrD_ak,1492
-uns_kit-0.0.3.dist-info/METADATA,sha256=w6WCkwhbS7KmMuqskMiFKgblVFJsgKu4-G_Rbw6WPBk,2604
-uns_kit-0.0.3.dist-info/WHEEL,sha256=3ny-bZhpXrU6vSQ1UPG34FoxZBp3lVcvK0LkgUz6VLk,88
-uns_kit-0.0.3.dist-info/entry_points.txt,sha256=sLvTioiJQfGczUD-ODVx2xwwtHcGKjlIOn8t_Lt87Pg,47
-uns_kit-0.0.3.dist-info/RECORD,,