remoteRF-server 1.7.12__tar.gz → 1.7.14__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (211) hide show
  1. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/PKG-INFO +33 -32
  2. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/README.md +32 -31
  3. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/pyproject.toml +1 -1
  4. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/remote_admin_shell.py +3 -3
  5. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/commands.py +1 -6
  6. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/global_onboarding.py +195 -36
  7. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/grpc_server.py +0 -4
  8. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/reservation.py +40 -166
  9. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/serverrf_cli.py +0 -327
  10. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server.egg-info/PKG-INFO +33 -32
  11. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server.egg-info/SOURCES.txt +0 -3
  12. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_client_sessions.py +100 -0
  13. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_global_onboarding.py +262 -8
  14. remoterf_server-1.7.12/src/remoteRF_server/tools/gist_status.py +0 -218
  15. remoterf_server-1.7.12/src/remoteRF_server/tools/gist_status_testing.py +0 -82
  16. remoterf_server-1.7.12/tests/test_status_push.py +0 -20
  17. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/LICENSE +0 -0
  18. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/setup.cfg +0 -0
  19. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/__init__.py +0 -0
  20. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/__init__.py +0 -0
  21. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/grpc/__init__.py +0 -0
  22. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/grpc/deployment_capabilities.proto +0 -0
  23. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/grpc/deployment_capabilities_pb2.py +0 -0
  24. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/grpc/deployment_capabilities_pb2_grpc.py +0 -0
  25. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/grpc/federation.proto +0 -0
  26. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/grpc/federation_pb2.py +0 -0
  27. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/grpc/federation_pb2_grpc.py +0 -0
  28. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/grpc/grpc_host_pb2.py +0 -0
  29. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/grpc/grpc_host_pb2_grpc.py +0 -0
  30. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/grpc/grpc_pb2.py +0 -0
  31. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/grpc/grpc_pb2_grpc.py +0 -0
  32. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/grpc/v2_codec.py +0 -0
  33. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/idl/__init__.py +0 -0
  34. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/idl/device_schema.py +0 -0
  35. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/idl/pluto_mimo_schema.py +0 -0
  36. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/idl/pluto_schema.py +0 -0
  37. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/idl/schema.py +0 -0
  38. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/idl/v2.py +0 -0
  39. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/utils/__init__.py +0 -0
  40. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/utils/ansi_codes.py +0 -0
  41. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/utils/api_token.py +0 -0
  42. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/utils/db_connection.py +0 -0
  43. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/utils/db_location.py +0 -0
  44. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/utils/list_string.py +0 -0
  45. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/utils/panel.py +0 -0
  46. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/common/utils/process_arg.py +0 -0
  47. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/__init__.py +0 -0
  48. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/adalm_pluto/__init__.py +0 -0
  49. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/adalm_pluto/pluto_diag.py +0 -0
  50. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/adalm_pluto/pluto_mimo_schema.py +0 -0
  51. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/adalm_pluto/pluto_remote_server.py +0 -0
  52. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/adalm_pluto/pluto_schema.py +0 -0
  53. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/adalm_pluto/poe.py +0 -0
  54. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/bluetooth_diag.py +0 -0
  55. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/gps_diag.py +0 -0
  56. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/hackrf/__init__.py +0 -0
  57. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/hackrf/hackrf_schema.py +0 -0
  58. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/rtl_sdr/__init__.py +0 -0
  59. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/rtl_sdr/rtl_sdr_diag.py +0 -0
  60. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/rtl_sdr/rtl_sdr_schema.py +0 -0
  61. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/ti_mmwave/__init__.py +0 -0
  62. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/ti_mmwave/ti_mmwave_schema.py +0 -0
  63. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/usrp/__init__.py +0 -0
  64. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/usrp/policy.py +0 -0
  65. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/usrp/profiles.py +0 -0
  66. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/usrp/uhd_manifest.py +0 -0
  67. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/usrp/usrp_diag.py +0 -0
  68. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/usrp/usrp_schema.py +0 -0
  69. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/usrp_phaser/__init__.py +0 -0
  70. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/usrp_phaser/usrp_phaser_schema.py +0 -0
  71. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/wifi/__init__.py +0 -0
  72. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/drivers/wifi/wifi_schema.py +0 -0
  73. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/host/__init__.py +0 -0
  74. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/host/host_auth_token.py +0 -0
  75. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/host/host_directory_store.py +0 -0
  76. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/host/host_tunnel_server.py +0 -0
  77. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/__init__.py +0 -0
  78. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/acc_perms.py +0 -0
  79. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/cert_provider.py +0 -0
  80. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/console.py +0 -0
  81. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/control.py +0 -0
  82. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/deployment/__init__.py +0 -0
  83. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/deployment/capabilities.py +0 -0
  84. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/device_manager.py +0 -0
  85. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/diag.py +0 -0
  86. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/direct_path.py +0 -0
  87. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/dynamic_v2.py +0 -0
  88. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/dynamic_v2_bridge.py +0 -0
  89. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/__init__.py +0 -0
  90. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/admin.py +0 -0
  91. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/cli.py +0 -0
  92. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/cluster.py +0 -0
  93. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/contracts.py +0 -0
  94. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/destination.py +0 -0
  95. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/devices.py +0 -0
  96. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/enrollment.py +0 -0
  97. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/global_home.py +0 -0
  98. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/home.py +0 -0
  99. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/home_devices.py +0 -0
  100. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/identity.py +0 -0
  101. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/legacy_state.py +0 -0
  102. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/links.py +0 -0
  103. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/migrations.py +0 -0
  104. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/peers.py +0 -0
  105. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/permissions.py +0 -0
  106. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/principals.py +0 -0
  107. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/runtime.py +0 -0
  108. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/federation/trust.py +0 -0
  109. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/host_direct.py +0 -0
  110. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/host_dynamic_v2.py +0 -0
  111. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/json_output.py +0 -0
  112. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/remote_admin.py +0 -0
  113. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/remote_admin_ssh.py +0 -0
  114. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/rpc_manager.py +0 -0
  115. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/schema_registry.py +0 -0
  116. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/startup_check.py +0 -0
  117. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/user_group_cli.py +0 -0
  118. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/user_group_handler.py +0 -0
  119. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/server/v2_errors.py +0 -0
  120. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/tools/__init__.py +0 -0
  121. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/tools/gen_certs.py +0 -0
  122. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server/tools/introspect_uhd.py +0 -0
  123. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server.egg-info/dependency_links.txt +0 -0
  124. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server.egg-info/entry_points.txt +0 -0
  125. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server.egg-info/requires.txt +0 -0
  126. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/remoteRF_server.egg-info/top_level.txt +0 -0
  127. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/rssi/__init__.py +0 -0
  128. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/rssi/cli.py +0 -0
  129. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/rssi/dongle.py +0 -0
  130. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/rssi/safety.py +0 -0
  131. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/src/rssi/scanner.py +0 -0
  132. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_account_hardening.py +0 -0
  133. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_account_names.py +0 -0
  134. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_account_removal.py +0 -0
  135. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_activity_log.py +0 -0
  136. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_availability.py +0 -0
  137. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_bind_host.py +0 -0
  138. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_cert_provider.py +0 -0
  139. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_cluster.py +0 -0
  140. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_commands.py +0 -0
  141. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_console.py +0 -0
  142. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_contrib_drivers.py +0 -0
  143. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_default_rtl_sdr_schema.py +0 -0
  144. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_default_usrp_schema.py +0 -0
  145. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_default_wifi_schema.py +0 -0
  146. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_deployment_capabilities.py +0 -0
  147. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_detached_device_rpc.py +0 -0
  148. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_device_core_aliases.py +0 -0
  149. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_device_handles.py +0 -0
  150. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_device_init.py +0 -0
  151. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_devices_add_wizard.py +0 -0
  152. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_devices_list.py +0 -0
  153. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_diag.py +0 -0
  154. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_direct_fixed_port.py +0 -0
  155. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_direct_path_server.py +0 -0
  156. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_dynamic_v2.py +0 -0
  157. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_federated_direct_path.py +0 -0
  158. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_federated_dynamic_v2.py +0 -0
  159. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_federation_edges.py +0 -0
  160. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_first_run.py +0 -0
  161. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_gate_d_contracts.py +0 -0
  162. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_gate_e_federation.py +0 -0
  163. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_gate_e_proto.py +0 -0
  164. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_gate_f_enrollment.py +0 -0
  165. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_gate_g1_logging.py +0 -0
  166. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_gate_g_permissions.py +0 -0
  167. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_gate_h_devices.py +0 -0
  168. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_gate_i_direct_path.py +0 -0
  169. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_gen_certs.py +0 -0
  170. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_global_accounts_migration.py +0 -0
  171. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_global_home.py +0 -0
  172. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_global_v1_disposal.py +0 -0
  173. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_hackrf_schema.py +0 -0
  174. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_home_device_plane.py +0 -0
  175. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_host_direct.py +0 -0
  176. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_host_directory_store.py +0 -0
  177. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_host_dynamic_v2.py +0 -0
  178. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_idl_schema.py +0 -0
  179. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_json_commands.py +0 -0
  180. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_lab_logins.py +0 -0
  181. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_panel.py +0 -0
  182. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_peer_transport.py +0 -0
  183. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_pluto_compat.py +0 -0
  184. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_pluto_poe.py +0 -0
  185. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_process_arg.py +0 -0
  186. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_proxy_lifecycle.py +0 -0
  187. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_remote_admin.py +0 -0
  188. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_reservation_cancel.py +0 -0
  189. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_reservation_handoff.py +0 -0
  190. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_reservation_policy_b.py +0 -0
  191. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_reservation_timestamps.py +0 -0
  192. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_rpc_manager_batch.py +0 -0
  193. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_rpc_manager_calln.py +0 -0
  194. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_rpc_manager_host_legacy.py +0 -0
  195. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_rpc_manager_rx_n.py +0 -0
  196. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_rtl_sdr_schema.py +0 -0
  197. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_schema_registry.py +0 -0
  198. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_soak_federation.py +0 -0
  199. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_startup_check.py +0 -0
  200. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_ti_mmwave_hardware.py +0 -0
  201. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_ti_mmwave_schema.py +0 -0
  202. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_user_group_cli.py +0 -0
  203. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_usrp_b205mini_uhd410_hardware.py +0 -0
  204. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_usrp_client_server_hardware.py +0 -0
  205. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_usrp_client_server_localhost.py +0 -0
  206. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_usrp_n210_client_server_hardware.py +0 -0
  207. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_usrp_preload.py +0 -0
  208. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_usrp_profiles.py +0 -0
  209. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_usrp_remoterf_rx_hardware.py +0 -0
  210. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_usrp_uhd410_hardware.py +0 -0
  211. {remoterf_server-1.7.12 → remoterf_server-1.7.14}/tests/test_wipe.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: remoteRF-server
3
- Version: 1.7.12
3
+ Version: 1.7.14
4
4
  Summary: RemoteRF server-side control package
5
5
  License: GPL-3.0-or-later
6
6
  Classifier: Programming Language :: Python :: 3
@@ -208,6 +208,38 @@ Headless and interactive shutdown both stop accepting RPCs, close all Dynamic
208
208
  v2 sessions/handles and native devices, stop the certificate provider, and
209
209
  terminate the reservation-update worker.
210
210
 
211
+ ### Joining Global from a service (no terminal)
212
+
213
+ A server started without a terminal (`serverrf --serve --headless` under
214
+ systemd, for example) cannot ask the RemoteRF Global question. It starts
215
+ outside Global and logs one line saying how to answer. Answer it explicitly,
216
+ either in the environment or in `~/.config/remoterf/server.env`, then restart:
217
+
218
+ ```bash
219
+ REMOTERF_GLOBAL_CONSENT=yes
220
+ REMOTERF_GLOBAL_NAME=westwood
221
+ REMOTERF_GLOBAL_EMAIL=admin@example.org
222
+ REMOTERF_GLOBAL_DISPLAY_NAME="Westwood Radio Lab"
223
+ ```
224
+
225
+ `REMOTERF_GLOBAL_DISPLAY_NAME` is optional (it defaults to the name), and
226
+ `REMOTERF_GLOBAL_CONSENT=no` opts out instead. Or run, from any shell on the
227
+ server:
228
+
229
+ ```bash
230
+ serverrf global join --yes --name westwood --email admin@example.org
231
+ ```
232
+
233
+ The variables are read only while the question is unanswered; an answer
234
+ already given is never changed by them. A missing or invalid value is logged
235
+ by name and nothing is sent. Once the request is in:
236
+
237
+ 1. A RemoteRF admin reviews it and emails a code to the contact address.
238
+ 2. Redeem it: `serverrf global verify <code>`.
239
+
240
+ If the service was already running when you ran `global join`, restart it so
241
+ it starts the relay.
242
+
211
243
  Take note of the Local IP and Local Port, for example, if you see:
212
244
 
213
245
  ```bash
@@ -953,37 +985,6 @@ serverrf --host --delete host-name
953
985
  serverrf --host --wipe
954
986
  ```
955
987
 
956
- ## Status (Optional)
957
-
958
- If you desire to pull the server information (ie: live updates of reservation, server usage parameters, etc.)
959
-
960
- It uses GitHub Gists to push the status updates.
961
-
962
- Create public gist on your github. Keep note of the file name: (example)
963
- https://gist.github.com/ethange1/2a35e08a90bf88a70dfe7f42a55685ed
964
-
965
- The last one is the "GIST_ID" part of the URL, e.g. "2a35e08a90bf88a70dfe7f42a55685ed"
966
-
967
- Creating the GitHub PAT Token
968
-
969
- * GitHub → Settings
970
- * Developer settings
971
- * Personal access tokens → Fine-grained tokens
972
- * Generate new token
973
- * Set repository access to "Public Respositories"
974
- * Permissions: enable Gists: Read and write
975
- * Generate + copy the token (you only see it once)
976
-
977
- ```bash
978
- serverrf --gist --set --id <gist_id> --file <filename>
979
- ```
980
-
981
- Run the server normally, and you should see your gist change every minute!
982
-
983
- ```bash
984
- serverrf -s
985
- ```
986
-
987
988
  <!-- todo: -->
988
989
  <!-- Adding plutos via the CLI -->
989
990
  <!-- Testing functionality (disregarding Host pipeline) -->
@@ -175,6 +175,38 @@ Headless and interactive shutdown both stop accepting RPCs, close all Dynamic
175
175
  v2 sessions/handles and native devices, stop the certificate provider, and
176
176
  terminate the reservation-update worker.
177
177
 
178
+ ### Joining Global from a service (no terminal)
179
+
180
+ A server started without a terminal (`serverrf --serve --headless` under
181
+ systemd, for example) cannot ask the RemoteRF Global question. It starts
182
+ outside Global and logs one line saying how to answer. Answer it explicitly,
183
+ either in the environment or in `~/.config/remoterf/server.env`, then restart:
184
+
185
+ ```bash
186
+ REMOTERF_GLOBAL_CONSENT=yes
187
+ REMOTERF_GLOBAL_NAME=westwood
188
+ REMOTERF_GLOBAL_EMAIL=admin@example.org
189
+ REMOTERF_GLOBAL_DISPLAY_NAME="Westwood Radio Lab"
190
+ ```
191
+
192
+ `REMOTERF_GLOBAL_DISPLAY_NAME` is optional (it defaults to the name), and
193
+ `REMOTERF_GLOBAL_CONSENT=no` opts out instead. Or run, from any shell on the
194
+ server:
195
+
196
+ ```bash
197
+ serverrf global join --yes --name westwood --email admin@example.org
198
+ ```
199
+
200
+ The variables are read only while the question is unanswered; an answer
201
+ already given is never changed by them. A missing or invalid value is logged
202
+ by name and nothing is sent. Once the request is in:
203
+
204
+ 1. A RemoteRF admin reviews it and emails a code to the contact address.
205
+ 2. Redeem it: `serverrf global verify <code>`.
206
+
207
+ If the service was already running when you ran `global join`, restart it so
208
+ it starts the relay.
209
+
178
210
  Take note of the Local IP and Local Port, for example, if you see:
179
211
 
180
212
  ```bash
@@ -920,37 +952,6 @@ serverrf --host --delete host-name
920
952
  serverrf --host --wipe
921
953
  ```
922
954
 
923
- ## Status (Optional)
924
-
925
- If you desire to pull the server information (ie: live updates of reservation, server usage parameters, etc.)
926
-
927
- It uses GitHub Gists to push the status updates.
928
-
929
- Create public gist on your github. Keep note of the file name: (example)
930
- https://gist.github.com/ethange1/2a35e08a90bf88a70dfe7f42a55685ed
931
-
932
- The last one is the "GIST_ID" part of the URL, e.g. "2a35e08a90bf88a70dfe7f42a55685ed"
933
-
934
- Creating the GitHub PAT Token
935
-
936
- * GitHub → Settings
937
- * Developer settings
938
- * Personal access tokens → Fine-grained tokens
939
- * Generate new token
940
- * Set repository access to "Public Respositories"
941
- * Permissions: enable Gists: Read and write
942
- * Generate + copy the token (you only see it once)
943
-
944
- ```bash
945
- serverrf --gist --set --id <gist_id> --file <filename>
946
- ```
947
-
948
- Run the server normally, and you should see your gist change every minute!
949
-
950
- ```bash
951
- serverrf -s
952
- ```
953
-
954
955
  <!-- todo: -->
955
956
  <!-- Adding plutos via the CLI -->
956
957
  <!-- Testing functionality (disregarding Host pipeline) -->
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "remoteRF-server"
7
- version = "1.7.12"
7
+ version = "1.7.14"
8
8
  description = "RemoteRF server-side control package"
9
9
  license = { text = "GPL-3.0-or-later" }
10
10
  requires-python = ">=3.10"
@@ -47,7 +47,7 @@ TIERS = {
47
47
  "help": READ, "status": READ, "devices list": READ, "users list": READ, "users perms": READ,
48
48
  "reservations list": READ, "groups list": READ, "codes list": READ, "hosts status": READ,
49
49
  "hosts tokens": READ, "certs list": READ, "config list": READ, "global status": READ,
50
- "cluster list": READ, "cluster info": READ, "gist list": READ, "users prune-proxies": READ,
50
+ "cluster list": READ, "cluster info": READ, "users prune-proxies": READ,
51
51
  "cluster codes list": READ, "schema browse": READ,
52
52
  # write
53
53
  "devices add": WRITE, "devices remove": WRITE, "devices rename": WRITE, "groups create": WRITE,
@@ -63,7 +63,7 @@ TIERS = {
63
63
  "groups remove": DESTRUCTIVE, "devices wipe": DESTRUCTIVE, "reservations purge": DESTRUCTIVE,
64
64
  "stats purge": DESTRUCTIVE, "hosts wipe": DESTRUCTIVE, "hosts forget": DESTRUCTIVE,
65
65
  "certs reset": DESTRUCTIVE, "certs wipe": DESTRUCTIVE, "config ports": DESTRUCTIVE,
66
- "cluster remove": DESTRUCTIVE, "gist set": DESTRUCTIVE, "gist wipe": DESTRUCTIVE,
66
+ "cluster remove": DESTRUCTIVE,
67
67
  # never remote: they cut remote access, nuke everything, or pin admins
68
68
  "stop": NEVER, "detach": NEVER, "clear": NEVER, "wipe": NEVER, "users purge": NEVER, "db purge": NEVER,
69
69
  "global cluster": NEVER, # an old alias for every `cluster` verb, remove included: use `cluster …`
@@ -74,7 +74,7 @@ TIERS = {
74
74
  }
75
75
  DENY_FLAGS = {"--secrets"}
76
76
  # Destructive commands whose own confirmation -y answers (the step-up asked already).
77
- TAKES_YES = {"devices wipe", "stats purge", "hosts wipe", "certs wipe", "gist wipe", "users prune-proxies",
77
+ TAKES_YES = {"devices wipe", "stats purge", "hosts wipe", "certs wipe", "users prune-proxies",
78
78
  "hosts tokens", "certs reset"}
79
79
  KEEP_BACKUPS = 10
80
80
  PAIR_CODE = re.compile(r"[A-Z2-7]{4}-[A-Z2-7]{4}-[A-Z2-7]{4}-[A-Z2-7]{4}")
@@ -156,7 +156,7 @@ def _table() -> list[Command]:
156
156
  Command(("config wipe",), "Forget ports/address [-y]; asked at next start", _shell("cmd_config_wipe"), "Config", after="restart"),
157
157
  # ---- global / federation ----
158
158
  Command(("global status",), "Participation state", _global("status"), "Global"),
159
- Command(("global join",), "Request a public address", _global("join"), "Global"),
159
+ Command(("global join",), "Request a public address [--yes --name <n> --email <e>]", _global("join"), "Global"),
160
160
  Command(("global verify",), "Redeem the emailed code [code]", _global("verify"), "Global"),
161
161
  Command(("global leave",), "Stop participating", _global("leave"), "Global"),
162
162
  # ---- driver schemas approved on RemoteRF Global (server/schema_registry.py) ----
@@ -178,10 +178,6 @@ def _table() -> list[Command]:
178
178
  Command(("cluster peers",), "Partner listeners this deployment dials directly: cluster peers [add <id> <host:port> --ca <ca.crt> | remove <id>]", _federation("peers"), "Clusters"),
179
179
  Command(("cluster accept",), "", _federation("accept"), "Clusters", hidden=True),
180
180
  Command(("global cluster",), "", _federation("cluster"), "Global", hidden=True),
181
- # ---- gist ----
182
- Command(("gist list",), "Show gist status settings [--secrets]", _shell("cmd_gist_show"), "Gist status"),
183
- Command(("gist set",), "gist set <gist_id> <file> [--token-stdin]", _shell("cmd_gist_set"), "Gist status"),
184
- Command(("gist wipe",), "Forget the gist settings [-y]", _shell("cmd_gist_wipe"), "Gist status"),
185
181
  # ---- database ----
186
182
  Command(("db export",), "Archive DBs, devices, keys, certs to ~/Downloads [dir]", _shell("cmd_db_export"), "Database"),
187
183
  Command(("stats purge",), "Delete the activity log (reservation stats) [-y]", _daemon("cmd_stats_purge"), "Database", where=D),
@@ -244,7 +240,6 @@ _SECTION_BLURB = {
244
240
  "Global": "public address and relay",
245
241
  "Clusters": "sharing devices with other deployments",
246
242
  "Schemas": "driver schemas approved on RemoteRF Global",
247
- "Gist status": "publishing status to a GitHub gist",
248
243
  "Database": "export, or wipe everything",
249
244
  "Remote admin": "admins who reach this console from anywhere",
250
245
  }
@@ -62,15 +62,17 @@ Once an hour it sends Global a short note: this deployment's name and
62
62
  ID, version, uptime, how many accounts (and how many visit from partner
63
63
  deployments), what devices it has, how many reservations are active, how many
64
64
  reservations have been made and the total time reserved so far (two numbers),
65
- and your LAN address. Nothing else leaves your server -- no credentials, no
66
- user or reservation details -- and the connection only goes outward.
67
- Global publishes the network totals, and each deployment's name, version,
68
- devices, when it joined and was last online, and how many reservations it
69
- has had and the time reserved, at https://{domain}/stats.json.
65
+ and your LAN address. For the devices you share on Global it also sends how
66
+ many reservations start in each hour of the day and on each day of the week
67
+ (UTC), and the reservations and time reserved per device type (counts only).
68
+ Nothing else leaves your server -- no credentials, no user or reservation
69
+ details -- and the connection only goes outward. Global publishes the network
70
+ totals, these breakdowns, and each deployment's name, version, devices, when
71
+ it joined and was last online, and how many reservations it has had and the
72
+ time reserved, at https://{domain}/stats.json.
70
73
 
71
74
  A RemoteRF admin will review your new deployment before its address goes live.
72
- If you opt out, you cannot opt back in without a full data reset. You may leave
73
- at any time:
75
+ If you opt out, you can still join later, and you may leave at any time:
74
76
 
75
77
  serverrf global join
76
78
  serverrf global leave"""
@@ -315,11 +317,14 @@ def _prompt_name() -> Optional[str]:
315
317
  return name
316
318
 
317
319
 
320
+ def _clean_display_name(name: str, default: str) -> str:
321
+ return name[:200] if name and all(ord(c) >= 32 and ord(c) != 127 for c in name) else default
322
+
323
+
318
324
  def _prompt_display_name(default: str) -> str:
319
325
  """A human-readable lab name. It is what a RemoteRF admin sees when they
320
326
  review the request, and what your users see in the client."""
321
- name = _ask(f" Display name [{default}]: ") or default
322
- return name[:200] if all(ord(c) >= 32 and ord(c) != 127 for c in name) else default
327
+ return _clean_display_name(_ask(f" Display name [{default}]: "), default)
323
328
 
324
329
 
325
330
  def _prompt_email() -> str:
@@ -348,7 +353,13 @@ def configure() -> bool:
348
353
  return True
349
354
 
350
355
 
351
- def submit_and_report() -> bool:
356
+ def mask_email(email: str) -> str:
357
+ """`a***@example.org`: recognisable to the operator, not quoted in a journal."""
358
+ local, _, host = email.partition("@")
359
+ return f"{local[:1]}***@{host}" if host else "***"
360
+
361
+
362
+ def submit_and_report(*, interactive: bool = True) -> bool:
352
363
  """Send the request and tell the operator where it stands."""
353
364
  from ..common.utils.panel import marker, print_panel
354
365
 
@@ -356,7 +367,7 @@ def submit_and_report() -> bool:
356
367
  try:
357
368
  submit_request()
358
369
  except GlobalError as exc:
359
- if exc.code == "name_taken":
370
+ if exc.code == "name_taken" and interactive:
360
371
  _warn(f" {load().get('GLOBAL_NAME')} was just taken on RemoteRF Global.")
361
372
  name = _prompt_name()
362
373
  if name is None:
@@ -375,12 +386,13 @@ def submit_and_report() -> bool:
375
386
  break
376
387
 
377
388
  kv = load()
389
+ email = kv.get("GLOBAL_EMAIL", "")
378
390
  print()
379
391
  print_panel(
380
392
  "One more step",
381
393
  [
382
394
  f"{marker()} Requested as {kv.get('GLOBAL_NAME')}. Once a RemoteRF "
383
- f"admin approves, they email a code to {kv.get('GLOBAL_EMAIL')}. "
395
+ f"admin approves, they email a code to {email if interactive else mask_email(email)}. "
384
396
  "Redeeming it puts you live:",
385
397
  "",
386
398
  " serverrf global verify <code>",
@@ -390,18 +402,81 @@ def submit_and_report() -> bool:
390
402
  return True
391
403
 
392
404
 
405
+ ENV_LABELS = {"name": "REMOTERF_GLOBAL_NAME", "email": "REMOTERF_GLOBAL_EMAIL"}
406
+ CLI_LABELS = {"name": "--name", "email": "--email"}
407
+
408
+
409
+ def _env_answers() -> Dict[str, str]:
410
+ """REMOTERF_GLOBAL_{CONSENT,NAME,DISPLAY_NAME,EMAIL}: the process
411
+ environment first, then the lab's server.env (where a service keeps them)."""
412
+ server_env = read_env_kv(cfg_dir() / "server.env")
413
+ return {
414
+ field: (os.getenv(f"REMOTERF_GLOBAL_{field}") or server_env.get(f"REMOTERF_GLOBAL_{field}", "")).strip()
415
+ for field in ("CONSENT", "NAME", "DISPLAY_NAME", "EMAIL")
416
+ }
417
+
418
+
419
+ def join_unattended(name: str, email: str, display_name: str = "", *, labels: Dict[str, str]) -> bool:
420
+ """configure() + submit_and_report() without a prompt, for consent given
421
+ explicitly (REMOTERF_GLOBAL_CONSENT=yes, `global join --yes`). A missing or
422
+ invalid answer is one line naming it, and nothing is recorded or sent."""
423
+ name = name.strip().lower()
424
+ email = email.strip()
425
+ problem = None
426
+ if not NAME_RE.match(name):
427
+ problem = f"{labels['name']} " + (
428
+ f"{name!r} is not a valid name: use 3-32 lowercase letters, digits and dashes"
429
+ if name else "is not set"
430
+ )
431
+ elif not EMAIL_RE.match(email):
432
+ problem = f"{labels['email']} " + ("is not a valid email address" if email else "is not set")
433
+ elif name_available(name) is False:
434
+ problem = f"{name} is already registered on RemoteRF Global; choose another {labels['name']}"
435
+ if problem:
436
+ _warn(f" RemoteRF Global: {problem}. Not joining.")
437
+ return False
438
+ update(
439
+ GLOBAL_CONSENT="yes",
440
+ GLOBAL_NAME=name,
441
+ GLOBAL_DISPLAY_NAME=_clean_display_name(display_name, name),
442
+ GLOBAL_EMAIL=email,
443
+ GLOBAL_STATE="unregistered",
444
+ )
445
+ ensure_identity()
446
+ return submit_and_report(interactive=False)
447
+
448
+
393
449
  def ensure_consent() -> bool:
394
450
  """Ask once, at first run, immediately after the Terms of Service.
395
451
 
452
+ REMOTERF_GLOBAL_CONSENT=yes|no (environment or server.env) answers it
453
+ without a terminal; unset, a service start leaves it unanswered.
396
454
  Returns False only when the operator aborted the prompt outright; a plain
397
455
  "no" is a complete, durable answer and the server starts normally.
398
456
  """
399
457
  if load().get("GLOBAL_CONSENT", "").lower() in {"yes", "no"}:
400
458
  return True
459
+ env = _env_answers()
460
+ answer = env["CONSENT"].lower()
461
+ if answer == "no":
462
+ update(GLOBAL_CONSENT="no")
463
+ print("RemoteRF Global: opted out (REMOTERF_GLOBAL_CONSENT=no); `serverrf global join` joins later.")
464
+ return True
465
+ if answer == "yes":
466
+ join_unattended(env["NAME"], env["EMAIL"], env["DISPLAY_NAME"], labels=ENV_LABELS)
467
+ return True
468
+ if answer:
469
+ _warn(f" RemoteRF Global: REMOTERF_GLOBAL_CONSENT={answer!r} is not yes or no; ignored.")
401
470
  if sys.stdin is None or not sys.stdin.isatty():
402
471
  # A service start (--headless under systemd) has no one to answer:
403
- # start outside Global and ask at the next start from a terminal.
404
- print("RemoteRF Global participation not asked (no terminal); `serverrf global join` joins.")
472
+ # start outside Global and say how to answer without a terminal.
473
+ print(
474
+ "RemoteRF Global participation not asked (no terminal). To join, set "
475
+ "REMOTERF_GLOBAL_CONSENT=yes, REMOTERF_GLOBAL_NAME and REMOTERF_GLOBAL_EMAIL "
476
+ f"(environment or {cfg_dir() / 'server.env'}) and restart, or run "
477
+ "`serverrf global join --yes --name <name> --email <email>`; "
478
+ "REMOTERF_GLOBAL_CONSENT=no opts out."
479
+ )
405
480
  return True
406
481
  from ..common.utils.panel import print_panel
407
482
 
@@ -737,6 +812,7 @@ STATUS_FIELDS = frozenset(
737
812
  "active_reservations",
738
813
  "reservations",
739
814
  "reserved_s",
815
+ "usage",
740
816
  "lan_address",
741
817
  "cert_sha256",
742
818
  }
@@ -758,23 +834,24 @@ def _db_dir() -> Path:
758
834
  return cfg_dir() / "db"
759
835
 
760
836
 
761
- def _count(database: Path, sql: str, params=()) -> int:
837
+ def _rows(database: Path, sql: str, params=()) -> list:
762
838
  import sqlite3
763
839
 
764
840
  if not database.exists():
765
- return 0
841
+ return []
766
842
  try:
767
843
  with sqlite3.connect(f"file:{database}?mode=ro", uri=True, timeout=2.0) as db:
768
- return int(db.execute(sql, params).fetchone()[0])
844
+ return db.execute(sql, params).fetchall()
769
845
  except sqlite3.Error:
770
- return 0
846
+ return []
771
847
 
772
848
 
773
- def device_summary() -> list:
774
- """One entry per registered device: its type and whether it is connected.
849
+ def _count(database: Path, sql: str, params=()) -> int:
850
+ rows = _rows(database, sql, params)
851
+ return int(rows[0][0]) if rows else 0
775
852
 
776
- Types and counts only — never a device identifier, serial, or any data.
777
- """
853
+
854
+ def _registered_devices() -> list:
778
855
  import yaml
779
856
 
780
857
  path = cfg_dir() / "devices.yml"
@@ -783,23 +860,74 @@ def device_summary() -> list:
783
860
  devices = data.get("devices") or []
784
861
  except (OSError, yaml.YAMLError):
785
862
  return []
863
+ return [item for item in devices if type(item) is dict and "device_id" in item]
864
+
865
+
866
+ def _device_type(item: dict) -> str:
867
+ return str(item.get("device_type") or "unknown").lower()
868
+
869
+
870
+ def _device_types() -> dict:
871
+ """Device id -> type: devices.yml entries, then the Host directory `serverrf status` lists.
872
+
873
+ Types are bounded the way Global accepts them: a Host names its own kinds.
874
+ """
875
+ types = {int(item["device_id"]): _device_type(item) for item in _registered_devices()}
876
+ try:
877
+ from ..host import host_tunnel_server as hts
878
+
879
+ directory = hts.get_tunnel_registry().device_directory_cached(ttl_ms=0)
880
+ except Exception: # noqa: BLE001 - drivers are optional at report time
881
+ directory = {}
882
+ for device_id, (_host_id, info, _active) in directory.items():
883
+ if str(device_id).isdigit():
884
+ types.setdefault(int(device_id), str(getattr(info, "kind", "") or "").strip().lower() or "unknown")
885
+ return {gid: re.sub(r"[^a-z0-9_]", "_", kind)[:64] for gid, kind in types.items()}
886
+
887
+
888
+ def device_summary() -> list:
889
+ """One entry per registered device: its type and whether it is connected.
890
+
891
+ Types and counts only — never a device identifier, serial, or any data.
892
+ """
786
893
  try:
787
894
  from . import device_manager
788
895
 
789
896
  connected = set(device_manager.get_all_devices())
790
897
  except Exception: # noqa: BLE001 - drivers are optional at report time
791
898
  connected = set()
792
- summary = []
793
- for item in devices:
794
- if type(item) is not dict or "device_id" not in item:
899
+ return [{"type": kind, "online": gid in connected} for gid, kind in _device_types().items()]
900
+
901
+
902
+ def usage_summary() -> dict:
903
+ """Reservations made on the devices shared on Global: by the UTC hour and
904
+ weekday they start, and reservations and seconds reserved per device type.
905
+
906
+ Counts only (ReservationBuckets); all zero when nothing is shared there.
907
+ """
908
+ from .federation import cluster
909
+
910
+ usage = {"by_hour": [0] * 24, "by_weekday": [0] * 7, "by_type": {}}
911
+ try:
912
+ shared = {int(d) for group in cluster.groups(cluster.GLOBAL) for d in group["devices"]}
913
+ except Exception: # noqa: BLE001 - not in the global cluster (yet), or its state is unreadable
914
+ return usage
915
+ types = _device_types()
916
+ by_type = {}
917
+ for device_id, bucket, n, seconds in _rows(
918
+ _db_dir() / "reservations.db",
919
+ "SELECT device_id, bucket, reservations, CAST(ROUND(seconds) AS INTEGER) FROM ReservationBuckets"):
920
+ if device_id not in shared:
795
921
  continue
796
- summary.append(
797
- {
798
- "type": str(item.get("device_type") or "unknown").lower(),
799
- "online": int(item["device_id"]) in connected,
800
- }
801
- )
802
- return summary
922
+ if bucket == "all":
923
+ totals = by_type.setdefault(types.get(device_id, "unknown"), {"reservations": 0, "seconds": 0})
924
+ totals["reservations"] += n
925
+ totals["seconds"] = min(totals["seconds"] + seconds, 2**31)
926
+ else:
927
+ usage["by_hour" if bucket[0] == "h" else "by_weekday"][int(bucket[1:])] += n
928
+ busiest = sorted((kv for kv in by_type.items() if kv[1]["reservations"]), key=lambda kv: -kv[1]["reservations"])
929
+ usage["by_type"] = dict(busiest[:64]) # Global takes at most 64 types
930
+ return usage
803
931
 
804
932
 
805
933
  def cert_sha256() -> Optional[str]:
@@ -832,6 +960,7 @@ def status_payload() -> dict:
832
960
  ),
833
961
  "reservations": _count(reservations, "SELECT n FROM ReservationCount"),
834
962
  "reserved_s": _count(reservations, "SELECT CAST(ROUND(seconds) AS INTEGER) FROM ReservedTotal"),
963
+ "usage": usage_summary(),
835
964
  "lan_address": lan_endpoint(),
836
965
  "cert_sha256": cert_sha256(),
837
966
  }
@@ -851,8 +980,9 @@ def send_status() -> None:
851
980
 
852
981
  payload = status_payload()
853
982
  # A Global older than a field refuses the note: drop the newest first
854
- # (`reservations`), then `proxies`/`reserved_s`, as the note was before them.
855
- steps = ((), ("reservations",), ("reservations", "proxies", "reserved_s"))
983
+ # (`usage`, then `reservations`), then `proxies`/`reserved_s`, as the note
984
+ # was before each of them.
985
+ steps = ((), ("usage",), ("usage", "reservations"), ("usage", "reservations", "proxies", "reserved_s"))
856
986
  for drop in steps:
857
987
  try:
858
988
  call("POST", REPORT_PATH, {"kind": "status", "status": {k: v for k, v in payload.items() if k not in drop}})
@@ -1257,11 +1387,37 @@ def cmd_status(refresh: bool = True, *, json_output: bool = False) -> int:
1257
1387
  return 0
1258
1388
 
1259
1389
 
1260
- def cmd_join() -> int:
1390
+ def _join_args(argv):
1391
+ import argparse
1392
+
1393
+ parser = argparse.ArgumentParser(prog="serverrf global join")
1394
+ parser.add_argument("-y", "--yes", action="store_true",
1395
+ help="consent without asking; needs --name and --email")
1396
+ parser.add_argument("--name", default="", help="3-32 lowercase letters, digits and dashes")
1397
+ parser.add_argument("--email", default="", help="contact address for the approval code")
1398
+ parser.add_argument("--display-name", default="", help="lab name shown to users (default: --name)")
1399
+ return parser.parse_args(list(argv))
1400
+
1401
+
1402
+ def cmd_join(argv=()) -> int:
1403
+ try:
1404
+ args = _join_args(argv)
1405
+ except SystemExit as exc: # -h, or a bad flag argparse already explained
1406
+ return int(exc.code or 0)
1261
1407
  if participating() and state() == "active":
1262
1408
  _warn(f" Already live on RemoteRF Global as {hostname()}.")
1263
1409
  _hint(" To re-register under different details, run `global leave` first.")
1264
1410
  return 1
1411
+ from ..common.utils.panel import print_panel
1412
+
1413
+ # Shown with --yes too: the operator sees what they are agreeing to.
1414
+ print()
1415
+ print_panel("RemoteRF Global participation", CONSENT_TEXT.format(domain=domain()))
1416
+ print()
1417
+ if args.yes:
1418
+ return 0 if join_unattended(args.name, args.email, args.display_name, labels=CLI_LABELS) else 1
1419
+ if not _confirm("Join RemoteRF Global?"):
1420
+ return 1
1265
1421
  if not configure():
1266
1422
  return 1
1267
1423
  return 0 if submit_and_report() else 1
@@ -1331,12 +1487,15 @@ _COMMANDS = {"status": cmd_status, "join": cmd_join, "leave": cmd_leave}
1331
1487
  def main(argv) -> int:
1332
1488
  if argv == ["status", "--json"]:
1333
1489
  return cmd_status(json_output=True)
1490
+ if argv and argv[0] == "join":
1491
+ return cmd_join(argv[1:])
1334
1492
  if argv and argv[0] == "verify":
1335
1493
  # A code pasted from email may arrive wrapped across lines.
1336
1494
  return cmd_verify("".join(argv[1:]))
1337
1495
  if len(argv) != 1 or argv[0] not in _COMMANDS:
1338
1496
  print(
1339
- "Usage: serverrf global status | join | verify <code> | leave",
1497
+ "Usage: serverrf global status | join [--yes --name <name> --email <email>] "
1498
+ "| verify <code> | leave",
1340
1499
  file=sys.stderr,
1341
1500
  )
1342
1501
  return 2
@@ -69,7 +69,6 @@ from prompt_toolkit import PromptSession
69
69
  from prompt_toolkit.input import DummyInput
70
70
  from prompt_toolkit.output import DummyOutput
71
71
 
72
- from ..tools.gist_status import start_status_publisher
73
72
  from .cert_provider import start_cert_provider, stop_cert_provider
74
73
  try:
75
74
  from . import direct_path
@@ -296,7 +295,6 @@ def start_server_runtime(
296
295
  cert_dir: Path | None = None,
297
296
  include_host_tunnel: bool = True,
298
297
  run_reservation_updates: bool = True,
299
- publish_status: bool = True,
300
298
  federation_executor: Any = None,
301
299
  home_federation_enroller: Any = None,
302
300
  home_federation_permissions: Any = None,
@@ -444,8 +442,6 @@ def start_server_runtime(
444
442
  )
445
443
  update_thread.start()
446
444
  start_usergroup_cleanup_loop(interval_sec=60)
447
- if publish_status:
448
- start_status_publisher()
449
445
  except BaseException: # Ctrl-C during the startup check too: close_local_devices powers Plutos down
450
446
  stop_event.set()
451
447
  server.stop(0)