keepassxc-cli 1.0.0__tar.gz → 1.2.0__tar.gz

{keepassxc_cli-1.0.0/keepassxc_cli.egg-info → keepassxc_cli-1.2.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: keepassxc-cli
-Version: 1.0.0
+Version: 1.2.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.1.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,11 @@ 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.
+
 ## Configuration
 
 ### CLI config (`~/.keepassxc/cli.json`)

{keepassxc_cli-1.0.0 → keepassxc_cli-1.2.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,11 @@ 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.
+
 ## Configuration
 
 ### CLI config (`~/.keepassxc/cli.json`)

{keepassxc_cli-1.0.0 → keepassxc_cli-1.2.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.0.0 → keepassxc_cli-1.2.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.0.0 → keepassxc_cli-1.2.0}/keepassxc_cli/commands/show.py

@@ -15,6 +15,7 @@ def add_parser(subparsers: argparse._SubParsersAction, fmt_parent: argparse.Argu
     p = subparsers.add_parser("show", parents=parents, help="Show entries matching a URL")
     p.add_argument("url", help="URL or search string")
     p.add_argument("-p", "--show-password", action="store_true", help="Reveal password and TOTP")
+    p.add_argument("--show-kph-prefix", action="store_true", help="Keep 'KPH: ' prefix on custom string field names")
     p.set_defaults(func=run)
 
 
@@ -32,7 +33,7 @@ def run(
         print(f"No entries found for: {args.url}", file=sys.stderr)
         return 1
     for entry in entries:
-        print_entry_detail(entry, fmt, show_password=args.show_password)
+        print_entry_detail(entry, fmt, show_password=args.show_password, show_kph_prefix=getattr(args, "show_kph_prefix", False))
         if fmt == "table" and len(entries) > 1:
             print()
     return 0

{keepassxc_cli-1.0.0 → keepassxc_cli-1.2.0}/keepassxc_cli/output.py

@@ -4,9 +4,26 @@ import json
 
 from keepassxc_browser_api import Entry
 
+_KPH_PREFIX = "KPH: "
 
-def print_entry_detail(entry: Entry, fmt: str = "table", show_password: bool = False) -> None:
+
+def _strip_kph(key: str) -> str:
+    return key[len(_KPH_PREFIX):] if key.startswith(_KPH_PREFIX) else key
+
+
+def print_entry_detail(
+    entry: Entry,
+    fmt: str = "table",
+    show_password: bool = False,
+    show_kph_prefix: bool = False,
+) -> None:
     totp = entry.totp if show_password else None
+
+    def _fields() -> list[dict[str, str]]:
+        if show_kph_prefix:
+            return entry.string_fields
+        return [{_strip_kph(k): v for k, v in sf.items()} for sf in entry.string_fields]
+
     if fmt == "json":
         data = {
             "uuid": entry.uuid,
@@ -14,7 +31,7 @@ def print_entry_detail(entry: Entry, fmt: str = "table", show_password: bool = F
             "login": entry.login,
             "group": entry.group,
             "group_uuid": entry.group_uuid,
-            "string_fields": entry.string_fields,
+            "string_fields": _fields(),
         }
         if show_password:
             data["password"] = entry.password
@@ -35,7 +52,7 @@ def print_entry_detail(entry: Entry, fmt: str = "table", show_password: bool = F
     if entry.group_uuid:
         print(f"Group UUID: {entry.group_uuid}")
     if entry.string_fields:
-        for sf in entry.string_fields:
+        for sf in _fields():
             for k, v in sf.items():
                 print(f"{k}: {v}")
 

{keepassxc_cli-1.0.0 → keepassxc_cli-1.2.0/keepassxc_cli.egg-info}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: keepassxc-cli
-Version: 1.0.0
+Version: 1.2.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.1.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,11 @@ 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.
+
 ## Configuration
 
 ### CLI config (`~/.keepassxc/cli.json`)

{keepassxc_cli-1.0.0 → keepassxc_cli-1.2.0}/keepassxc_cli.egg-info/requires.txt

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

{keepassxc_cli-1.0.0 → keepassxc_cli-1.2.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.1.0",
     "pyperclip==1.8.0",
 ]
 

{keepassxc_cli-1.0.0 → keepassxc_cli-1.2.0}/tests/test_commands.py

@@ -32,16 +32,15 @@ def browser_config_path(tmp_path):
 def make_args(**kwargs) -> argparse.Namespace:
     defaults = {
         "show_password": False,
+        "show_kph_prefix": False,
         "yes": False,
         "field": "password",
         "url": "https://example.com",
         "username": "user",
         "password": "pass",
-        "title": "Example",
         "group_uuid": "",
         "uuid": "abcdef12-0000-0000-0000-000000000000",
         "name": "NewGroup",
-        "parent_uuid": "",
     }
     defaults.update(kwargs)
     return argparse.Namespace(**defaults)
@@ -99,7 +98,7 @@ class TestStatusCommand:
 
 class TestShowCommand:
     def test_found_entries(self, mock_client, cli_config, browser_config, browser_config_path, capsys, mock_entry):
-        entry = mock_entry()
+        entry = mock_entry(string_fields=[{"KPH: url": "https://github.com"}])
         mock_client.get_logins.return_value = [entry]
         args = make_args(url="https://example.com", show_password=False)
         rc = show.run(mock_client, args, cli_config, browser_config, browser_config_path)
@@ -107,6 +106,8 @@ class TestShowCommand:
         out = capsys.readouterr().out
         assert "Test Entry" in out
         assert "Password" not in out
+        assert "KPH: " not in out
+        assert "url: https://github.com" in out
 
     def test_found_entries_show_password(self, mock_client, cli_config, browser_config, browser_config_path, capsys, mock_entry):
         entry = mock_entry()
@@ -118,6 +119,14 @@ class TestShowCommand:
         assert "Test Entry" in out
         assert "Password:" in out
 
+    def test_found_entries_show_kph_prefix(self, mock_client, cli_config, browser_config, browser_config_path, capsys, mock_entry):
+        entry = mock_entry(string_fields=[{"KPH: url": "https://github.com"}])
+        mock_client.get_logins.return_value = [entry]
+        args = make_args(url="https://example.com", show_password=False, show_kph_prefix=True)
+        rc = show.run(mock_client, args, cli_config, browser_config, browser_config_path)
+        assert rc == 0
+        assert "KPH: url: https://github.com" in capsys.readouterr().out
+
     def test_no_entries(self, mock_client, cli_config, browser_config, browser_config_path, capsys):
         mock_client.get_logins.return_value = []
         args = make_args(url="https://notfound.com")
@@ -131,7 +140,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()
@@ -139,7 +148,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
 
@@ -259,14 +268,22 @@ 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

{keepassxc_cli-1.0.0 → keepassxc_cli-1.2.0}/tests/test_output.py

@@ -34,12 +34,20 @@ class TestPrintEntryDetail:
         assert "user@example.com" in out
         assert "Password" not in out
         assert "s3cr3t" not in out
+        assert "KPH: " not in out
+        assert "url: https://github.com" in out
 
     def test_table_format_show_password(self, capsys, sample_entry):
         print_entry_detail(sample_entry, fmt="table", show_password=True)
         out = capsys.readouterr().out
         assert "s3cr3t" in out
         assert "Password:" in out
+        assert "KPH: " not in out
+
+    def test_table_format_show_kph_prefix(self, capsys, sample_entry):
+        print_entry_detail(sample_entry, fmt="table", show_password=False, show_kph_prefix=True)
+        out = capsys.readouterr().out
+        assert "KPH: url: https://github.com" in out
 
     def test_json_format_hidden(self, capsys, sample_entry):
         print_entry_detail(sample_entry, fmt="json", show_password=False)
@@ -47,6 +55,7 @@ class TestPrintEntryDetail:
         data = json.loads(out)
         assert data["name"] == "GitHub"
         assert "password" not in data
+        assert data["string_fields"] == [{"url": "https://github.com"}]
 
     def test_json_format_show_password(self, capsys, sample_entry):
         print_entry_detail(sample_entry, fmt="json", show_password=True)
@@ -54,6 +63,12 @@ class TestPrintEntryDetail:
         data = json.loads(out)
         assert data["name"] == "GitHub"
         assert data["password"] == "s3cr3t"
+        assert data["string_fields"] == [{"url": "https://github.com"}]
+
+    def test_json_format_show_kph_prefix(self, capsys, sample_entry):
+        print_entry_detail(sample_entry, fmt="json", show_password=False, show_kph_prefix=True)
+        data = json.loads(capsys.readouterr().out)
+        assert data["string_fields"] == [{"KPH: url": "https://github.com"}]
 
 
 class TestPrintTotp: