capyy 0.5.1__tar.gz → 0.5.2__tar.gz

{capyy-0.5.1 → capyy-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: capyy
-Version: 0.5.1
+Version: 0.5.2
 Summary: Easy, encrypted networking for Python: programs that talk (local, Wi-Fi, internet), home automation, and projects run with cy
 Author: Izac
 License-Expression: MIT
@@ -82,7 +82,7 @@ what could not be converted.
 Describe the whole project once, then never repeat ports or hosts:
 
 ```bash
-python3 -m capy new my-game     # folder + capy.config.json + server.py + client.py
+capy new my-game     # folder + capy.config.json + server.py + client.py
 cd my-game
 cy run             # starts the server, runs the client, stops the server
 ```
@@ -99,7 +99,7 @@ app.call("hello", nom="Izac")   # client side
 ```
 
 `mode` can be `local`, `wifi` or `network` (with `relay`, `key`, `fingerprint`). Strings starting with `$` are read
-from environment variables, e.g. `"key": "$CAPY_KEY"`. Inside a project, the `cy` command runs its `scripts` like `npm run` (`cy test`, `cy start`) and its files (`cy server`); create a project with `python3 -m capy new`.
+from environment variables, e.g. `"key": "$CAPY_KEY"`. Inside a project, the `cy` command runs its `scripts` like `npm run` (`cy test`, `cy start`) and its files (`cy server`); create a project with `capy new`.
 
 ## Encryption (TLS)
 
@@ -131,7 +131,7 @@ A machine behind a home router cannot be reached from the internet, so `capy.net
 clients call that name. Everything is encrypted, and the connection is kept open between calls.
 
 ```bash
-python3 -m capy.network 3879 my-secret-key      # on the VPS (open the port in its firewall)
+capy relay 3879 my-secret-key      # on the VPS (open the port in its firewall)
 ```
 
 ```python
@@ -158,9 +158,9 @@ capy.domo.serve(home)          # control it remotely through capy / capy.wifi /
 ```
 
 ```bash
-python3 -m capy.domo scan
-python3 -m capy.domo pair hue
-python3 -m capy.domo salon on 30% orange
+capy domo scan
+capy domo pair hue
+capy domo salon on 30% orange
 ```
 
 ## License

{capyy-0.5.1 → capyy-0.5.2}/README.md

@@ -60,7 +60,7 @@ what could not be converted.
 Describe the whole project once, then never repeat ports or hosts:
 
 ```bash
-python3 -m capy new my-game     # folder + capy.config.json + server.py + client.py
+capy new my-game     # folder + capy.config.json + server.py + client.py
 cd my-game
 cy run             # starts the server, runs the client, stops the server
 ```
@@ -77,7 +77,7 @@ app.call("hello", nom="Izac")   # client side
 ```
 
 `mode` can be `local`, `wifi` or `network` (with `relay`, `key`, `fingerprint`). Strings starting with `$` are read
-from environment variables, e.g. `"key": "$CAPY_KEY"`. Inside a project, the `cy` command runs its `scripts` like `npm run` (`cy test`, `cy start`) and its files (`cy server`); create a project with `python3 -m capy new`.
+from environment variables, e.g. `"key": "$CAPY_KEY"`. Inside a project, the `cy` command runs its `scripts` like `npm run` (`cy test`, `cy start`) and its files (`cy server`); create a project with `capy new`.
 
 ## Encryption (TLS)
 
@@ -109,7 +109,7 @@ A machine behind a home router cannot be reached from the internet, so `capy.net
 clients call that name. Everything is encrypted, and the connection is kept open between calls.
 
 ```bash
-python3 -m capy.network 3879 my-secret-key      # on the VPS (open the port in its firewall)
+capy relay 3879 my-secret-key      # on the VPS (open the port in its firewall)
 ```
 
 ```python
@@ -136,9 +136,9 @@ capy.domo.serve(home)          # control it remotely through capy / capy.wifi /
 ```
 
 ```bash
-python3 -m capy.domo scan
-python3 -m capy.domo pair hue
-python3 -m capy.domo salon on 30% orange
+capy domo scan
+capy domo pair hue
+capy domo salon on 30% orange
 ```
 
 ## License

{capyy-0.5.1 → capyy-0.5.2}/capy/__main__.py

@@ -1,16 +1,19 @@
-# Les commandes d'un projet capy (tout vient de capy.config.json)
+# Deux commandes, installées avec capy :
 #
-# cy : seulement DANS un projet capy (un dossier avec capy.config.json, ou en dessous)
+# cy : DANS un projet capy (un dossier avec capy.config.json, ou en dessous)
 #   cy                          -> montre le projet (nom, mode, adresse, fichiers, scripts…)
 #   cy NOM [args…]              -> lance le script NOM de "scripts" (comme npm run)
 #   cy scripts                  -> liste les scripts
 #   cy server / cy client       -> lance un fichier de "files"
 #   cy run                      -> lance le serveur en fond, puis le client, puis arrête le serveur
 #
-# python3 -m capy : tout ce que fait cy, plus créer un projet
-#   python3 -m capy new NOM [mode]    -> crée un dossier NOM avec capy.config.json, server.py, client.py
-#   python3 -m capy init [nom] [mode] -> crée juste capy.config.json ici
+# capy : tout le reste (et tout ce que fait cy)
+#   capy new NOM [mode]         -> crée un dossier NOM avec capy.config.json, server.py, client.py
+#   capy init [nom] [mode]      -> crée juste capy.config.json ici
+#   capy domo …                 -> la domotique (capy domo help)
+#   capy relay PORT [CLÉ]       -> lance un relais capy.network (sur le VPS)
 #   mode : local (par défaut), wifi ou network
+#   python3 -m capy = capy (si la commande n'est pas dans le PATH)
 
 import difflib
 import socket
@@ -27,9 +30,11 @@ USAGE = f"""Dans un projet capy ({FILE_NAME}) :
   cy scripts             liste les scripts
   cy server / client     lance un fichier de "files"
   cy run                 serveur en fond + client, puis arrête le serveur
-Créer un projet :
-  python3 -m capy new NOM [mode]      un dossier complet (config, server.py, client.py)
-  python3 -m capy init [nom] [mode]   juste {FILE_NAME} ici
+Partout :
+  capy new NOM [mode]    crée un projet complet (config, server.py, client.py)
+  capy init [nom] [mode] crée juste {FILE_NAME} ici
+  capy domo …            la domotique (capy domo help)
+  capy relay PORT [CLÉ]  lance un relais capy.network
   modes : {", ".join(MODES)}"""
 
 
@@ -37,9 +42,9 @@ Créer un projet :
 def _project():
     path = find(".")
     if path is None:
-        sys.exit(f"cy marche dans un projet capy, et il n'y a pas de {FILE_NAME} ici ni au-dessus.\n"
-                 f"  Crée un projet : python3 -m capy new mon-projet\n"
-                 f"  ou juste le fichier : python3 -m capy init")
+        sys.exit(f"Pas de {FILE_NAME} ici ni au-dessus : ce dossier n'est pas un projet capy.\n"
+                 f"  Crée un projet : capy new mon-projet\n"
+                 f"  ou juste le fichier : capy init")
     try:
         return project(path)
     except ValueError as e:
@@ -111,12 +116,20 @@ def main(args):
     if command in ("-h", "--help", "help"):
         print(USAGE)
         return
+    if command == "domo":  # capy domo salon on
+        from .domo.__main__ import cli as domo_cli
+        domo_cli(args[1:])
+        return
+    if command in ("relay", "network"):  # capy relay 3879 CLÉ
+        from .network import cli as relay_cli
+        relay_cli(args[1:])
+        return
     if command in ("init", "new"):
         rest = args[1:]
         mode = next((a for a in rest if a in MODES), "local")
         name = next((a for a in rest if a not in MODES), None)
         if command == "new" and not name:
-            sys.exit("Usage : python3 -m capy new NOM [mode]")
+            sys.exit("Usage : capy new NOM [mode]")
         try:
             path = new(name, mode) / FILE_NAME if command == "new" else init(name=name, mode=mode)
         except (FileExistsError, ValueError) as e:
@@ -157,13 +170,18 @@ def main(args):
         sys.exit(f"capy : commande, script ou fichier {command!r} inconnu (possibles : {', '.join(names)})\n\n{USAGE}")
 
 
-# La commande cy : seulement les commandes d'un projet (pas new ni init, qui créent un projet)
+# La commande cy : seulement les commandes d'un projet
 def cli():
     args = sys.argv[1:]
-    if args[:1] in (["new"], ["init"]):
-        sys.exit(f"cy sert dans un projet existant ; pour en créer un : python3 -m capy {' '.join(args)}")
+    if args[:1] in (["new"], ["init"], ["domo"], ["relay"], ["network"]):
+        sys.exit(f"cy sert dans un projet capy ; pour ça, c'est la commande capy : capy {' '.join(args)}")
     main(args)
 
 
-if __name__ == "__main__":  # python3 -m capy : tout, y compris new et init
+# La commande capy (et python3 -m capy) : tout
+def capy_cli():
     main(sys.argv[1:])
+
+
+if __name__ == "__main__":
+    capy_cli()

{capyy-0.5.1 → capyy-0.5.2}/capy/_project.py

@@ -46,7 +46,7 @@ FIELDS = {
 
 EXAMPLE = {"name": "mon-projet", "mode": "local", "host": "localhost", "port": 4000, "tls": True,
            "files": {"server": "server.py", "client": "client.py"}}
-COMMANDS = ("init", "new", "run", "scripts", "help")  # Mots réservés de cy / python3 -m capy (pas des noms de fichiers ni de scripts)
+COMMANDS = ("init", "new", "run", "scripts", "help", "domo", "relay")  # Mots réservés de cy / capy (pas des noms de fichiers ni de scripts)
 
 
 # Dossier du script lancé (comme simplesuit.json) ; sans script (python3 -c, REPL) -> dossier actuel
@@ -274,7 +274,7 @@ def project(path=None) -> Project:
         if found is None:
             raise FileNotFoundError(
                 f"capy.project : aucun {FILE_NAME} trouvé dans {_main_dir()} ni au-dessus.\n"
-                f"  Crée-le avec : python3 -m capy init\n"
+                f"  Crée-le avec : capy init\n"
                 f"  ou écris-le toi-même, par exemple : {jsonlib.dumps(EXAMPLE, ensure_ascii=False)}"
             )
         return Project(found)
@@ -284,7 +284,7 @@ def project(path=None) -> Project:
     return Project(path / FILE_NAME if path.is_dir() else path)
 
 
-# Écrire un capy.config.json de départ (python3 -m capy init [nom] [mode])
+# Écrire un capy.config.json de départ (capy init [nom] [mode])
 def init(folder=None, name=None, mode="local"):
     if mode not in MODES:
         raise ValueError(f"capy init : mode {mode!r} inconnu, choisis parmi : {', '.join(MODES)}")
@@ -331,7 +331,7 @@ print(capy.get(reponse, "message"))
 '''
 
 
-# Créer un projet complet : dossier + capy.config.json + server.py + client.py (python3 -m capy new nom)
+# Créer un projet complet : dossier + capy.config.json + server.py + client.py (capy new nom)
 def new(name, mode="local", parent=None):
     folder = pth.Path(parent or pth.Path.cwd()) / name
     if folder.exists() and any(folder.iterdir()):

{capyy-0.5.1 → capyy-0.5.2}/capy/domo/__init__.py

@@ -253,14 +253,14 @@ class Home:
             if host in self.hue:
                 lights += _hue.lights(host, _env(self.hue[host]))
             else:
-                self.hints.append(f"Pont Hue trouvé à {host} : appaire-le avec  python3 -m capy.domo pair hue {host}")
+                self.hints.append(f"Pont Hue trouvé à {host} : appaire-le avec  capy domo pair hue {host}")
         return lights
 
     def _scan_homeassistant(self, timeout, addresses):
         if self.homeassistant:
             return _homeassistant.entities(_env(self.homeassistant["url"]), _env(self.homeassistant["token"]))
         for url in _homeassistant.servers(timeout, addresses.get("homeassistant")):
-            self.hints.append(f"Home Assistant trouvé à {url} : python3 -m capy.domo pair homeassistant {url}")
+            self.hints.append(f"Home Assistant trouvé à {url} : capy domo pair homeassistant {url}")
         return []
 
     # --- Appairage --------------------------------------------

{capyy-0.5.1 → capyy-0.5.2}/capy/domo/__main__.py

@@ -1,13 +1,13 @@
-# python3 -m capy.domo : piloter la maison depuis le terminal
+# capy domo : piloter la maison depuis le terminal
 #
-#   python3 -m capy.domo scan                       chercher les appareils du réseau (et les ajouter)
-#   python3 -m capy.domo pair hue [IP]              appairer un pont Hue (appuyer sur son bouton)
-#   python3 -m capy.domo pair homeassistant URL     brancher Home Assistant (jeton demandé)
-#   python3 -m capy.domo list                       les appareils, groupes et scènes, avec leur état
-#   python3 -m capy.domo salon on 30% orange        allumer, luminosité, couleur (ou off, toggle, 2700K, chaud…)
-#   python3 -m capy.domo scene film                 lancer une scène
-#   python3 -m capy.domo serve                      rendre la maison pilotable à distance
-#   python3 -m capy.domo --remote salon off         piloter une maison à distance (capy.config.json)
+#   capy domo scan                       chercher les appareils du réseau (et les ajouter)
+#   capy domo pair hue [IP]              appairer un pont Hue (appuyer sur son bouton)
+#   capy domo pair homeassistant URL     brancher Home Assistant (jeton demandé)
+#   capy domo list                       les appareils, groupes et scènes, avec leur état
+#   capy domo salon on 30% orange        allumer, luminosité, couleur (ou off, toggle, 2700K, chaud…)
+#   capy domo scene film                 lancer une scène
+#   capy domo serve                      rendre la maison pilotable à distance
+#   capy domo --remote salon off         piloter une maison à distance (capy.config.json)
 
 import getpass
 import os
@@ -20,14 +20,14 @@ import capy
 from . import FILE_NAME, WHITES, Home, Remote, _hue, find, serve, to_kelvin, to_rgb
 
 USAGE = """Usage :
-  python3 -m capy.domo scan                     chercher les appareils du réseau
-  python3 -m capy.domo pair hue [IP]            appairer un pont Hue
-  python3 -m capy.domo pair homeassistant URL   brancher Home Assistant
-  python3 -m capy.domo list                     appareils, groupes, scènes et état
-  python3 -m capy.domo NOM on|off|toggle|50%|orange|#FF7800|2700K|chaud …
-  python3 -m capy.domo scene NOM                lancer une scène
-  python3 -m capy.domo serve                    pilotable à distance
-  python3 -m capy.domo --remote NOM …           piloter une maison à distance"""
+  capy domo scan                     chercher les appareils du réseau
+  capy domo pair hue [IP]            appairer un pont Hue
+  capy domo pair homeassistant URL   brancher Home Assistant
+  capy domo list                     appareils, groupes, scènes et état
+  capy domo NOM on|off|toggle|50%|orange|#FF7800|2700K|chaud …
+  capy domo scene NOM                lancer une scène
+  capy domo serve                    pilotable à distance
+  capy domo --remote NOM …           piloter une maison à distance"""
 
 
 # "on 30% orange" -> {"on": True, "brightness": 30, "color": "orange"} (ou "toggle")
@@ -97,7 +97,7 @@ def main(args):
         if brand == "hue":
             hosts = rest[1:] or _hue.bridges()
             if not hosts:
-                sys.exit("Aucun pont Hue trouvé : donne son IP, ex : python3 -m capy.domo pair hue 192.168.1.10")
+                sys.exit("Aucun pont Hue trouvé : donne son IP, ex : capy domo pair hue 192.168.1.10")
             host = hosts[0]
             input(f"Appuie sur le gros bouton rond du pont Hue ({host}), puis sur Entrée… ")
             for _ in range(30):
@@ -110,7 +110,7 @@ def main(args):
                 sys.exit("Le pont n'a pas vu le bouton : réessaie (tu as 30 s après l'appui)")
         elif brand == "homeassistant":
             if len(rest) < 2:
-                sys.exit("Donne l'adresse : python3 -m capy.domo pair homeassistant http://homeassistant.local:8123")
+                sys.exit("Donne l'adresse : capy domo pair homeassistant http://homeassistant.local:8123")
             if os.environ.get("HA_TOKEN"):
                 token = "$HA_TOKEN"
                 print("Jeton lu dans la variable HA_TOKEN")
@@ -118,7 +118,7 @@ def main(args):
                 token = getpass.getpass("Jeton longue durée (Profil -> Sécurité dans Home Assistant) : ")
             added = home.pair_homeassistant(rest[1], token)
         else:
-            sys.exit("Usage : python3 -m capy.domo pair hue [IP]  ou  pair homeassistant URL")
+            sys.exit("Usage : capy domo pair hue [IP]  ou  pair homeassistant URL")
         for device in added:
             print(f"  + {device.name:<18} {device.brand}")
         print(f"{len(added)} appareil(s) ajouté(s) dans {home.save()}")
@@ -131,7 +131,7 @@ def main(args):
         else:
             names, groups, scenes = list(home.devices), home.groups, list(home.scenes)
             states = home.all().state() if home.devices else {}
-        print("Appareils :" if names else "Aucun appareil : lance  python3 -m capy.domo scan")
+        print("Appareils :" if names else "Aucun appareil : lance  capy domo scan")
         for name in names:
             print(show_state(name, states.get(name, {"reachable": False})))
         if groups:
@@ -143,7 +143,7 @@ def main(args):
 
     elif command == "scene":
         if not rest:
-            sys.exit("Usage : python3 -m capy.domo scene NOM")
+            sys.exit("Usage : capy domo scene NOM")
         home.scene(rest[0])
         print(f"Scène {rest[0]!r} lancée")
 
@@ -170,7 +170,7 @@ def main(args):
         print(f"{command} : ok")
 
 
-# Point d'entrée de python3 -m capy.domo
+# Point d'entrée de capy domo
 def cli(args=None):
     try:
         main(sys.argv[1:] if args is None else args)

{capyy-0.5.1 → capyy-0.5.2}/capy/domo/_homeassistant.py

@@ -32,7 +32,7 @@ class HassEntity(Device):
 
     def _request(self, method, path, body=None):
         if not self.url or not self.token:
-            raise ConnectionError("Home Assistant pas configuré : python3 -m capy.domo pair homeassistant URL")
+            raise ConnectionError("Home Assistant pas configuré : capy domo pair homeassistant URL")
         return request(self.url, self.token, method, path, body)
 
     def _apply(self, changes):

{capyy-0.5.1 → capyy-0.5.2}/capy/domo/_hue.py

@@ -31,7 +31,7 @@ def _check(answer):
         return answer
     error = errors[0]
     if error.get("type") == 1:
-        raise ConnectionError("le pont Hue ne te connaît pas : refais python3 -m capy.domo pair hue")
+        raise ConnectionError("le pont Hue ne te connaît pas : refais capy domo pair hue")
     raise ConnectionError(f"pont Hue : {error.get('description', error)}")
 
 
@@ -78,7 +78,7 @@ class HueLight(Device):
 
     def _path(self, end=""):
         if not self.user:
-            raise ConnectionError(f"pas d'appairage avec le pont {self.host} : python3 -m capy.domo pair hue {self.host}")
+            raise ConnectionError(f"pas d'appairage avec le pont {self.host} : capy domo pair hue {self.host}")
         return f"/api/{self.user}/lights/{self.id}{end}"
 
     def _apply(self, changes):

{capyy-0.5.1 → capyy-0.5.2}/capy/network.py

@@ -3,7 +3,7 @@
 # Les serveurs s'y connectent (même derrière une box) et s'enregistrent sous un nom,
 # les clients appellent un nom : le relais fait passer la demande et la réponse.
 #
-#   Sur le VPS     : python3 -m capy.network 3879 motdepasse
+#   Sur le VPS     : capy relay 3879 motdepasse
 #   Partout ailleurs :
 #       capy.network.use("mon-vps.fr:3879", key="motdepasse")
 #       capy.network.Server("maison").run()       /  capy.network.call("maison", "test")
@@ -495,9 +495,13 @@ def call(name, action, /, **params) -> Any:
     return reply["response"]
 
 
-# Lancer un relais depuis le terminal : python3 -m capy.network 3879 motdepasse
+# Lancer un relais depuis le terminal : capy relay 3879 motdepasse (ou capy relay 3879 motdepasse)
+def cli(args=None):
+    args = sys.argv[1:] if args is None else args
+    if not args or not args[0].isdigit():
+        sys.exit("Usage : capy relay PORT [CLÉ]   (ex : capy relay 3879 \"$CAPY_KEY\")")
+    Relay(int(args[0]), key=args[1] if len(args) > 1 else None).run()
+
+
 if __name__ == "__main__":
-    if len(sys.argv) < 2 or not sys.argv[1].isdigit():
-        print("Usage : python3 -m capy.network PORT [CLÉ]")
-        sys.exit(1)
-    Relay(int(sys.argv[1]), key=sys.argv[2] if len(sys.argv) > 2 else None).run()
+    cli()

{capyy-0.5.1 → capyy-0.5.2}/capyy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: capyy
-Version: 0.5.1
+Version: 0.5.2
 Summary: Easy, encrypted networking for Python: programs that talk (local, Wi-Fi, internet), home automation, and projects run with cy
 Author: Izac
 License-Expression: MIT
@@ -82,7 +82,7 @@ what could not be converted.
 Describe the whole project once, then never repeat ports or hosts:
 
 ```bash
-python3 -m capy new my-game     # folder + capy.config.json + server.py + client.py
+capy new my-game     # folder + capy.config.json + server.py + client.py
 cd my-game
 cy run             # starts the server, runs the client, stops the server
 ```
@@ -99,7 +99,7 @@ app.call("hello", nom="Izac")   # client side
 ```
 
 `mode` can be `local`, `wifi` or `network` (with `relay`, `key`, `fingerprint`). Strings starting with `$` are read
-from environment variables, e.g. `"key": "$CAPY_KEY"`. Inside a project, the `cy` command runs its `scripts` like `npm run` (`cy test`, `cy start`) and its files (`cy server`); create a project with `python3 -m capy new`.
+from environment variables, e.g. `"key": "$CAPY_KEY"`. Inside a project, the `cy` command runs its `scripts` like `npm run` (`cy test`, `cy start`) and its files (`cy server`); create a project with `capy new`.
 
 ## Encryption (TLS)
 
@@ -131,7 +131,7 @@ A machine behind a home router cannot be reached from the internet, so `capy.net
 clients call that name. Everything is encrypted, and the connection is kept open between calls.
 
 ```bash
-python3 -m capy.network 3879 my-secret-key      # on the VPS (open the port in its firewall)
+capy relay 3879 my-secret-key      # on the VPS (open the port in its firewall)
 ```
 
 ```python
@@ -158,9 +158,9 @@ capy.domo.serve(home)          # control it remotely through capy / capy.wifi /
 ```
 
 ```bash
-python3 -m capy.domo scan
-python3 -m capy.domo pair hue
-python3 -m capy.domo salon on 30% orange
+capy domo scan
+capy domo pair hue
+capy domo salon on 30% orange
 ```
 
 ## License

{capyy-0.5.1 → capyy-0.5.2}/capyy.egg-info/entry_points.txt

@@ -1,2 +1,3 @@
 [console_scripts]
+capy = capy.__main__:capy_cli
 cy = capy.__main__:cli

{capyy-0.5.1 → capyy-0.5.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "capyy"
-version = "0.5.1"
+version = "0.5.2"
 description = "Easy, encrypted networking for Python: programs that talk (local, Wi-Fi, internet), home automation, and projects run with cy"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -25,7 +25,8 @@ classifiers = [
 ]
 
 [project.scripts]
-cy = "capy.__main__:cli"   # La commande cy (= python3 -m capy)
+cy = "capy.__main__:cli"          # Dans un projet : cy start, cy test…
+capy = "capy.__main__:capy_cli"   # Partout : capy new, capy domo, capy relay… (= python3 -m capy)
 
 [project.urls]
 Homepage = "https://libs.zazac.link/capy/"