basic-password-manager 0.2.2__tar.gz → 0.2.4__tar.gz

{basic_password_manager-0.2.2 → basic_password_manager-0.2.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: basic-password-manager
-Version: 0.2.2
-Summary: Local encrypted password manager that lives in your terminal
+Version: 0.2.4
+Summary: The Paladin — a local encrypted password manager that lives in your terminal
 License-Expression: MIT
 Project-URL: Repository, https://github.com/Daisentaur/password-manager
 Project-URL: Changelog, https://github.com/Daisentaur/password-manager/blob/main/CHANGELOG.md
@@ -13,11 +13,17 @@ Requires-Dist: cryptography
 Requires-Dist: textual
 Dynamic: license-file
 
-# pw-manager
+<p align="center">
+  <img src="assets/logo.png" width="160" alt="The Paladin — a pixel-art knight" />
+</p>
+
+<h1 align="center">The Paladin</h1>
+
+<p align="center"><em>Your passwords, guarded locally. No browser, no cloud, no mercy.</em></p>
 
 A local, encrypted password manager that lives in your terminal. No browser,
 no cloud, no daemon — one encrypted file on disk and a small Python CLI in
-front of it.
+front of it. (Installs as `basic-password-manager`; answers to `pw`.)
 
 ```
 $ python pw.py get github
@@ -74,6 +80,7 @@ Or use the subcommands:
 | `pw find "dt bank"` | search names, usernames, notes — every word must match, any order |
 | `pw gen -l 32` | just print a random password |
 | `pw import passwords.csv` | import a browser CSV export (see below) |
+| `pw about` | meet the knight |
 
 The vault lives at `~/.local/share/pw-manager/vault`. Set the `PW_VAULT`
 environment variable to put it somewhere else.

{basic_password_manager-0.2.2 → basic_password_manager-0.2.4}/README.md

@@ -1,8 +1,14 @@
-# pw-manager
+<p align="center">
+  <img src="assets/logo.png" width="160" alt="The Paladin — a pixel-art knight" />
+</p>
+
+<h1 align="center">The Paladin</h1>
+
+<p align="center"><em>Your passwords, guarded locally. No browser, no cloud, no mercy.</em></p>
 
 A local, encrypted password manager that lives in your terminal. No browser,
 no cloud, no daemon — one encrypted file on disk and a small Python CLI in
-front of it.
+front of it. (Installs as `basic-password-manager`; answers to `pw`.)
 
 ```
 $ python pw.py get github
@@ -59,6 +65,7 @@ Or use the subcommands:
 | `pw find "dt bank"` | search names, usernames, notes — every word must match, any order |
 | `pw gen -l 32` | just print a random password |
 | `pw import passwords.csv` | import a browser CSV export (see below) |
+| `pw about` | meet the knight |
 
 The vault lives at `~/.local/share/pw-manager/vault`. Set the `PW_VAULT`
 environment variable to put it somewhere else.

{basic_password_manager-0.2.2 → basic_password_manager-0.2.4}/basic_password_manager.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: basic-password-manager
-Version: 0.2.2
-Summary: Local encrypted password manager that lives in your terminal
+Version: 0.2.4
+Summary: The Paladin — a local encrypted password manager that lives in your terminal
 License-Expression: MIT
 Project-URL: Repository, https://github.com/Daisentaur/password-manager
 Project-URL: Changelog, https://github.com/Daisentaur/password-manager/blob/main/CHANGELOG.md
@@ -13,11 +13,17 @@ Requires-Dist: cryptography
 Requires-Dist: textual
 Dynamic: license-file
 
-# pw-manager
+<p align="center">
+  <img src="assets/logo.png" width="160" alt="The Paladin — a pixel-art knight" />
+</p>
+
+<h1 align="center">The Paladin</h1>
+
+<p align="center"><em>Your passwords, guarded locally. No browser, no cloud, no mercy.</em></p>
 
 A local, encrypted password manager that lives in your terminal. No browser,
 no cloud, no daemon — one encrypted file on disk and a small Python CLI in
-front of it.
+front of it. (Installs as `basic-password-manager`; answers to `pw`.)
 
 ```
 $ python pw.py get github
@@ -74,6 +80,7 @@ Or use the subcommands:
 | `pw find "dt bank"` | search names, usernames, notes — every word must match, any order |
 | `pw gen -l 32` | just print a random password |
 | `pw import passwords.csv` | import a browser CSV export (see below) |
+| `pw about` | meet the knight |
 
 The vault lives at `~/.local/share/pw-manager/vault`. Set the `PW_VAULT`
 environment variable to put it somewhere else.

{basic_password_manager-0.2.2 → basic_password_manager-0.2.4}/basic_password_manager.egg-info/SOURCES.txt

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

{basic_password_manager-0.2.2 → basic_password_manager-0.2.4}/pw_manager/cli.py

@@ -47,7 +47,27 @@ def cmd_init(args):
         sys.exit(f"vault already exists at {VAULT_PATH}")
     os.makedirs(os.path.dirname(VAULT_PATH), exist_ok=True)
     vault.save(VAULT_PATH, ask_master(confirm=True), {})
-    print(f"empty vault created at {VAULT_PATH}")
+    if sys.stdout.isatty():
+        from . import logo
+
+        print(logo.says(f"empty vault created at {VAULT_PATH}"))
+    else:
+        print(f"empty vault created at {VAULT_PATH}")
+
+
+def cmd_about(args):
+    from importlib.metadata import PackageNotFoundError, version
+
+    try:
+        v = version("basic-password-manager")
+    except PackageNotFoundError:
+        v = "dev"  # running from source without an install
+    from . import logo
+
+    print(logo.ascii_art())
+    print(f"The Paladin ⚔ v{v}")
+    print("your passwords, guarded locally — no browser, no cloud, no mercy")
+    print("https://github.com/Daisentaur/password-manager")
 
 
 def cmd_add(args):
@@ -198,6 +218,7 @@ def main():
     f.add_argument("term")
     i = sub.add_parser("import", help="import a browser CSV export")
     i.add_argument("csv_file")
+    sub.add_parser("about", help="meet the knight")
 
     args = p.parse_args()
     if args.command is None:

basic_password_manager-0.2.4/pw_manager/logo.py

@@ -0,0 +1,130 @@
+"""The Paladin, as terminal pixel art.
+
+Extracted once from assets/logo.png (each letter below is one pixel; dev-time
+script, no image libraries at runtime). Rendered with half-block characters:
+one character cell shows two pixels — top half foreground, bottom half
+background.
+"""
+
+from rich.style import Style
+from rich.text import Text
+
+PALETTE = {
+    "k": (0, 0, 0), "s": (140, 139, 147), "w": (194, 191, 198),
+    "o": (243, 243, 245), "g": (86, 85, 91), "d": (32, 32, 32),
+    "l": (158, 157, 163), "b": (246, 120, 59), "r": (143, 64, 47),
+}
+
+ROWS = [
+    "......kkk.........",
+    ".....kswwkk.......",
+    "....wwwwwwwk......",
+    "...kwwwwwwwok.....",
+    "...kowwwwwwwk.....",
+    "...kgdooodgwk.....",
+    "...kdddddddwk...k.",
+    "...kwwdddwwwk..kok",
+    "..kkwwwddwwwk.kgl.",
+    ".ookoowddookk.glk.",
+    "kgskkkwookkkbblk..",
+    "kssswwkkksskkrk...",
+    ".kkkssgggwwksk....",
+    "...ksswwwwwkk.....",
+    "...kgkkkkggk......",
+    "....k.....k.......",
+]
+
+
+def _pixel_pairs():
+    """Yield rows of (top_color, bottom_color) tuples, one per char cell."""
+    for top, bottom in zip(ROWS[::2], ROWS[1::2]):
+        yield [
+            (PALETTE.get(t), PALETTE.get(b))
+            for t, b in zip(top, bottom)
+        ]
+
+
+def ansi(indent: str = "") -> str:
+    """The knight as a raw ANSI truecolor string, for print()."""
+    out = []
+    for row in _pixel_pairs():
+        line = indent
+        for top, bottom in row:
+            if top is None and bottom is None:
+                line += "\x1b[0m "
+            elif bottom is None:
+                line += "\x1b[0m\x1b[38;2;%d;%d;%dm▀" % top
+            elif top is None:
+                line += "\x1b[0m\x1b[38;2;%d;%d;%dm▄" % bottom
+            else:
+                line += "\x1b[38;2;%d;%d;%dm\x1b[48;2;%d;%d;%dm▀" % (top + bottom)
+        out.append(line + "\x1b[0m")
+    return "\n".join(out)
+
+
+_ORANGE = (PALETTE["b"], PALETTE["r"])
+
+
+def _tinted(pixel, tint, accent):
+    """Recolor a pixel: keep its brightness, take its hue from the theme —
+    the accent color for the sword guard, the tint for everything else."""
+    if tint is None or pixel is None:
+        return pixel
+    base = accent if pixel in _ORANGE else tint
+    lum = sum(pixel) / 765
+    return tuple(int(c * lum) for c in base)
+
+
+def _hex_rgb(color: str) -> tuple:
+    color = color.lstrip("#")
+    return tuple(int(color[i : i + 2], 16) for i in (0, 2, 4))
+
+
+def rich_text(tint: str | None = None, accent: str | None = None) -> Text:
+    """The knight as a Rich Text, for Textual widgets. Pass theme colors as
+    hex strings to render him in the theme's livery instead of silver."""
+    tint_rgb = _hex_rgb(tint) if tint else None
+    accent_rgb = _hex_rgb(accent) if accent else tint_rgb
+    text = Text()
+    for row in _pixel_pairs():
+        for top, bottom in row:
+            top = _tinted(top, tint_rgb, accent_rgb)
+            bottom = _tinted(bottom, tint_rgb, accent_rgb)
+            if top is None and bottom is None:
+                text.append(" ")
+            elif bottom is None:
+                text.append("▀", Style(color="rgb(%d,%d,%d)" % top))
+            elif top is None:
+                text.append("▄", Style(color="rgb(%d,%d,%d)" % bottom))
+            else:
+                text.append("▀", Style(color="rgb(%d,%d,%d)" % top, bgcolor="rgb(%d,%d,%d)" % bottom))
+        text.append("\n")
+    return text
+
+
+def ascii_art() -> str:
+    """The knight as plain monochrome ASCII — two chars per pixel to keep
+    his proportions in terminal cells, denser glyphs for brighter armor."""
+    lines = []
+    for row in ROWS:
+        line = ""
+        for ch in row:
+            pixel = PALETTE.get(ch)
+            if pixel is None:
+                line += "  "
+            elif pixel in _ORANGE:
+                line += "%%"
+            else:
+                lum = sum(pixel) / 765
+                line += "::" if lum < 0.15 else "++" if lum < 0.45 else "==" if lum < 0.8 else "##"
+        lines.append(line.rstrip())
+    return "\n".join(lines)
+
+
+def says(message: str) -> str:
+    """Cowsay, but it's a knight."""
+    border = "_" * (len(message) + 2)
+    return (
+        f" {border}\n< {message} >\n {'-' * (len(message) + 2)}\n"
+        f"       \\\n" + ansi(indent="        ")
+    )

{basic_password_manager-0.2.2 → basic_password_manager-0.2.4}/pw_manager/tui.py

@@ -17,11 +17,14 @@ from textual.screen import ModalScreen, Screen
 from textual.theme import Theme
 from textual.widgets import DataTable, Footer, Input, Label, Static
 
-from . import vault
+from . import logo, vault
 from .cli import VAULT_PATH, generate, import_csv, to_clipboard
 
 THEME_FILE = os.path.expanduser("~/.local/share/pw-manager/theme")
 
+APP_NAME = "The Paladin"
+APP_ICON = "⚔"
+
 TUXEDO_THEMES = [
     Theme(
         name="muted-slate",
@@ -73,10 +76,21 @@ class UnlockScreen(Screen):
 
     def compose(self) -> ComposeResult:
         with Vertical(id="unlock-box"):
-            yield Label("pw-manager", id="unlock-title")
+            yield Static(id="unlock-logo")
+            yield Label(f"{APP_ICON} {APP_NAME}", id="unlock-title")
             yield Input(password=True, placeholder="master password", id="master")
             yield Static("", id="unlock-error")
 
+    def on_mount(self) -> None:
+        self._paint_logo()
+        self.app.theme_changed_signal.subscribe(self, self._paint_logo)
+
+    def _paint_logo(self, _theme: Theme | None = None) -> None:
+        theme = self.app.current_theme
+        self.query_one("#unlock-logo", Static).update(
+            logo.rich_text(tint=theme.primary, accent=theme.warning or theme.primary)
+        )
+
     def on_input_submitted(self, event: Input.Submitted) -> None:
         self.query_one("#unlock-error", Static).update("unlocking…")
         try:
@@ -212,6 +226,7 @@ class MainScreen(Screen):
     ]
 
     def compose(self) -> ComposeResult:
+        yield Static(f" {APP_ICON} {APP_NAME}", id="topbar")
         yield Input(placeholder="/ to search", id="search")
         yield DataTable(id="table", cursor_type="row")
         yield Footer()
@@ -362,13 +377,19 @@ class VaultCommands(Provider):
 
 
 class PwApp(App):
-    TITLE = "pw-manager"
+    TITLE = APP_NAME
     COMMANDS = App.COMMANDS | {VaultCommands}
 
     # 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 = """
+    #topbar {
+        height: 1;
+        background: $panel;
+        color: $primary;
+        text-style: bold;
+    }
     #unlock-box {
         align: center middle;
         width: 44;
@@ -377,7 +398,14 @@ class PwApp(App):
         background: $surface;
         border: round $panel;
     }
+    #unlock-logo {
+        width: 100%;
+        text-align: center;
+        margin-bottom: 1;
+    }
     #unlock-title {
+        width: 100%;
+        text-align: center;
         color: $primary;
         text-style: bold;
         margin-bottom: 1;

{basic_password_manager-0.2.2 → basic_password_manager-0.2.4}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "basic-password-manager"
-version = "0.2.2"
-description = "Local encrypted password manager that lives in your terminal"
+version = "0.2.4"
+description = "The Paladin — a local encrypted password manager that lives in your terminal"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.10"
@@ -15,6 +15,9 @@ dependencies = [
     "textual",
 ]
 
+[tool.setuptools]
+packages = ["pw_manager"]
+
 [project.scripts]
 pw = "pw_manager.cli:main"