homesec 1.1.0__tar.gz → 1.1.1__tar.gz

{homesec-1.1.0 → homesec-1.1.1}/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 <!-- version list -->
 
+## v1.1.1 (2026-01-16)
+
+### Bug Fixes
+
+- Improve CLI help output to show available commands ([#8](https://github.com/lan17/homesec/pull/8),
+  [`4c8342f`](https://github.com/lan17/homesec/commit/4c8342f71274f2110231f112b77d68c8bb119c17))
+
+### Chores
+
+- Sync uv.lock version ([#8](https://github.com/lan17/homesec/pull/8),
+  [`4c8342f`](https://github.com/lan17/homesec/commit/4c8342f71274f2110231f112b77d68c8bb119c17))
+
+### Refactoring
+
+- Use Fire's native help output for CLI commands ([#8](https://github.com/lan17/homesec/pull/8),
+  [`4c8342f`](https://github.com/lan17/homesec/commit/4c8342f71274f2110231f112b77d68c8bb119c17))
+
+
 ## v1.1.0 (2026-01-12)
 
 ### Bug Fixes

{homesec-1.1.0 → homesec-1.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: homesec
-Version: 1.1.0
+Version: 1.1.1
 Summary: Pluggable async home security camera pipeline with detection, VLM analysis, and alerts.
 Project-URL: Homepage, https://github.com/lan17/homesec
 Project-URL: Source, https://github.com/lan17/homesec

{homesec-1.1.0 → homesec-1.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "homesec"
-version = "1.1.0"
+version = "1.1.1"
 description = "Pluggable async home security camera pipeline with detection, VLM analysis, and alerts."
 readme = "README.md"
 authors = [

{homesec-1.1.0 → homesec-1.1.1}/src/homesec/cli.py

@@ -155,6 +155,9 @@ class HomeSec:
 
 def main() -> None:
     """Main CLI entrypoint."""
+    # Strip --help/-h when it's the only arg so Fire shows its commands list
+    if len(sys.argv) == 2 and sys.argv[1] in ("--help", "-h"):
+        sys.argv.pop()
     fire.Fire(HomeSec)
 
 

{homesec-1.1.0 → homesec-1.1.1}/tests/homesec/test_cli.py

@@ -8,7 +8,7 @@ from unittest.mock import AsyncMock, MagicMock, patch
 import pytest
 import yaml
 
-from homesec.cli import HomeSec, setup_logging
+from homesec.cli import HomeSec, main, setup_logging
 from homesec.config import ConfigError
 
 
@@ -334,15 +334,73 @@ class TestHomeSecCleanup:
 class TestMain:
     """Tests for main entrypoint."""
 
-    def test_main_calls_fire(self) -> None:
-        """Main entrypoint calls fire.Fire with HomeSec."""
-        # Given: Mocked fire module
+    def test_main_calls_fire_with_command(self) -> None:
+        """Main entrypoint calls fire.Fire when command is provided."""
+        # Given: Mocked fire module and sys.argv with a command
+        with (
+            patch("homesec.cli.fire.Fire") as mock_fire,
+            patch("homesec.cli.sys.argv", ["homesec", "validate", "--config", "x.yaml"]),
+        ):
+            # When: Calling main
+            main()
 
-        # When: Calling main
-        with patch("homesec.cli.fire.Fire") as mock_fire:
-            from homesec.cli import main
+        # Then: fire.Fire called with HomeSec
+        mock_fire.assert_called_once_with(HomeSec)
 
+    def test_main_calls_fire_with_no_args(self) -> None:
+        """Main calls fire.Fire when called with no arguments (Fire shows commands)."""
+        # Given: sys.argv with only the program name
+        with (
+            patch("homesec.cli.fire.Fire") as mock_fire,
+            patch("homesec.cli.sys.argv", ["homesec"]),
+        ):
+            # When: Calling main
             main()
 
-        # Then: fire.Fire called with HomeSec
+        # Then: fire.Fire is called (Fire will show commands list)
+        mock_fire.assert_called_once_with(HomeSec)
+
+    def test_main_strips_help_flag_before_fire(self) -> None:
+        """Main strips --help flag so Fire shows commands list."""
+        # Given: sys.argv with --help
+        argv = ["homesec", "--help"]
+        with (
+            patch("homesec.cli.fire.Fire") as mock_fire,
+            patch("homesec.cli.sys.argv", argv),
+        ):
+            # When: Calling main
+            main()
+
+        # Then: fire.Fire is called and --help was stripped from argv
+        mock_fire.assert_called_once_with(HomeSec)
+        assert argv == ["homesec"]
+
+    def test_main_strips_h_flag_before_fire(self) -> None:
+        """Main strips -h flag so Fire shows commands list."""
+        # Given: sys.argv with -h
+        argv = ["homesec", "-h"]
+        with (
+            patch("homesec.cli.fire.Fire") as mock_fire,
+            patch("homesec.cli.sys.argv", argv),
+        ):
+            # When: Calling main
+            main()
+
+        # Then: fire.Fire is called and -h was stripped from argv
+        mock_fire.assert_called_once_with(HomeSec)
+        assert argv == ["homesec"]
+
+    def test_main_preserves_command_help_flag(self) -> None:
+        """Main preserves --help when used with a command."""
+        # Given: sys.argv with command and --help
+        argv = ["homesec", "run", "--help"]
+        with (
+            patch("homesec.cli.fire.Fire") as mock_fire,
+            patch("homesec.cli.sys.argv", argv),
+        ):
+            # When: Calling main
+            main()
+
+        # Then: fire.Fire is called and argv is unchanged
         mock_fire.assert_called_once_with(HomeSec)
+        assert argv == ["homesec", "run", "--help"]

{homesec-1.1.0 → homesec-1.1.1}/uv.lock

@@ -1125,7 +1125,7 @@ wheels = [
 
 [[package]]
 name = "homesec"
-version = "1.0.2"
+version = "1.1.0"
 source = { editable = "." }
 dependencies = [
     { name = "aiohttp" },