Hide daemon command on Windows and update docs

Author: claudiodsf

docs/commands.rst

@@ -493,6 +493,12 @@ by a system scheduler (launchd on macOS, systemd on Linux). Each run
 executes exactly one cycle: ``updatedb`` always, and optionally fetch event
 details and/or waveform data depending on the configuration.
 
+.. note::
+
+   The ``daemon`` command is available only on macOS and Linux.
+   On Windows, daemon mode is not supported and the ``daemon`` command does
+   not appear in the CLI.
+
 seiscat daemon run
 ^^^^^^^^^^^^^^^^^^
 

docs/getting_started.rst

@@ -129,6 +129,12 @@ system's native scheduler: **launchd** on macOS and **systemd** on Linux.
 Each scheduled invocation runs exactly one cycle (``updatedb``, plus
 optional fetch stages) and then exits.
 
+.. note::
+
+   Daemon mode is currently supported only on macOS and Linux.
+   On Windows, the ``daemon`` command is not available and will not appear
+   in ``seiscat --help``.
+
 1. **Enable daemon mode** in your ``seiscat.conf``:
 
 .. code-block::
@@ -193,9 +199,8 @@ presence, and the OS service status.
 
 **Windows**
 
-Native Windows service support (Task Scheduler) is not yet implemented.
-On Windows, you can run ``seiscat daemon run`` manually or via a scheduled
-task configured through the Task Scheduler GUI.
+Windows daemon integration is not currently implemented.
+The ``seiscat daemon`` command tree is hidden on Windows.
 
 
 Next

seiscat/config/parse_arguments.py

@@ -13,6 +13,7 @@
 import sys
 import textwrap
 import argparse
+import platform
 import argcomplete
 from rich_argparse import RichHelpFormatter
 from rich.console import Console
@@ -806,7 +807,7 @@ def _add_daemon_parser(subparser, parents):
         'daemon',
         parents=[parents['configfile_parser']],
         formatter_class=RichHelpFormatter,
-        help='manage the seiscat scheduled daemon (launchd/systemd)'
+        help='manage the seiscat scheduled daemon'
     )
     daemon_subparser = daemon_parser.add_subparsers(
         dest='daemon_action',
@@ -990,7 +991,8 @@ def parse_arguments():
     _add_set_parser(subparser, parents)
     _add_fetchdata_parser(subparser, parents)
     _add_run_parser(subparser, parents)
-    _add_daemon_parser(subparser, parents)
+    if platform.system().lower() != 'windows':
+        _add_daemon_parser(subparser, parents)
     _add_sampleconfig_parser(subparser)
     _add_samplescript_parser(subparser)
     _add_self_parser(subparser)

tests/test_daemon_parse.py

@@ -72,6 +72,25 @@ def test_daemon_without_subcommand_shows_help(self):
             parse_arguments()
         self.assertEqual(cm.exception.code, 0)
 
+    @patch('seiscat.config.parse_arguments.platform.system',
+           return_value='Windows')
+    @patch('sys.argv', ['seiscat', '--help'])
+    def test_daemon_not_shown_in_help_on_windows(self, _mock_platform):
+        with patch('sys.stdout') as mock_stdout:
+            with self.assertRaises(SystemExit):
+                parse_arguments()
+        printed = ''.join(
+            call.args[0] for call in mock_stdout.write.call_args_list)
+        self.assertNotIn('daemon', printed)
+
+    @patch('seiscat.config.parse_arguments.platform.system',
+           return_value='Windows')
+    @patch('sys.argv', ['seiscat', 'daemon', 'status'])
+    def test_daemon_command_unavailable_on_windows(self, _mock_platform):
+        with self.assertRaises(SystemExit) as cm:
+            parse_arguments()
+        self.assertEqual(cm.exception.code, 2)
+
 
 if __name__ == '__main__':
     unittest.main()