basic-password-manager 0.1.0__tar.gz → 0.2.1__tar.gz

{basic_password_manager-0.1.0 → basic_password_manager-0.2.1}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Darsh Thakur (Daisentaur)
+Copyright (c) 2026 Daisentaur
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{basic_password_manager-0.1.0 → basic_password_manager-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: basic-password-manager
-Version: 0.1.0
+Version: 0.2.1
 Summary: Local encrypted password manager that lives in your terminal
 License-Expression: MIT
 Project-URL: Repository, https://github.com/Daisentaur/password-manager
@@ -9,6 +9,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: argon2-cffi
 Requires-Dist: cryptography
+Requires-Dist: textual
 Dynamic: license-file
 
 # pw-manager
@@ -44,12 +45,25 @@ For development: `python3 -m venv venv && ./venv/bin/pip install -e .`
 
 ## Usage
 
+Run `pw` with no arguments for the interactive TUI: unlock, then `/` to
+filter, Enter to copy the selected password, `n` to add, `e` to edit,
+`d` to delete, `t` to switch themes (persisted across runs), `q` to quit.
+Rarer operations live in the command palette (`ctrl+p`), e.g. changing the
+master password.
+The bundled themes — muted-slate (default), dawn, matrix — are borrowed with
+admiration from [tuxedo](https://github.com/webstonehq/tuxedo); Textual's
+built-in themes are in the picker too.
+
+Or use the subcommands:
+
 | Command | What it does |
 |---|---|
 | `pw init` | create a new empty vault |
 | `pw add github` | store an entry (prompts for username/password/notes) |
 | `pw add github --gen` | same, but generates a strong random password |
 | `pw get github` | copy the password to the clipboard, show the username |
+| `pw edit github` | update an entry field by field (Enter keeps current) |
+| `pw passwd` | change the master password |
 | `pw ls` | list entry names |
 | `pw rm github` | delete an entry |
 | `pw find bank` | search entry names, usernames, and notes |
@@ -109,7 +123,11 @@ can't destroy the vault.
 Your master password is never stored anywhere, in any form. "Wrong password"
 is detected purely by GCM authentication failing.
 
-### 3. `cli.py` — the CLI
+### 3. `cli.py` and `tui.py` — the interfaces
+
+Both are thin skins over the same two modules — `tui.py` (built with
+[Textual](https://textual.textualize.io)) holds the decrypted entries in
+memory for the session; the CLI re-derives the key per command.
 
 argparse subcommands over the two modules above. Passwords are copied to the
 clipboard (`wl-copy`/`xclip`/`xsel`, whichever exists) rather than printed,

{basic_password_manager-0.1.0 → basic_password_manager-0.2.1}/README.md

@@ -31,12 +31,25 @@ For development: `python3 -m venv venv && ./venv/bin/pip install -e .`
 
 ## Usage
 
+Run `pw` with no arguments for the interactive TUI: unlock, then `/` to
+filter, Enter to copy the selected password, `n` to add, `e` to edit,
+`d` to delete, `t` to switch themes (persisted across runs), `q` to quit.
+Rarer operations live in the command palette (`ctrl+p`), e.g. changing the
+master password.
+The bundled themes — muted-slate (default), dawn, matrix — are borrowed with
+admiration from [tuxedo](https://github.com/webstonehq/tuxedo); Textual's
+built-in themes are in the picker too.
+
+Or use the subcommands:
+
 | Command | What it does |
 |---|---|
 | `pw init` | create a new empty vault |
 | `pw add github` | store an entry (prompts for username/password/notes) |
 | `pw add github --gen` | same, but generates a strong random password |
 | `pw get github` | copy the password to the clipboard, show the username |
+| `pw edit github` | update an entry field by field (Enter keeps current) |
+| `pw passwd` | change the master password |
 | `pw ls` | list entry names |
 | `pw rm github` | delete an entry |
 | `pw find bank` | search entry names, usernames, and notes |
@@ -96,7 +109,11 @@ can't destroy the vault.
 Your master password is never stored anywhere, in any form. "Wrong password"
 is detected purely by GCM authentication failing.
 
-### 3. `cli.py` — the CLI
+### 3. `cli.py` and `tui.py` — the interfaces
+
+Both are thin skins over the same two modules — `tui.py` (built with
+[Textual](https://textual.textualize.io)) holds the decrypted entries in
+memory for the session; the CLI re-derives the key per command.
 
 argparse subcommands over the two modules above. Passwords are copied to the
 clipboard (`wl-copy`/`xclip`/`xsel`, whichever exists) rather than printed,

{basic_password_manager-0.1.0 → basic_password_manager-0.2.1}/basic_password_manager.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: basic-password-manager
-Version: 0.1.0
+Version: 0.2.1
 Summary: Local encrypted password manager that lives in your terminal
 License-Expression: MIT
 Project-URL: Repository, https://github.com/Daisentaur/password-manager
@@ -9,6 +9,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: argon2-cffi
 Requires-Dist: cryptography
+Requires-Dist: textual
 Dynamic: license-file
 
 # pw-manager
@@ -44,12 +45,25 @@ For development: `python3 -m venv venv && ./venv/bin/pip install -e .`
 
 ## Usage
 
+Run `pw` with no arguments for the interactive TUI: unlock, then `/` to
+filter, Enter to copy the selected password, `n` to add, `e` to edit,
+`d` to delete, `t` to switch themes (persisted across runs), `q` to quit.
+Rarer operations live in the command palette (`ctrl+p`), e.g. changing the
+master password.
+The bundled themes — muted-slate (default), dawn, matrix — are borrowed with
+admiration from [tuxedo](https://github.com/webstonehq/tuxedo); Textual's
+built-in themes are in the picker too.
+
+Or use the subcommands:
+
 | Command | What it does |
 |---|---|
 | `pw init` | create a new empty vault |
 | `pw add github` | store an entry (prompts for username/password/notes) |
 | `pw add github --gen` | same, but generates a strong random password |
 | `pw get github` | copy the password to the clipboard, show the username |
+| `pw edit github` | update an entry field by field (Enter keeps current) |
+| `pw passwd` | change the master password |
 | `pw ls` | list entry names |
 | `pw rm github` | delete an entry |
 | `pw find bank` | search entry names, usernames, and notes |
@@ -109,7 +123,11 @@ can't destroy the vault.
 Your master password is never stored anywhere, in any form. "Wrong password"
 is detected purely by GCM authentication failing.
 
-### 3. `cli.py` — the CLI
+### 3. `cli.py` and `tui.py` — the interfaces
+
+Both are thin skins over the same two modules — `tui.py` (built with
+[Textual](https://textual.textualize.io)) holds the decrypted entries in
+memory for the session; the CLI re-derives the key per command.
 
 argparse subcommands over the two modules above. Passwords are copied to the
 clipboard (`wl-copy`/`xclip`/`xsel`, whichever exists) rather than printed,

{basic_password_manager-0.1.0 → basic_password_manager-0.2.1}/basic_password_manager.egg-info/SOURCES.txt

@@ -10,4 +10,5 @@ basic_password_manager.egg-info/top_level.txt
 pw_manager/__init__.py
 pw_manager/cli.py
 pw_manager/crypto.py
+pw_manager/tui.py
 pw_manager/vault.py

{basic_password_manager-0.1.0 → basic_password_manager-0.2.1}/basic_password_manager.egg-info/requires.txt

@@ -1,2 +1,3 @@
 argon2-cffi
 cryptography
+textual

{basic_password_manager-0.1.0 → basic_password_manager-0.2.1}/pw_manager/cli.py

@@ -84,6 +84,34 @@ def cmd_get(args):
         print(f"password: {e['pw']}")
 
 
+def cmd_edit(args):
+    """Per-field update; Enter keeps the shown current value."""
+    master = ask_master()
+    entries = vault.load(VAULT_PATH, master)
+    if args.name not in entries:
+        sys.exit(f"no entry '{args.name}' — try 'ls'")
+    e = entries[args.name]
+    user = input(f"username [{e['user']}]: ") or e["user"]
+    pw = getpass.getpass("password (empty = keep current): ") or e["pw"]
+    notes = input(f"notes [{e.get('notes', '')}]: ") or e.get("notes", "")
+    entries[args.name] = {"user": user, "pw": pw, "notes": notes}
+    vault.save(VAULT_PATH, master, entries)
+    print(f"updated '{args.name}'")
+
+
+def cmd_passwd(args):
+    """Change the master password: decrypt with old, re-encrypt with new."""
+    entries = vault.load(VAULT_PATH, ask_master())
+    print("choose a new master password")
+    new = getpass.getpass("new master password: ")
+    if getpass.getpass("confirm new master password: ") != new:
+        sys.exit("passwords do not match")
+    if len(new) < 8:
+        sys.exit("master password must be at least 8 characters")
+    vault.save(VAULT_PATH, new, entries)
+    print("master password changed (old one is now useless)")
+
+
 def cmd_ls(args):
     entries = vault.load(VAULT_PATH, ask_master())
     for name in sorted(entries):
@@ -142,8 +170,10 @@ def cmd_import(args):
 
 
 def main():
-    p = argparse.ArgumentParser(description="local encrypted password manager")
-    sub = p.add_subparsers(dest="command", required=True)
+    p = argparse.ArgumentParser(
+        description="local encrypted password manager (run bare for the TUI)"
+    )
+    sub = p.add_subparsers(dest="command")
 
     sub.add_parser("init", help="create a new empty vault")
     a = sub.add_parser("add", help="add or update an entry")
@@ -151,6 +181,9 @@ def main():
     a.add_argument("--gen", action="store_true", help="generate the password")
     g = sub.add_parser("get", help="copy an entry's password to clipboard")
     g.add_argument("name")
+    e = sub.add_parser("edit", help="update an entry field by field")
+    e.add_argument("name")
+    sub.add_parser("passwd", help="change the master password")
     sub.add_parser("ls", help="list entry names")
     r = sub.add_parser("rm", help="delete an entry")
     r.add_argument("name")
@@ -162,6 +195,11 @@ def main():
     i.add_argument("csv_file")
 
     args = p.parse_args()
+    if args.command is None:
+        from . import tui  # imported lazily: textual is heavy, subcommands skip it
+
+        tui.main()
+        return
     try:
         globals()[f"cmd_{args.command}"](args)
     except vault.VaultError as e:

basic_password_manager-0.2.1/pw_manager/tui.py

@@ -0,0 +1,399 @@
+"""Interactive TUI, launched by running `pw` with no arguments.
+
+Theme palettes copied from tuxedo (github.com/webstonehq/tuxedo,
+src/theme.rs); "muted-slate" is the default. `t` opens the theme picker,
+and Textual's own built-in themes are available there too.
+"""
+
+import os
+from typing import Iterable
+
+from textual.app import App, ComposeResult, SystemCommand
+from textual.binding import Binding
+from textual.containers import Vertical
+from textual.screen import ModalScreen, Screen
+from textual.theme import Theme
+from textual.widgets import DataTable, Footer, Input, Label, Static
+
+from . import vault
+from .cli import VAULT_PATH, generate, to_clipboard
+
+THEME_FILE = os.path.expanduser("~/.local/share/pw-manager/theme")
+
+TUXEDO_THEMES = [
+    Theme(
+        name="muted-slate",
+        primary="#8aa9c9",
+        secondary="#7fb3a8",
+        accent="#9a8fc4",
+        foreground="#c8ccd4",
+        background="#1a1d23",
+        surface="#1f232b",
+        panel="#252a33",
+        success="#7aa67a",
+        warning="#d4b06a",
+        error="#e07a7a",
+        dark=True,
+    ),
+    Theme(
+        name="dawn",
+        primary="#a35d3a",
+        secondary="#3a7a6a",
+        accent="#7a4a8a",
+        foreground="#3d3528",
+        background="#faf6f0",
+        surface="#f3ede2",
+        panel="#ede2cc",
+        success="#5a7a3a",
+        warning="#a3722a",
+        error="#b8483a",
+        dark=False,
+    ),
+    Theme(
+        name="matrix",
+        primary="#9fff9f",
+        secondary="#7fcc7f",
+        accent="#cf9fff",
+        foreground="#7fcc7f",
+        background="#0a120a",
+        surface="#0f1a0f",
+        panel="#101c10",
+        success="#9fff9f",
+        warning="#ffd66e",
+        error="#ff8c8c",
+        dark=True,
+    ),
+]
+
+
+class UnlockScreen(Screen):
+    """Master password prompt shown before anything else."""
+
+    def compose(self) -> ComposeResult:
+        with Vertical(id="unlock-box"):
+            yield Label("pw-manager", id="unlock-title")
+            yield Input(password=True, placeholder="master password", id="master")
+            yield Static("", id="unlock-error")
+
+    def on_input_submitted(self, event: Input.Submitted) -> None:
+        self.query_one("#unlock-error", Static).update("unlocking…")
+        try:
+            self.app.entries = vault.load(VAULT_PATH, event.value)
+        except vault.VaultError as e:
+            self.query_one("#unlock-error", Static).update(str(e))
+            self.query_one("#master", Input).clear()
+            return
+        self.app.master = event.value
+        self.app.push_screen(MainScreen())
+
+
+class EntryModal(ModalScreen):
+    """Add or edit an entry. Empty password = generate (add) / keep current (edit)."""
+
+    BINDINGS = [Binding("escape", "dismiss", "cancel")]
+
+    def __init__(self, name: str = "", entry: dict | None = None) -> None:
+        super().__init__()
+        self.initial_name = name
+        self.entry = entry or {}
+
+    def compose(self) -> ComposeResult:
+        editing = bool(self.entry)
+        with Vertical(classes="modal-box"):
+            yield Label("edit entry" if editing else "new entry", classes="modal-title")
+            yield Input(value=self.initial_name, placeholder="name (e.g. github)", id="e-name")
+            yield Input(value=self.entry.get("user", ""), placeholder="username", id="e-user")
+            yield Input(
+                password=True,
+                placeholder="password (empty = keep current)" if editing else "password (empty = generate)",
+                id="e-pw",
+            )
+            yield Input(value=self.entry.get("notes", ""), placeholder="notes (optional)", id="e-notes")
+            yield Static("enter saves · esc cancels", classes="modal-hint")
+
+    def on_input_submitted(self, event: Input.Submitted) -> None:
+        name = self.query_one("#e-name", Input).value.strip()
+        if not name:
+            self.query_one("#e-name", Input).focus()
+            return
+        self.dismiss(
+            {
+                "name": name,
+                "user": self.query_one("#e-user", Input).value,
+                "pw": self.query_one("#e-pw", Input).value or self.entry.get("pw") or generate(),
+                "notes": self.query_one("#e-notes", Input).value,
+            }
+        )
+
+
+class PasswdModal(ModalScreen):
+    """Change the master password. Asks for the current one again so a
+    walked-up-to unlocked session can't lock the real owner out."""
+
+    BINDINGS = [Binding("escape", "dismiss", "cancel")]
+
+    def compose(self) -> ComposeResult:
+        with Vertical(classes="modal-box"):
+            yield Label("change master password", classes="modal-title")
+            yield Input(password=True, placeholder="current master password", id="p-current")
+            yield Input(password=True, placeholder="new master password (8+ chars)", id="p-new")
+            yield Input(password=True, placeholder="confirm new master password", id="p-confirm")
+            yield Static("enter saves · esc cancels", classes="modal-hint")
+            yield Static("", id="p-error")
+
+    def on_input_submitted(self, event: Input.Submitted) -> None:
+        current = self.query_one("#p-current", Input).value
+        new = self.query_one("#p-new", Input).value
+        error = self.query_one("#p-error", Static)
+        if current != self.app.master:
+            error.update("current master password is wrong")
+            return
+        if len(new) < 8:
+            error.update("new master password must be at least 8 characters")
+            return
+        if new != self.query_one("#p-confirm", Input).value:
+            error.update("new passwords do not match")
+            return
+        self.dismiss(new)
+
+
+class ConfirmModal(ModalScreen):
+    """y/n confirmation."""
+
+    BINDINGS = [
+        Binding("y", "yes", "yes"),
+        Binding("n,escape", "no", "no"),
+    ]
+
+    def __init__(self, question: str) -> None:
+        super().__init__()
+        self.question = question
+
+    def compose(self) -> ComposeResult:
+        with Vertical(classes="modal-box"):
+            yield Label(self.question, classes="modal-title")
+            yield Static("y confirms · n cancels", classes="modal-hint")
+
+    def action_yes(self) -> None:
+        self.dismiss(True)
+
+    def action_no(self) -> None:
+        self.dismiss(False)
+
+
+class MainScreen(Screen):
+    BINDINGS = [
+        Binding("enter", "copy", "copy password", priority=True),
+        Binding("n", "new", "new entry"),
+        Binding("e", "edit", "edit"),
+        Binding("d", "delete", "delete"),
+        Binding("slash", "search", "search"),
+        Binding("t", "app.change_theme", "theme"),
+        Binding("escape", "clear_search", show=False),
+        Binding("q", "quit", "quit"),
+    ]
+
+    def compose(self) -> ComposeResult:
+        yield Input(placeholder="/ to search", id="search")
+        yield DataTable(id="table", cursor_type="row")
+        yield Footer()
+
+    def on_mount(self) -> None:
+        table = self.query_one(DataTable)
+        table.add_columns("name", "username", "notes")
+        self.refresh_table()
+        table.focus()
+
+    def refresh_table(self) -> None:
+        table = self.query_one(DataTable)
+        table.clear()
+        term = self.query_one("#search", Input).value.lower()
+        for name, e in sorted(self.app.entries.items()):
+            if (
+                term in name.lower()
+                or term in e["user"].lower()
+                or term in e.get("notes", "").lower()
+            ):
+                table.add_row(name, e["user"], e.get("notes", ""), key=name)
+
+    def save(self) -> None:
+        vault.save(VAULT_PATH, self.app.master, self.app.entries)
+
+    def selected_name(self) -> str | None:
+        table = self.query_one(DataTable)
+        if table.row_count == 0:
+            return None
+        return table.coordinate_to_cell_key(table.cursor_coordinate).row_key.value
+
+    def on_input_changed(self, event: Input.Changed) -> None:
+        self.refresh_table()
+
+    def on_input_submitted(self, event: Input.Submitted) -> None:
+        self.query_one(DataTable).focus()
+
+    def action_copy(self) -> None:
+        name = self.selected_name()
+        if name is None:
+            return
+        if to_clipboard(self.app.entries[name]["pw"]):
+            self.notify(f"password for '{name}' copied", severity="information")
+        else:
+            self.notify("no clipboard tool (install wl-clipboard)", severity="error")
+
+    def action_new(self) -> None:
+        def done(entry: dict | None) -> None:
+            if entry:
+                name = entry.pop("name")
+                self.app.entries[name] = entry
+                self.save()
+                self.refresh_table()
+                self.notify(f"stored '{name}'")
+
+        self.app.push_screen(EntryModal(), done)
+
+    def action_edit(self) -> None:
+        name = self.selected_name()
+        if name is None:
+            return
+
+        def done(entry: dict | None) -> None:
+            if not entry:
+                return
+            new_name = entry.pop("name")
+            if new_name != name:
+                if new_name in self.app.entries:
+                    self.notify(f"'{new_name}' already exists", severity="error")
+                    return
+                del self.app.entries[name]
+            self.app.entries[new_name] = entry
+            self.save()
+            self.refresh_table()
+            self.notify(f"updated '{new_name}'")
+
+        self.app.push_screen(EntryModal(name, dict(self.app.entries[name])), done)
+
+    def action_delete(self) -> None:
+        name = self.selected_name()
+        if name is None:
+            return
+
+        def done(confirmed: bool | None) -> None:
+            if confirmed:
+                del self.app.entries[name]
+                self.save()
+                self.refresh_table()
+                self.notify(f"removed '{name}'")
+
+        self.app.push_screen(ConfirmModal(f"delete '{name}'?"), done)
+
+    def action_search(self) -> None:
+        self.query_one("#search", Input).focus()
+
+    def action_clear_search(self) -> None:
+        search = self.query_one("#search", Input)
+        search.clear()
+        self.query_one(DataTable).focus()
+
+
+class PwApp(App):
+    TITLE = "pw-manager"
+
+    # Colors come from $theme-variables so every theme applies everywhere;
+    # widgets without rules here (table, footer, toasts) use Textual's own
+    # theme-aware defaults.
+    CSS = """
+    #unlock-box {
+        align: center middle;
+        width: 44;
+        height: auto;
+        padding: 1 2;
+        background: $surface;
+        border: round $panel;
+    }
+    #unlock-title {
+        color: $primary;
+        text-style: bold;
+        margin-bottom: 1;
+    }
+    #unlock-error {
+        color: $error;
+        margin-top: 1;
+    }
+    UnlockScreen {
+        align: center middle;
+    }
+    Input {
+        background: $surface;
+        border: round $panel;
+    }
+    Input:focus {
+        border: round $primary;
+    }
+    ModalScreen {
+        align: center middle;
+        background: $background 60%;
+    }
+    .modal-box {
+        width: 52;
+        height: auto;
+        padding: 1 2;
+        background: $surface;
+        border: round $primary;
+    }
+    .modal-title {
+        color: $primary;
+        text-style: bold;
+        margin-bottom: 1;
+    }
+    .modal-hint {
+        color: $text-muted;
+        margin-top: 1;
+    }
+    """
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.entries: dict = {}
+        self.master: str = ""
+
+    def on_mount(self) -> None:
+        for theme in TUXEDO_THEMES:
+            self.register_theme(theme)
+        try:
+            saved = open(THEME_FILE).read().strip()
+        except OSError:
+            saved = ""
+        self.theme = saved if saved in self.available_themes else "muted-slate"
+        self.theme_changed_signal.subscribe(self, self._remember_theme)
+        self.push_screen(UnlockScreen())
+
+    def _remember_theme(self, theme: Theme) -> None:
+        os.makedirs(os.path.dirname(THEME_FILE), exist_ok=True)
+        with open(THEME_FILE, "w") as f:
+            f.write(theme.name)
+
+    def get_system_commands(self, screen: Screen) -> Iterable[SystemCommand]:
+        yield from super().get_system_commands(screen)
+        if isinstance(screen, MainScreen):
+            yield SystemCommand(
+                "Change master password",
+                "re-encrypt the vault under a new master password",
+                self._change_master,
+            )
+
+    def _change_master(self) -> None:
+        def done(new: str | None) -> None:
+            if new:
+                self.master = new
+                vault.save(VAULT_PATH, self.master, self.entries)
+                self.notify("master password changed (old one is now useless)")
+
+        self.push_screen(PasswdModal(), done)
+
+
+def main() -> None:
+    PwApp().run()
+
+
+if __name__ == "__main__":
+    main()

{basic_password_manager-0.1.0 → basic_password_manager-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "basic-password-manager"
-version = "0.1.0"
+version = "0.2.1"
 description = "Local encrypted password manager that lives in your terminal"
 readme = "README.md"
 license = "MIT"
@@ -12,6 +12,7 @@ requires-python = ">=3.10"
 dependencies = [
     "argon2-cffi",
     "cryptography",
+    "textual",
 ]
 
 [project.scripts]