remoteRF-server 0.1.62__tar.gz → 0.1.63__tar.gz

{remoterf_server-0.1.62 → remoterf_server-0.1.63}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: remoteRF-server
-Version: 0.1.62
+Version: 0.1.63
 Description-Content-Type: text/markdown
 Requires-Dist: grpcio
 Requires-Dist: protobuf
@@ -283,13 +283,11 @@ Note that all device and server config parameters need a 'restart' to take affec
 
 After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**. This interactive shell is used for runtime administration: managing users, devices, reservations, user groups, and enrollment codes.
 
-> Tip: Legacy commands (e.g. `show a`, `rm db`) may still work if enabled, but the commands below are the canonical interface.
-
 ---
 
 #### Server
 
-* `help` / `?` — Show help
+* `help` / `h` — Show help
 * `clear` — Clear the screen
 * `status` — Show server status (uptime / bind info)
 * `quit` / `exit` — Exit the server shell
@@ -299,8 +297,8 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 #### Users
 
 * `users list` — List all accounts
-* `users manage` — Manage a specific user (permissions / deletion / reservations) *(interactive)*
-* `users purge` — Remove **all** users
+* `users manage` — Manage a specific user 
+* `users purge` — Delete **all** users
 
 ---
 
@@ -313,7 +311,7 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 #### Reservations
 
 * `reservations list` — List all reservations
-* `reservations purge` — Remove **all** reservations
+* `reservations purge` — Delete **all** reservations
 
 ---
 
@@ -323,6 +321,7 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 * `groups create` — Create a user group *(interactive)*
 * `groups edit` — Edit a user group *(interactive)*
 * `groups delete` — Delete a user group *(interactive)*
+* `groups csv` - Export all groups as a CSV
 
 ---
 
@@ -331,12 +330,13 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 * `codes list` — List enrollment codes
 * `codes create` — Create enrollment codes *(interactive)*
 * `codes delete` — Delete an enrollment code *(interactive)*
+* `codes csv` - Export all codes as a CSV
 
 ---
 
 #### Database
 
-* `db reset` — Remove all database entries
+* `db purge` — Remove all database entries
 
 ---
 
@@ -344,17 +344,30 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 todo:
 <!-- Adding plutos via the CLI -->
 <!-- Testing functionality (disregarding Host pipeline) -->
-Clean up serverrf CLI + basic documentation for all commands, usergroups, export codes by CSV.
-Choice to choose usergroup/code by either int id or string name.
+<!-- Clean up serverrf CLI + basic documentation for all commands, usergroups, export codes by CSV. -->
 
-Ability to remotely manage groups and codes as admin.
+HostRF meta data -> push upon connection + retry connection on host side.
+
+ServerRF display meta data as part of devices list / reservation + online/activity status (appended into device name) + (plus host side warning if the device id is NOT globally unique!)
+
+set_device token (virtual devices) + routing/relay to proper host (multiplexed)
 
-HostRF integration -> Host directory, device routing, dynamic reservation pulling, with activity/status (online, offline, etc.) 
+User side testing + integration
+
+hostrf side CLI/server (basically just device list)
+
+edge case testing (disconnected hosts, disconnected server, many users using multiple devices, multi-host)
+
+<!-- HostRF integration -> Host directory, device routing, dynamic reservation pulling, with activity/status (online, offline, etc.)  -->
 
 Cleanup code comments.
 
 Update Ian with installation demo (try myself first on the NUC once!) for both server and host.
 
+Nice to have (later):
+Activity/stats?
+Ability to remotely manage groups and codes as admin.
+Choice to choose usergroup/code by either int id or string name. (too lazy)
 
 todo: Specify/Pull user side --config CLI pointing to this server + debug for connection sake (later)
 

{remoterf_server-0.1.62 → remoterf_server-0.1.63}/README.md

@@ -272,13 +272,11 @@ Note that all device and server config parameters need a 'restart' to take affec
 
 After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**. This interactive shell is used for runtime administration: managing users, devices, reservations, user groups, and enrollment codes.
 
-> Tip: Legacy commands (e.g. `show a`, `rm db`) may still work if enabled, but the commands below are the canonical interface.
-
 ---
 
 #### Server
 
-* `help` / `?` — Show help
+* `help` / `h` — Show help
 * `clear` — Clear the screen
 * `status` — Show server status (uptime / bind info)
 * `quit` / `exit` — Exit the server shell
@@ -288,8 +286,8 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 #### Users
 
 * `users list` — List all accounts
-* `users manage` — Manage a specific user (permissions / deletion / reservations) *(interactive)*
-* `users purge` — Remove **all** users
+* `users manage` — Manage a specific user 
+* `users purge` — Delete **all** users
 
 ---
 
@@ -302,7 +300,7 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 #### Reservations
 
 * `reservations list` — List all reservations
-* `reservations purge` — Remove **all** reservations
+* `reservations purge` — Delete **all** reservations
 
 ---
 
@@ -312,6 +310,7 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 * `groups create` — Create a user group *(interactive)*
 * `groups edit` — Edit a user group *(interactive)*
 * `groups delete` — Delete a user group *(interactive)*
+* `groups csv` - Export all groups as a CSV
 
 ---
 
@@ -320,12 +319,13 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 * `codes list` — List enrollment codes
 * `codes create` — Create enrollment codes *(interactive)*
 * `codes delete` — Delete an enrollment code *(interactive)*
+* `codes csv` - Export all codes as a CSV
 
 ---
 
 #### Database
 
-* `db reset` — Remove all database entries
+* `db purge` — Remove all database entries
 
 ---
 
@@ -333,17 +333,30 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 todo:
 <!-- Adding plutos via the CLI -->
 <!-- Testing functionality (disregarding Host pipeline) -->
-Clean up serverrf CLI + basic documentation for all commands, usergroups, export codes by CSV.
-Choice to choose usergroup/code by either int id or string name.
+<!-- Clean up serverrf CLI + basic documentation for all commands, usergroups, export codes by CSV. -->
 
-Ability to remotely manage groups and codes as admin.
+HostRF meta data -> push upon connection + retry connection on host side.
+
+ServerRF display meta data as part of devices list / reservation + online/activity status (appended into device name) + (plus host side warning if the device id is NOT globally unique!)
+
+set_device token (virtual devices) + routing/relay to proper host (multiplexed)
 
-HostRF integration -> Host directory, device routing, dynamic reservation pulling, with activity/status (online, offline, etc.) 
+User side testing + integration
+
+hostrf side CLI/server (basically just device list)
+
+edge case testing (disconnected hosts, disconnected server, many users using multiple devices, multi-host)
+
+<!-- HostRF integration -> Host directory, device routing, dynamic reservation pulling, with activity/status (online, offline, etc.)  -->
 
 Cleanup code comments.
 
 Update Ian with installation demo (try myself first on the NUC once!) for both server and host.
 
+Nice to have (later):
+Activity/stats?
+Ability to remotely manage groups and codes as admin.
+Choice to choose usergroup/code by either int id or string name. (too lazy)
 
 todo: Specify/Pull user side --config CLI pointing to this server + debug for connection sake (later)
 

{remoterf_server-0.1.62 → remoterf_server-0.1.63}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "remoteRF-server"
-version = "0.1.62"
+version = "0.1.63"
 dependencies = [
   "grpcio",
   "protobuf",

{remoterf_server-0.1.62 → remoterf_server-0.1.63}/src/remoteRF_server/host/host_tunnel_server.py

@@ -32,6 +32,11 @@ from .host_directory_store import (
     cfg_dir_from_file,
 )
 
+import hashlib
+
+def host_key(host_id: str) -> str:
+    h = hashlib.sha256((host_id or "").encode("utf-8")).hexdigest()
+    return h[:16]  # short stable key
 
 def _copy_argument_map(dst_map: Any, src_map: Any) -> None:
     if src_map is None:
@@ -272,13 +277,25 @@ class HostTunnelRegistry:
     # ---------------------------
     # persistence write helpers
     # ---------------------------
+    def _persist_host_meta(self, host_id: str, *, host_name: str = "", platform: str = "", version: str = "") -> None:
+        hk = host_key(host_id)
+        self._env_meta.set_kv_if_absent(f"HOST_{hk}_ID", host_id)
+        if host_name:
+            self._env_meta.upsert_kv(f"HOST_{hk}_NAME", host_name)
+        if platform:
+            self._env_meta.upsert_kv(f"HOST_{hk}_PLATFORM", platform)
+        if version:
+            self._env_meta.upsert_kv(f"HOST_{hk}_VERSION", version)
 
     def _persist_host(self, host_id: str) -> None:
         self._env_lists.append_to_csv_list("KNOWN_HOSTS", host_id)
 
     def _persist_device(self, host_id: str, device_id: str, local_id: int, device_info: Any) -> None:
         self._env_lists.append_to_csv_list("KNOWN_DEVICES", device_id)
-        self._env_lists.append_to_csv_list(f"HOST_{sanitize_env_key(host_id)}_DEVICES", device_id)
+        hk = host_key(host_id)
+        self._env_meta.set_kv_if_absent(f"HOST_{hk}_ID", host_id)  # reverse map
+        self._env_lists.append_to_csv_list(f"HOST_{hk}_DEVICES", device_id)
+
 
         dk = sanitize_env_key(device_id)
         self._env_meta.upsert_kv(f"DEVICE_{dk}_HOST", host_id)
@@ -692,6 +709,7 @@ class HostTunnelServicer(host_tunnel_pb2_grpc.HostTunnelServicer):
                         host_id = str(hello.host_id).strip() or "unknown-host"
                         session = HostSession(host_id)
                         self.registry.register_host(host_id, session)
+                        self.registry.persist_host_meta_from_hello(hello)
 
                         try:
                             session.send(

{remoterf_server-0.1.62 → remoterf_server-0.1.63}/src/remoteRF_server/server/grpc_server.py

@@ -490,7 +490,7 @@ def help() -> None:
     print()
 
     printf("Database:", Sty.BOLD)
-    printf("  db reset                 ", Sty.MAGENTA, "- Remove all database entries", Sty.DEFAULT)
+    printf("  db purge                 ", Sty.MAGENTA, "- Remove all database entries", Sty.DEFAULT)
     print()
 
 def server_input(inpu: str) -> bool:
@@ -546,7 +546,7 @@ def server_input(inpu: str) -> bool:
         "rm ar": lambda: _stay(reservation_handler.remove_all_reservations),  # old
 
         # ---- db ----
-        "db reset": lambda: _stay(reservation_handler.rm_db),
+        "db purge": lambda: _stay(reservation_handler.rm_db),
         "rm db": lambda: _stay(reservation_handler.rm_db),  # old
 
         # ---- groups ----

{remoterf_server-0.1.62 → remoterf_server-0.1.63}/src/remoteRF_server.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: remoteRF-server
-Version: 0.1.62
+Version: 0.1.63
 Description-Content-Type: text/markdown
 Requires-Dist: grpcio
 Requires-Dist: protobuf
@@ -283,13 +283,11 @@ Note that all device and server config parameters need a 'restart' to take affec
 
 After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**. This interactive shell is used for runtime administration: managing users, devices, reservations, user groups, and enrollment codes.
 
-> Tip: Legacy commands (e.g. `show a`, `rm db`) may still work if enabled, but the commands below are the canonical interface.
-
 ---
 
 #### Server
 
-* `help` / `?` — Show help
+* `help` / `h` — Show help
 * `clear` — Clear the screen
 * `status` — Show server status (uptime / bind info)
 * `quit` / `exit` — Exit the server shell
@@ -299,8 +297,8 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 #### Users
 
 * `users list` — List all accounts
-* `users manage` — Manage a specific user (permissions / deletion / reservations) *(interactive)*
-* `users purge` — Remove **all** users
+* `users manage` — Manage a specific user 
+* `users purge` — Delete **all** users
 
 ---
 
@@ -313,7 +311,7 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 #### Reservations
 
 * `reservations list` — List all reservations
-* `reservations purge` — Remove **all** reservations
+* `reservations purge` — Delete **all** reservations
 
 ---
 
@@ -323,6 +321,7 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 * `groups create` — Create a user group *(interactive)*
 * `groups edit` — Edit a user group *(interactive)*
 * `groups delete` — Delete a user group *(interactive)*
+* `groups csv` - Export all groups as a CSV
 
 ---
 
@@ -331,12 +330,13 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 * `codes list` — List enrollment codes
 * `codes create` — Create enrollment codes *(interactive)*
 * `codes delete` — Delete an enrollment code *(interactive)*
+* `codes csv` - Export all codes as a CSV
 
 ---
 
 #### Database
 
-* `db reset` — Remove all database entries
+* `db purge` — Remove all database entries
 
 ---
 
@@ -344,17 +344,30 @@ After running `serverrf --serve`, you’ll enter the **RemoteRF Server Shell**.
 todo:
 <!-- Adding plutos via the CLI -->
 <!-- Testing functionality (disregarding Host pipeline) -->
-Clean up serverrf CLI + basic documentation for all commands, usergroups, export codes by CSV.
-Choice to choose usergroup/code by either int id or string name.
+<!-- Clean up serverrf CLI + basic documentation for all commands, usergroups, export codes by CSV. -->
 
-Ability to remotely manage groups and codes as admin.
+HostRF meta data -> push upon connection + retry connection on host side.
+
+ServerRF display meta data as part of devices list / reservation + online/activity status (appended into device name) + (plus host side warning if the device id is NOT globally unique!)
+
+set_device token (virtual devices) + routing/relay to proper host (multiplexed)
 
-HostRF integration -> Host directory, device routing, dynamic reservation pulling, with activity/status (online, offline, etc.) 
+User side testing + integration
+
+hostrf side CLI/server (basically just device list)
+
+edge case testing (disconnected hosts, disconnected server, many users using multiple devices, multi-host)
+
+<!-- HostRF integration -> Host directory, device routing, dynamic reservation pulling, with activity/status (online, offline, etc.)  -->
 
 Cleanup code comments.
 
 Update Ian with installation demo (try myself first on the NUC once!) for both server and host.
 
+Nice to have (later):
+Activity/stats?
+Ability to remotely manage groups and codes as admin.
+Choice to choose usergroup/code by either int id or string name. (too lazy)
 
 todo: Specify/Pull user side --config CLI pointing to this server + debug for connection sake (later)