keepassxc-cli 1.1.0__tar.gz → 1.3.0__tar.gz

{keepassxc_cli-1.1.0/keepassxc_cli.egg-info → keepassxc_cli-1.3.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: keepassxc-cli
-Version: 1.1.0
+Version: 1.3.0
 Summary: CLI for KeePassXC using the browser extension protocol with biometric unlock
 License-Expression: MIT
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: keepassxc-browser-api==1.0.0
+Requires-Dist: keepassxc-browser-api==1.2.0
 Requires-Dist: pyperclip==1.8.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
@@ -121,11 +121,15 @@ keepassxc-cli clip totp     https://github.com
 #### `add` — Add a new entry
 
 ```bash
-keepassxc-cli add --url https://example.com --username user@example.com --title "Example"
 # Password is prompted securely if --password is not given
+keepassxc-cli add --url https://example.com --username user@example.com
 keepassxc-cli add --url https://example.com --username user --password mypass
+# Place the entry in a specific group by UUID
+keepassxc-cli add --url https://example.com --username user --group-uuid <group-uuid>
 ```
 
+> **Note**: The entry title is always derived from the URL hostname by KeePassXC. The protocol has no field to set a custom title.
+
 #### `edit` — Edit an entry
 
 ```bash
@@ -154,9 +158,38 @@ keepassxc-cli lock
 
 ```bash
 keepassxc-cli mkdir "Work"
-keepassxc-cli mkdir "Projects" --parent-uuid <parent-group-uuid>
+keepassxc-cli mkdir "Work/Projects"   # create Projects inside Work
 ```
 
+Use `/`-separated paths to create nested groups. KeePassXC creates any missing path segments automatically.
+
+#### `group-uuid` — Look up a group's UUID by path
+
+```bash
+keepassxc-cli group-uuid "Work"
+keepassxc-cli group-uuid "Work/Projects"
+keepassxc-cli group-uuid "Work/Projects" -j
+```
+
+Returns the UUID for the group at the given path (relative to the database root). Useful for scripting — pipe the UUID into `add --group-uuid`.
+
+JSON output (`-j`):
+```json
+{
+  "path": "Work/Projects",
+  "name": "Projects",
+  "uuid": "<uuid>"
+}
+```
+
+#### `version` — Show the CLI version
+
+```bash
+keepassxc-cli version
+```
+
+Does not require a running KeePassXC instance.
+
 ## Configuration
 
 ### CLI config (`~/.keepassxc/cli.json`)

{keepassxc_cli-1.1.0 → keepassxc_cli-1.3.0}/README.md

@@ -106,11 +106,15 @@ keepassxc-cli clip totp     https://github.com
 #### `add` — Add a new entry
 
 ```bash
-keepassxc-cli add --url https://example.com --username user@example.com --title "Example"
 # Password is prompted securely if --password is not given
+keepassxc-cli add --url https://example.com --username user@example.com
 keepassxc-cli add --url https://example.com --username user --password mypass
+# Place the entry in a specific group by UUID
+keepassxc-cli add --url https://example.com --username user --group-uuid <group-uuid>
 ```
 
+> **Note**: The entry title is always derived from the URL hostname by KeePassXC. The protocol has no field to set a custom title.
+
 #### `edit` — Edit an entry
 
 ```bash
@@ -139,9 +143,38 @@ keepassxc-cli lock
 
 ```bash
 keepassxc-cli mkdir "Work"
-keepassxc-cli mkdir "Projects" --parent-uuid <parent-group-uuid>
+keepassxc-cli mkdir "Work/Projects"   # create Projects inside Work
 ```
 
+Use `/`-separated paths to create nested groups. KeePassXC creates any missing path segments automatically.
+
+#### `group-uuid` — Look up a group's UUID by path
+
+```bash
+keepassxc-cli group-uuid "Work"
+keepassxc-cli group-uuid "Work/Projects"
+keepassxc-cli group-uuid "Work/Projects" -j
+```
+
+Returns the UUID for the group at the given path (relative to the database root). Useful for scripting — pipe the UUID into `add --group-uuid`.
+
+JSON output (`-j`):
+```json
+{
+  "path": "Work/Projects",
+  "name": "Projects",
+  "uuid": "<uuid>"
+}
+```
+
+#### `version` — Show the CLI version
+
+```bash
+keepassxc-cli version
+```
+
+Does not require a running KeePassXC instance.
+
 ## Configuration
 
 ### CLI config (`~/.keepassxc/cli.json`)

{keepassxc_cli-1.1.0 → keepassxc_cli-1.3.0}/keepassxc_cli/__main__.py

@@ -11,7 +11,7 @@ from keepassxc_browser_api import BrowserClient, BrowserConfig
 from keepassxc_browser_api.exceptions import KeePassXCError, ConnectionError
 
 from .config import CliConfig, DEFAULT_CLI_CONFIG_PATH
-from .commands import setup, status, show, add, edit, rm, totp, clip, lock, mkdir
+from .commands import setup, status, show, add, edit, rm, totp, clip, lock, mkdir, group_uuid, version
 
 # Shared parent parser that injects -j/--json into each subparser that supports it.
 # Defined at module level so command modules can import it if needed.
@@ -55,6 +55,8 @@ def main() -> None:
     clip.add_parser(subparsers)
     lock.add_parser(subparsers)
     mkdir.add_parser(subparsers)
+    group_uuid.add_parser(subparsers, fmt_parent)
+    version.add_parser(subparsers)
 
     args = parser.parse_args()
 

{keepassxc_cli-1.1.0 → keepassxc_cli-1.3.0}/keepassxc_cli/commands/add.py

@@ -15,7 +15,6 @@ def add_parser(subparsers: argparse._SubParsersAction) -> None:
     p.add_argument("--url", required=True, help="Entry URL")
     p.add_argument("--username", required=True, help="Username")
     p.add_argument("--password", default=None, help="Password (prompted if omitted)")
-    p.add_argument("--title", default="", help="Entry title")
     p.add_argument("--group-uuid", default="", help="Target group UUID")
     p.set_defaults(func=run)
 
@@ -37,7 +36,6 @@ def run(
         url=args.url,
         username=args.username,
         password=password,
-        title=args.title,
         group_uuid=args.group_uuid,
     )
     if success:

keepassxc_cli-1.3.0/keepassxc_cli/commands/group_uuid.py

@@ -0,0 +1,58 @@
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+from keepassxc_browser_api import BrowserClient, BrowserConfig
+
+from keepassxc_cli.config import CliConfig
+
+
+def add_parser(subparsers: argparse._SubParsersAction, fmt_parent: argparse.ArgumentParser | None = None) -> None:
+    parents = [fmt_parent] if fmt_parent else []
+    p = subparsers.add_parser(
+        "group-uuid",
+        parents=parents,
+        help="Look up the UUID of a group by its path",
+    )
+    p.add_argument(
+        "path",
+        help="Group path relative to the database root (e.g. 'Work/Projects')",
+    )
+    p.set_defaults(func=run)
+
+
+def run(
+    client: BrowserClient,
+    args: argparse.Namespace,
+    cli_config: CliConfig,
+    browser_config: BrowserConfig,
+    browser_config_path: Path,
+    *,
+    fmt: str = "table",
+) -> int:
+    groups = client.get_database_groups()
+    if not groups:
+        print("Failed to retrieve group tree.", file=sys.stderr)
+        return 1
+
+    root = groups[0]
+    parts = args.path.split("/")
+
+    # Paths are root-relative: traverse root.children, not the root itself.
+    current = root.children
+    matched = None
+    for part in parts:
+        matched = next((g for g in current if g.name == part), None)
+        if matched is None:
+            print(f"Group not found: {args.path!r}", file=sys.stderr)
+            return 1
+        current = matched.children
+
+    if fmt == "json":
+        print(json.dumps({"path": args.path, "name": matched.name, "uuid": matched.uuid}, indent=2))
+    else:
+        print(f"{args.path} [{matched.uuid}]")
+    return 0

{keepassxc_cli-1.1.0 → keepassxc_cli-1.3.0}/keepassxc_cli/commands/mkdir.py

@@ -11,8 +11,10 @@ from keepassxc_cli.config import CliConfig
 
 def add_parser(subparsers: argparse._SubParsersAction) -> None:
     p = subparsers.add_parser("mkdir", help="Create a new group")
-    p.add_argument("name", help="Group name")
-    p.add_argument("--parent-uuid", default="", help="Parent group UUID")
+    p.add_argument(
+        "name",
+        help="Group name or path. Use '/' to create nested groups (e.g. 'Work/Projects').",
+    )
     p.set_defaults(func=run)
 
 
@@ -25,7 +27,7 @@ def run(
     *,
     fmt: str = "table",
 ) -> int:
-    group = client.create_group(args.name, parent_group_uuid=args.parent_uuid)
+    group = client.create_group(args.name)
     if group is None:
         print("Failed to create group.", file=sys.stderr)
         return 1

keepassxc_cli-1.3.0/keepassxc_cli/commands/version.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+import argparse
+from importlib.metadata import PackageNotFoundError, version
+from pathlib import Path
+
+from keepassxc_browser_api import BrowserClient, BrowserConfig
+
+from keepassxc_cli.config import CliConfig
+
+
+def add_parser(subparsers: argparse._SubParsersAction) -> None:
+    p = subparsers.add_parser("version", help="Show the keepassxc-cli version")
+    p.set_defaults(func=run)
+
+
+def run(
+    client: BrowserClient,
+    args: argparse.Namespace,
+    cli_config: CliConfig,
+    browser_config: BrowserConfig,
+    browser_config_path: Path,
+    *,
+    fmt: str = "table",
+) -> int:
+    try:
+        ver = version("keepassxc-cli")
+    except PackageNotFoundError:
+        ver = "unknown"
+    print(f"keepassxc-cli {ver}")
+    return 0

{keepassxc_cli-1.1.0 → keepassxc_cli-1.3.0/keepassxc_cli.egg-info}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: keepassxc-cli
-Version: 1.1.0
+Version: 1.3.0
 Summary: CLI for KeePassXC using the browser extension protocol with biometric unlock
 License-Expression: MIT
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: keepassxc-browser-api==1.0.0
+Requires-Dist: keepassxc-browser-api==1.2.0
 Requires-Dist: pyperclip==1.8.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
@@ -121,11 +121,15 @@ keepassxc-cli clip totp     https://github.com
 #### `add` — Add a new entry
 
 ```bash
-keepassxc-cli add --url https://example.com --username user@example.com --title "Example"
 # Password is prompted securely if --password is not given
+keepassxc-cli add --url https://example.com --username user@example.com
 keepassxc-cli add --url https://example.com --username user --password mypass
+# Place the entry in a specific group by UUID
+keepassxc-cli add --url https://example.com --username user --group-uuid <group-uuid>
 ```
 
+> **Note**: The entry title is always derived from the URL hostname by KeePassXC. The protocol has no field to set a custom title.
+
 #### `edit` — Edit an entry
 
 ```bash
@@ -154,9 +158,38 @@ keepassxc-cli lock
 
 ```bash
 keepassxc-cli mkdir "Work"
-keepassxc-cli mkdir "Projects" --parent-uuid <parent-group-uuid>
+keepassxc-cli mkdir "Work/Projects"   # create Projects inside Work
 ```
 
+Use `/`-separated paths to create nested groups. KeePassXC creates any missing path segments automatically.
+
+#### `group-uuid` — Look up a group's UUID by path
+
+```bash
+keepassxc-cli group-uuid "Work"
+keepassxc-cli group-uuid "Work/Projects"
+keepassxc-cli group-uuid "Work/Projects" -j
+```
+
+Returns the UUID for the group at the given path (relative to the database root). Useful for scripting — pipe the UUID into `add --group-uuid`.
+
+JSON output (`-j`):
+```json
+{
+  "path": "Work/Projects",
+  "name": "Projects",
+  "uuid": "<uuid>"
+}
+```
+
+#### `version` — Show the CLI version
+
+```bash
+keepassxc-cli version
+```
+
+Does not require a running KeePassXC instance.
+
 ## Configuration
 
 ### CLI config (`~/.keepassxc/cli.json`)

{keepassxc_cli-1.1.0 → keepassxc_cli-1.3.0}/keepassxc_cli.egg-info/SOURCES.txt

@@ -21,6 +21,7 @@ keepassxc_cli/commands/__init__.py
 keepassxc_cli/commands/add.py
 keepassxc_cli/commands/clip.py
 keepassxc_cli/commands/edit.py
+keepassxc_cli/commands/group_uuid.py
 keepassxc_cli/commands/lock.py
 keepassxc_cli/commands/mkdir.py
 keepassxc_cli/commands/rm.py
@@ -28,6 +29,7 @@ keepassxc_cli/commands/setup.py
 keepassxc_cli/commands/show.py
 keepassxc_cli/commands/status.py
 keepassxc_cli/commands/totp.py
+keepassxc_cli/commands/version.py
 tests/conftest.py
 tests/test_commands.py
 tests/test_config.py

{keepassxc_cli-1.1.0 → keepassxc_cli-1.3.0}/keepassxc_cli.egg-info/requires.txt

@@ -1,4 +1,4 @@
-keepassxc-browser-api==1.0.0
+keepassxc-browser-api==1.2.0
 pyperclip==1.8.0
 
 [dev]

{keepassxc_cli-1.1.0 → keepassxc_cli-1.3.0}/pyproject.toml

@@ -10,7 +10,7 @@ readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"
 dependencies = [
-    "keepassxc-browser-api==1.0.0",
+    "keepassxc-browser-api==1.2.0",
     "pyperclip==1.8.0",
 ]
 

{keepassxc_cli-1.1.0 → keepassxc_cli-1.3.0}/tests/conftest.py

@@ -71,6 +71,7 @@ def mock_client():
     client.get_logins.return_value = [make_entry()]
     client.set_login.return_value = True
     client.create_group.return_value = make_group(uuid="new-uuid", name="NewGroup")
+    client.get_database_groups.return_value = [make_group()]
     client.get_totp.return_value = "123456"
     client.delete_entry.return_value = True
     client.lock_database.return_value = True

{keepassxc_cli-1.1.0 → keepassxc_cli-1.3.0}/tests/test_commands.py

@@ -10,7 +10,7 @@ import pytest
 from keepassxc_browser_api import Entry, BrowserConfig, Association
 from keepassxc_cli.config import CliConfig
 from keepassxc_cli.commands import (
-    setup, status, show, add, edit, rm, totp, clip, lock, mkdir,
+    setup, status, show, add, edit, rm, totp, clip, lock, mkdir, group_uuid, version,
 )
 
 
@@ -38,11 +38,10 @@ def make_args(**kwargs) -> argparse.Namespace:
         "url": "https://example.com",
         "username": "user",
         "password": "pass",
-        "title": "Example",
         "group_uuid": "",
         "uuid": "abcdef12-0000-0000-0000-000000000000",
         "name": "NewGroup",
-        "parent_uuid": "",
+        "path": "Work",
     }
     defaults.update(kwargs)
     return argparse.Namespace(**defaults)
@@ -142,7 +141,7 @@ class TestShowCommand:
 class TestAddCommand:
     def test_success(self, mock_client, cli_config, browser_config, browser_config_path, capsys):
         mock_client.set_login.return_value = True
-        args = make_args(url="https://example.com", username="u", password="p", title="T", group_uuid="")
+        args = make_args(url="https://example.com", username="u", password="p", group_uuid="")
         rc = add.run(mock_client, args, cli_config, browser_config, browser_config_path)
         assert rc == 0
         mock_client.set_login.assert_called_once()
@@ -150,7 +149,7 @@ class TestAddCommand:
 
     def test_failure(self, mock_client, cli_config, browser_config, browser_config_path, capsys):
         mock_client.set_login.return_value = False
-        args = make_args(url="https://example.com", username="u", password="p", title="T", group_uuid="")
+        args = make_args(url="https://example.com", username="u", password="p", group_uuid="")
         rc = add.run(mock_client, args, cli_config, browser_config, browser_config_path)
         assert rc == 1
 
@@ -270,14 +269,105 @@ class TestMkdirCommand:
     def test_success(self, mock_client, cli_config, browser_config, browser_config_path, capsys, mock_group):
         new_group = mock_group(uuid="new-uuid", name="MyGroup")
         mock_client.create_group.return_value = new_group
-        args = make_args(name="MyGroup", parent_uuid="")
+        args = make_args(name="MyGroup")
         rc = mkdir.run(mock_client, args, cli_config, browser_config, browser_config_path)
         assert rc == 0
         out = capsys.readouterr().out
         assert "MyGroup" in out
 
+    def test_path_syntax(self, mock_client, cli_config, browser_config, browser_config_path, capsys, mock_group):
+        new_group = mock_group(uuid="new-uuid", name="Projects")
+        mock_client.create_group.return_value = new_group
+        args = make_args(name="Work/Projects")
+        rc = mkdir.run(mock_client, args, cli_config, browser_config, browser_config_path)
+        assert rc == 0
+        mock_client.create_group.assert_called_once_with("Work/Projects")
+
     def test_failure(self, mock_client, cli_config, browser_config, browser_config_path, capsys):
         mock_client.create_group.return_value = None
-        args = make_args(name="MyGroup", parent_uuid="")
+        args = make_args(name="MyGroup")
         rc = mkdir.run(mock_client, args, cli_config, browser_config, browser_config_path)
         assert rc == 1
+
+
+# --- group-uuid ---
+
+
+class TestGroupUuidCommand:
+    def _make_tree(self, mock_group):
+        from keepassxc_browser_api import Group
+        projects = mock_group(uuid="projects-uuid", name="Projects")
+        work = mock_group(uuid="work-uuid", name="Work", children=[projects])
+        root = mock_group(uuid="root-uuid", name="Root", children=[work])
+        return [root]
+
+    def test_found_top_level(self, mock_client, cli_config, browser_config, browser_config_path, capsys, mock_group):
+        mock_client.get_database_groups.return_value = self._make_tree(mock_group)
+        args = make_args(path="Work")
+        rc = group_uuid.run(mock_client, args, cli_config, browser_config, browser_config_path)
+        assert rc == 0
+        out = capsys.readouterr().out
+        assert "work-uuid" in out
+        assert "Work" in out
+
+    def test_found_nested_path(self, mock_client, cli_config, browser_config, browser_config_path, capsys, mock_group):
+        mock_client.get_database_groups.return_value = self._make_tree(mock_group)
+        args = make_args(path="Work/Projects")
+        rc = group_uuid.run(mock_client, args, cli_config, browser_config, browser_config_path)
+        assert rc == 0
+        out = capsys.readouterr().out
+        assert "projects-uuid" in out
+
+    def test_not_found(self, mock_client, cli_config, browser_config, browser_config_path, capsys, mock_group):
+        mock_client.get_database_groups.return_value = self._make_tree(mock_group)
+        args = make_args(path="Nonexistent")
+        rc = group_uuid.run(mock_client, args, cli_config, browser_config, browser_config_path)
+        assert rc == 1
+        err = capsys.readouterr().err
+        assert "not found" in err.lower()
+
+    def test_not_found_mid_path(self, mock_client, cli_config, browser_config, browser_config_path, capsys, mock_group):
+        mock_client.get_database_groups.return_value = self._make_tree(mock_group)
+        args = make_args(path="Work/Nope/Projects")
+        rc = group_uuid.run(mock_client, args, cli_config, browser_config, browser_config_path)
+        assert rc == 1
+
+    def test_json_output(self, mock_client, cli_config, browser_config, browser_config_path, capsys, mock_group):
+        import json
+        mock_client.get_database_groups.return_value = self._make_tree(mock_group)
+        args = make_args(path="Work/Projects")
+        rc = group_uuid.run(mock_client, args, cli_config, browser_config, browser_config_path, fmt="json")
+        assert rc == 0
+        data = json.loads(capsys.readouterr().out)
+        assert data["path"] == "Work/Projects"
+        assert data["name"] == "Projects"
+        assert data["uuid"] == "projects-uuid"
+
+    def test_get_database_groups_failure(self, mock_client, cli_config, browser_config, browser_config_path, capsys):
+        mock_client.get_database_groups.return_value = []
+        args = make_args(path="Work")
+        rc = group_uuid.run(mock_client, args, cli_config, browser_config, browser_config_path)
+        assert rc == 1
+
+
+# --- version ---
+
+
+class TestVersionCommand:
+    def test_prints_version(self, mock_client, cli_config, browser_config, browser_config_path, capsys):
+        with patch("keepassxc_cli.commands.version.version", return_value="1.3.0"):
+            args = make_args()
+            rc = version.run(mock_client, args, cli_config, browser_config, browser_config_path)
+        assert rc == 0
+        out = capsys.readouterr().out
+        assert "keepassxc-cli" in out
+        assert "1.3.0" in out
+
+    def test_package_not_found(self, mock_client, cli_config, browser_config, browser_config_path, capsys):
+        from importlib.metadata import PackageNotFoundError
+        with patch("keepassxc_cli.commands.version.version", side_effect=PackageNotFoundError):
+            args = make_args()
+            rc = version.run(mock_client, args, cli_config, browser_config, browser_config_path)
+        assert rc == 0
+        out = capsys.readouterr().out
+        assert "unknown" in out