RemoteRF 2.12.2__tar.gz → 2.13.0__tar.gz

{remoterf-2.12.2/src/remoterf.egg-info → remoterf-2.13.0}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: remoterf
-Version: 2.12.2
+Version: 2.13.0
 Summary: A python API to remotely access signal centric hardware. Client-side only! Courtesy of Wireless Lab @ UCLA & Prof. Ian Roberts.
-Author-email: Ethan Ge <ethoGalaxy@gmail.com>
+Author-email: Ethan Ge <84103791+ethange1@users.noreply.github.com>
 License-Expression: GPL-3.0-or-later
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
@@ -373,6 +373,11 @@ Pluto_02@deployment  pluto  online   in use until 13:45  -
 Pluto_03@deployment  pluto  offline  yours until 15:00   -
 ```
 
+Using a handle as `token=` with no live reservation of yours on that device
+reserves the current slot for you if it is free (the same booking `resdev` makes,
+with your usual limits), and says so on stderr. Set `REMOTERF_AUTO_RESERVE=0`
+to require a reservation first.
+
 Each account may ask once every 10 seconds; a repeat call within that reprints the last table with the remaining wait.
 
 ## Closing

{remoterf-2.12.2 → remoterf-2.13.0}/README.md

@@ -346,6 +346,11 @@ Pluto_02@deployment  pluto  online   in use until 13:45  -
 Pluto_03@deployment  pluto  offline  yours until 15:00   -
 ```
 
+Using a handle as `token=` with no live reservation of yours on that device
+reserves the current slot for you if it is free (the same booking `resdev` makes,
+with your usual limits), and says so on stderr. Set `REMOTERF_AUTO_RESERVE=0`
+to require a reservation first.
+
 Each account may ask once every 10 seconds; a repeat call within that reprints the last table with the remaining wait.
 
 ## Closing

{remoterf-2.12.2 → remoterf-2.13.0}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "remoterf"
-version = "2.12.2"
+version = "2.13.0"
 description = "A python API to remotely access signal centric hardware. Client-side only! Courtesy of Wireless Lab @ UCLA & Prof. Ian Roberts."
 readme = "README.md"
 license = "GPL-3.0-or-later"
 license-files = ["LICENSE"]
-authors = [{ name = "Ethan Ge", email = "ethoGalaxy@gmail.com" }]
+authors = [{ name = "Ethan Ge", email = "84103791+ethange1@users.noreply.github.com" }]
 requires-python = ">=3.10"
 dependencies = [
   "remoterf-federation-core==0.16.0",

{remoterf-2.12.2 → remoterf-2.13.0}/src/remoterf/admin.py

@@ -340,9 +340,11 @@ def cmd_login(target: str | None) -> int:
     alias = entry.get("alias") or _resolve(lab)[3]
     strict = trusted(alias)
     if not strict:
-        print(f"This machine has not trusted {lab}'s admin host key. Safer: a code from the lab console, "
-              f"`remoterf --remote-admin trust {lab} SHA256:…` with the fingerprint from a trusted place, or a "
-              f"copy of {known_hosts_path()} from a paired machine. Accepting it below on first sight trusts the "
+        print(f"This machine has not trusted {lab}'s admin host key. Safer options:\n"
+              "• Use a code from the lab console.\n"
+              f"• Or run `remoterf --remote-admin trust {lab} SHA256:…` with a verified fingerprint.\n"
+              f"• Copy {known_hosts_path()} from a paired machine.\n"
+              "Accepting it below on first sight trusts the "
               "network you are on.", file=sys.stderr)
     _save_lab(lab, {**entry, "user": user, "alias": alias})
     return _exec(ssh_argv(lab, user, alias, strict=strict))
@@ -371,9 +373,9 @@ def cmd_hostkey(lab: str) -> int:
 
 
 USAGE = """Usage:
-  remoterf --remote-admin [<user>@]<lab>          the lab's console (a menu with no lab)
+  remoterf --remote-admin [<user>@]<lab>            open a lab's admin console (prompts if <lab> is omitted)
   remoterf --remote-admin pair <user>@<lab> <code>  first time on this machine (code from: serverrf admins add/code)
-  remoterf --remote-admin trust <lab> SHA256:…      trust a host key fingerprint read somewhere trusted
+  remoterf --remote-admin trust <lab> SHA256:…      trust a verified host key fingerprint
   remoterf --remote-admin hostkey <lab>             show the lab's current host key"""
 
 

{remoterf-2.12.2 → remoterf-2.13.0}/src/remoterf/agent_cli.py

@@ -182,13 +182,13 @@ def _apps(a):
 
 def _reserve(a):
     if not a.confirm:
-        raise RemoteRFOpsError("usage", "Reserving changes the deployment's schedule: re-run with --confirm.")
+        raise RemoteRFOpsError("usage", "Dry run only. Re-run with --confirm to reserve this slot.")
     return ops.reserve(ops.saved_session(), a.handle, a.start, a.end, reveal_token=a.reveal_token)
 
 
 def _cancel(a):
     if not a.confirm:
-        raise RemoteRFOpsError("usage", "Cancelling gives the slot up: re-run with --confirm.")
+        raise RemoteRFOpsError("usage", "Dry run only. Re-run with --confirm to cancel this reservation.")
     return ops.cancel(ops.saved_session(), a.reservation_id)
 
 
@@ -271,6 +271,9 @@ def _ref(x):
 
 
 def _show_reservations(r, out):
+    if not r["reservations"]:
+        print("No reservations.", file=out)
+        return
     _table(out, [[_ref(x), x["handle"] or x["device"], _local(x["start_ts"]), "-", _local(x["end_ts"])]
                  for x in r["reservations"]])
 
@@ -316,12 +319,13 @@ def _parser():
     p.add_argument("--user", required=True, help="NAME, or NAME@deployment")
     p.add_argument("--password-stdin", action="store_true", required=True, help="read the password from stdin")
     p.add_argument("--accept-tos", action="store_true", help="agree to the RemoteRF Terms of Service")
-    command(auth, "status", lambda a: ops.whoami(ops.saved_session()), _show_whoami, "who the saved login is")
+    command(auth, "status", lambda a: ops.whoami(ops.saved_session()), _show_whoami, "show active login and deployments")
+    command(sub, "whoami", lambda a: ops.whoami(ops.saved_session()), _show_whoami, "same as `auth status`")
     command(auth, "logout", _logout, lambda r, out: print("Logged out.", file=out), "end and forget the saved login")
     p = command(auth, "apps", _apps, _show_apps, "apps connected through the RemoteRF Global connector (not available yet)")
     p.add_argument("--revoke", metavar="CLIENT_ID", help="disconnect one app")
     p = command(sub, "devices", lambda a: ops.list_devices(ops.saved_session(), deployment=a.deployment, online_only=not a.all),
-                _show_devices, "devices and their state now")
+                _show_devices, "list devices and current availability")
     p.add_argument("--deployment", help="only this deployment's devices")
     p.add_argument("--all", action="store_true", help="include offline devices")
     p = command(sub, "slots", lambda a: ops.find_slots(ops.saved_session(), a.handle, days=a.days),
@@ -333,12 +337,12 @@ def _parser():
     p.add_argument("handle")
     p.add_argument("--start", required=True, help="RFC 3339, for example 2026-10-15T14:00:00Z")
     p.add_argument("--end", required=True)
-    p.add_argument("--confirm", action="store_true", help="really reserve")
+    p.add_argument("--confirm", action="store_true", help="confirm reservation")
     p.add_argument("--reveal-token", action="store_true", help="include the raw reservation token")
-    p = command(sub, "cancel", _cancel, lambda r, out: print("Cancelled.", file=out),
+    p = command(sub, "cancel", _cancel, lambda r, out: print("Canceled.", file=out),
                 "cancel a reservation (needs --confirm)")
     p.add_argument("reservation_id", help="as `remoterf reservations` shows it, or a JSON reservation_id")
-    p.add_argument("--confirm", action="store_true", help="really cancel")
+    p.add_argument("--confirm", action="store_true", help="confirm cancellation")
     command(sub, "doctor", _doctor, _show_doctor, "check this install, its home and its login")
     return parser
 

{remoterf-2.12.2 → remoterf-2.13.0}/src/remoterf/agent_docs.py

@@ -188,7 +188,7 @@ def _print_api(api):
         if methods:
             print(f"\n{kind}s:")
         for m in methods:
-            doc = " ".join(m["doc"].split())
+            doc = " ".join(m["doc"].split()).removeprefix(f"{m['name']}:").strip()
             print(_clean(f"  {m['name']}" + (f"  {doc}" if doc else "")))
     for note in api["notes"]:
         print(f"\n{_clean(note)}")

{remoterf-2.12.2 → remoterf-2.13.0}/src/remoterf/common/utils/banner.py

@@ -108,11 +108,10 @@ def _panel_lines(
     top_left, top_right = ("╭", "╮") if unicode_supported else ("+", "+")
     bottom_left, bottom_right = ("╰", "╯") if unicode_supported else ("+", "+")
     vertical = "│" if unicode_supported else "|"
-    marker = "◆" if unicode_supported else "*"
     label = f"{horizontal} REMOTERF CLIENT "
     top = f"{top_left}{label}{horizontal * (PANEL_INNER_WIDTH - len(label))}{top_right}"
     content = [
-        f"{marker} www.remoterf.net",
+        "www.remoterf.net",
         "Created by the Wireless Lab at UCLA",
         f"VERSION  {version}",
     ]
@@ -139,12 +138,11 @@ def _internal_panel_lines(
     top_left, top_right = ("╭", "╮") if unicode_supported else ("+", "+")
     bottom_left, bottom_right = ("╰", "╯") if unicode_supported else ("+", "+")
     vertical = "│" if unicode_supported else "|"
-    marker = "◆" if unicode_supported else "*"
     label = f"{horizontal} REMOTERF SESSION "
     top = f"{top_left}{label}{horizontal * (PANEL_INNER_WIDTH - len(label))}{top_right}"
     display_tos = str(tos_url).removeprefix("https://").removeprefix("http://")
     content = (
-        f"{marker} www.remoterf.net",
+        "www.remoterf.net",
         f"VERSION  {version}",
         f"SERVER   {server or 'NA'}",
         f"TOS      {display_tos}",
@@ -165,9 +163,8 @@ def _compact_lines(
     unicode_supported: bool,
 ) -> list[str]:
     width = max(1, int(columns))
-    marker = "◆" if unicode_supported else "*"
     separator = "·" if unicode_supported else "-"
-    heading = f"{marker} REMOTERF CLIENT"
+    heading = "REMOTERF CLIENT"
     if len(heading) > width:
         heading = COMPACT_BANNER[:width]
 

{remoterf-2.12.2 → remoterf-2.13.0}/src/remoterf/config/config.py

@@ -110,7 +110,7 @@ def _confirm_wipe(root: Path) -> bool:
     try:
         return input(prompt).strip().lower() == "wipe"
     except KeyboardInterrupt:
-        print("\nCancelled.")
+        print("\nCanceled.")
         return False
 
 def _wipe_config(root: Path) -> None:
@@ -174,7 +174,7 @@ def _print_config_summary(host: str, grpc_port: int, cert_port: int, ca_out: Pat
 
 
 def _confirm_tos(question: str = "Continue with configuration? [y/N]: ",
-                 cancelled: str = "Configuration cancelled.") -> bool:
+                 cancelled: str = "Configuration canceled.") -> bool:
     _print_separator()
     _print_tos_notice()
     _print_separator()
@@ -219,7 +219,7 @@ def require_tos_for_login() -> bool:
     """Ask once, then remember -- until a registration clears it."""
     if tos_agreed():
         return True
-    if not _confirm_tos("Do you agree to the RemoteRF Terms of Service? [y/N]: ", "Login cancelled."):
+    if not _confirm_tos("Do you agree to the RemoteRF Terms of Service? [y/N]: ", "Login canceled."):
         return False
     remember_tos_agreement()
     return True
@@ -252,7 +252,7 @@ def configure(host: str, port: int, cert_port: int) -> int:
     overwrite = True
 
     if not _confirm_tos():
-        print("Configuration cancelled. Accept the Terms of Service to continue.")
+        print("Configuration canceled. Accept the Terms of Service to continue.")
         return 1
 
     certs_dir = _certs_dir()