passvault-cli-tool 1.0.0__tar.gz

passvault_cli_tool-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Senume
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

passvault_cli_tool-1.0.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include passvault_tui/style.css
+recursive-include passvault_tui/widgets *.py
+recursive-include passvault_core *.py
+recursive-include utils *.py

passvault_cli_tool-1.0.0/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: passvault-cli-tool
+Version: 1.0.0
+Summary: A local-first TUI password manager for Linux.
+Author: Senume
+License: MIT
+Project-URL: Homepage, https://github.com/Senume/PassVault
+Keywords: password-manager,tui,cli,security
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Security
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography>=41.0
+Requires-Dist: argon2-cffi>=23.0
+Requires-Dist: appdirs>=1.4
+Requires-Dist: textual>=0.60
+Requires-Dist: rich>=13.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Dynamic: license-file
+
+# 🔐 PassVault
+
+A local TUI (Terminal User Interface) password manager for Linux.  
+Credentials are encrypted with **Argon2id + AES-GCM** and never leave your machine.
+
+---
+
+## Features
+
+| Key | Action |
+|-----|--------|
+| `/` | Open vault selector overlay |
+| `n` | Create a new vault |
+| `g` | Add a new credential to the current vault |
+| `f` | Search credentials by name |
+| `e` | Export current vault as an encrypted `.pvault` archive |
+| `i` | Import a vault from a `.pvault` archive |
+| `ctrl+d` | Delete the current vault (requires typing vault name) |
+| `ctrl+g` | Auto-generate a strong password (inside Add Credential panel) |
+| `ctrl+v` | Paste from clipboard into any input field |
+
+---
+
+## Requirements
+
+### System dependency
+PassVault uses `xclip` for clipboard operations:
+```bash
+sudo apt install xclip        # Debian / Ubuntu
+sudo pacman -S xclip          # Arch
+sudo dnf install xclip        # Fedora
+```
+
+### Python
+- Python **3.10+**
+
+---
+
+## Installation
+
+### From PyPI
+```bash
+pip install passvault
+```
+
+### From source
+```bash
+git clone https://github.com/Senume/PassVault.git
+cd PassVault
+pip install -e .
+```
+
+---
+
+## Running
+
+```bash
+passvault
+```
+
+---
+
+## Data & log paths
+
+PassVault resolves paths in priority order:
+
+| | System path (root) | User fallback | Env override |
+|---|---|---|---|
+| **Vaults** | `/etc/passvault/vaults` | `~/.local/share/passvault/vaults` | `$PASSVAULT` |
+| **Logs** | `/var/log/passvault/passvault.log` | `~/.local/state/passvault/passvault.log` | `$PASSVAULT_LOG` |
+
+Directories are created automatically on first run.
+
+> To grant your user write access to the system paths:
+> ```bash
+> sudo mkdir -p /etc/passvault/vaults /var/log/passvault
+> sudo chown -R $USER /etc/passvault /var/log/passvault
+> ```
+
+---
+
+## Usage walkthrough
+
+### 1 — Create a vault
+Press `n`, enter a vault name and master password (confirmed twice). Press `Enter`.
+
+### 2 — Add credentials
+Press `g` (a vault must be selected first via `/`).  
+Fill in **Name**, **Username**, **Password** — or press `Ctrl+G` to auto-generate a strong password.  
+Press `Enter` to confirm, then enter the vault master password.
+
+### 3 — View credentials
+Select a credential from the list and press `Enter`.  
+Enter the master password to unlock.  
+Press `c` to copy the username or `p` to copy the password to clipboard.  
+Press `Esc` to close.
+
+### 4 — Search
+Press `f` to focus the search bar. Type to filter credentials by name in real time. Press `Esc` to clear.
+
+### 5 — Export / Import
+- **Export** (`e`): saves the current vault as an encrypted `.pvault` zip to a path you specify (default: `~/PassVault_exports/`).
+- **Import** (`i`): restores a vault from a `.pvault` file path.
+
+The archive keeps credentials AES-GCM encrypted — no master password is needed for the transfer itself.
+
+### 6 — Delete a vault
+Press `Ctrl+D`, then type the vault name exactly to confirm permanent deletion.
+
+---
+
+## Security
+
+- **KDF**: Argon2id (time cost 3, memory 64 MB, parallelism 1)
+- **Encryption**: AES-256-GCM per credential — each `.ptr` file is independently encrypted
+- **Master password**: never stored; derived key exists only in memory during a session
+- **Clipboard**: copy operations use `xclip`; clear the clipboard manually after use
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/Senume/PassVault.git
+cd PassVault
+pip install -e ".[dev]"
+
+# Run tests
+PYTHONPATH=$PWD pytest -q
+
+# Run the app
+PASSVAULT=data passvault
+```
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE)

passvault_cli_tool-1.0.0/README.md

@@ -0,0 +1,139 @@
+# 🔐 PassVault
+
+A local TUI (Terminal User Interface) password manager for Linux.  
+Credentials are encrypted with **Argon2id + AES-GCM** and never leave your machine.
+
+---
+
+## Features
+
+| Key | Action |
+|-----|--------|
+| `/` | Open vault selector overlay |
+| `n` | Create a new vault |
+| `g` | Add a new credential to the current vault |
+| `f` | Search credentials by name |
+| `e` | Export current vault as an encrypted `.pvault` archive |
+| `i` | Import a vault from a `.pvault` archive |
+| `ctrl+d` | Delete the current vault (requires typing vault name) |
+| `ctrl+g` | Auto-generate a strong password (inside Add Credential panel) |
+| `ctrl+v` | Paste from clipboard into any input field |
+
+---
+
+## Requirements
+
+### System dependency
+PassVault uses `xclip` for clipboard operations:
+```bash
+sudo apt install xclip        # Debian / Ubuntu
+sudo pacman -S xclip          # Arch
+sudo dnf install xclip        # Fedora
+```
+
+### Python
+- Python **3.10+**
+
+---
+
+## Installation
+
+### From PyPI
+```bash
+pip install passvault
+```
+
+### From source
+```bash
+git clone https://github.com/Senume/PassVault.git
+cd PassVault
+pip install -e .
+```
+
+---
+
+## Running
+
+```bash
+passvault
+```
+
+---
+
+## Data & log paths
+
+PassVault resolves paths in priority order:
+
+| | System path (root) | User fallback | Env override |
+|---|---|---|---|
+| **Vaults** | `/etc/passvault/vaults` | `~/.local/share/passvault/vaults` | `$PASSVAULT` |
+| **Logs** | `/var/log/passvault/passvault.log` | `~/.local/state/passvault/passvault.log` | `$PASSVAULT_LOG` |
+
+Directories are created automatically on first run.
+
+> To grant your user write access to the system paths:
+> ```bash
+> sudo mkdir -p /etc/passvault/vaults /var/log/passvault
+> sudo chown -R $USER /etc/passvault /var/log/passvault
+> ```
+
+---
+
+## Usage walkthrough
+
+### 1 — Create a vault
+Press `n`, enter a vault name and master password (confirmed twice). Press `Enter`.
+
+### 2 — Add credentials
+Press `g` (a vault must be selected first via `/`).  
+Fill in **Name**, **Username**, **Password** — or press `Ctrl+G` to auto-generate a strong password.  
+Press `Enter` to confirm, then enter the vault master password.
+
+### 3 — View credentials
+Select a credential from the list and press `Enter`.  
+Enter the master password to unlock.  
+Press `c` to copy the username or `p` to copy the password to clipboard.  
+Press `Esc` to close.
+
+### 4 — Search
+Press `f` to focus the search bar. Type to filter credentials by name in real time. Press `Esc` to clear.
+
+### 5 — Export / Import
+- **Export** (`e`): saves the current vault as an encrypted `.pvault` zip to a path you specify (default: `~/PassVault_exports/`).
+- **Import** (`i`): restores a vault from a `.pvault` file path.
+
+The archive keeps credentials AES-GCM encrypted — no master password is needed for the transfer itself.
+
+### 6 — Delete a vault
+Press `Ctrl+D`, then type the vault name exactly to confirm permanent deletion.
+
+---
+
+## Security
+
+- **KDF**: Argon2id (time cost 3, memory 64 MB, parallelism 1)
+- **Encryption**: AES-256-GCM per credential — each `.ptr` file is independently encrypted
+- **Master password**: never stored; derived key exists only in memory during a session
+- **Clipboard**: copy operations use `xclip`; clear the clipboard manually after use
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/Senume/PassVault.git
+cd PassVault
+pip install -e ".[dev]"
+
+# Run tests
+PYTHONPATH=$PWD pytest -q
+
+# Run the app
+PASSVAULT=data passvault
+```
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE)

passvault_cli_tool-1.0.0/passvault_cli_tool.egg-info/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: passvault-cli-tool
+Version: 1.0.0
+Summary: A local-first TUI password manager for Linux.
+Author: Senume
+License: MIT
+Project-URL: Homepage, https://github.com/Senume/PassVault
+Keywords: password-manager,tui,cli,security
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Security
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography>=41.0
+Requires-Dist: argon2-cffi>=23.0
+Requires-Dist: appdirs>=1.4
+Requires-Dist: textual>=0.60
+Requires-Dist: rich>=13.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Dynamic: license-file
+
+# 🔐 PassVault
+
+A local TUI (Terminal User Interface) password manager for Linux.  
+Credentials are encrypted with **Argon2id + AES-GCM** and never leave your machine.
+
+---
+
+## Features
+
+| Key | Action |
+|-----|--------|
+| `/` | Open vault selector overlay |
+| `n` | Create a new vault |
+| `g` | Add a new credential to the current vault |
+| `f` | Search credentials by name |
+| `e` | Export current vault as an encrypted `.pvault` archive |
+| `i` | Import a vault from a `.pvault` archive |
+| `ctrl+d` | Delete the current vault (requires typing vault name) |
+| `ctrl+g` | Auto-generate a strong password (inside Add Credential panel) |
+| `ctrl+v` | Paste from clipboard into any input field |
+
+---
+
+## Requirements
+
+### System dependency
+PassVault uses `xclip` for clipboard operations:
+```bash
+sudo apt install xclip        # Debian / Ubuntu
+sudo pacman -S xclip          # Arch
+sudo dnf install xclip        # Fedora
+```
+
+### Python
+- Python **3.10+**
+
+---
+
+## Installation
+
+### From PyPI
+```bash
+pip install passvault
+```
+
+### From source
+```bash
+git clone https://github.com/Senume/PassVault.git
+cd PassVault
+pip install -e .
+```
+
+---
+
+## Running
+
+```bash
+passvault
+```
+
+---
+
+## Data & log paths
+
+PassVault resolves paths in priority order:
+
+| | System path (root) | User fallback | Env override |
+|---|---|---|---|
+| **Vaults** | `/etc/passvault/vaults` | `~/.local/share/passvault/vaults` | `$PASSVAULT` |
+| **Logs** | `/var/log/passvault/passvault.log` | `~/.local/state/passvault/passvault.log` | `$PASSVAULT_LOG` |
+
+Directories are created automatically on first run.
+
+> To grant your user write access to the system paths:
+> ```bash
+> sudo mkdir -p /etc/passvault/vaults /var/log/passvault
+> sudo chown -R $USER /etc/passvault /var/log/passvault
+> ```
+
+---
+
+## Usage walkthrough
+
+### 1 — Create a vault
+Press `n`, enter a vault name and master password (confirmed twice). Press `Enter`.
+
+### 2 — Add credentials
+Press `g` (a vault must be selected first via `/`).  
+Fill in **Name**, **Username**, **Password** — or press `Ctrl+G` to auto-generate a strong password.  
+Press `Enter` to confirm, then enter the vault master password.
+
+### 3 — View credentials
+Select a credential from the list and press `Enter`.  
+Enter the master password to unlock.  
+Press `c` to copy the username or `p` to copy the password to clipboard.  
+Press `Esc` to close.
+
+### 4 — Search
+Press `f` to focus the search bar. Type to filter credentials by name in real time. Press `Esc` to clear.
+
+### 5 — Export / Import
+- **Export** (`e`): saves the current vault as an encrypted `.pvault` zip to a path you specify (default: `~/PassVault_exports/`).
+- **Import** (`i`): restores a vault from a `.pvault` file path.
+
+The archive keeps credentials AES-GCM encrypted — no master password is needed for the transfer itself.
+
+### 6 — Delete a vault
+Press `Ctrl+D`, then type the vault name exactly to confirm permanent deletion.
+
+---
+
+## Security
+
+- **KDF**: Argon2id (time cost 3, memory 64 MB, parallelism 1)
+- **Encryption**: AES-256-GCM per credential — each `.ptr` file is independently encrypted
+- **Master password**: never stored; derived key exists only in memory during a session
+- **Clipboard**: copy operations use `xclip`; clear the clipboard manually after use
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/Senume/PassVault.git
+cd PassVault
+pip install -e ".[dev]"
+
+# Run tests
+PYTHONPATH=$PWD pytest -q
+
+# Run the app
+PASSVAULT=data passvault
+```
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE)

passvault_cli_tool-1.0.0/passvault_cli_tool.egg-info/SOURCES.txt

@@ -0,0 +1,34 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+passvault_cli_tool.egg-info/PKG-INFO
+passvault_cli_tool.egg-info/SOURCES.txt
+passvault_cli_tool.egg-info/dependency_links.txt
+passvault_cli_tool.egg-info/entry_points.txt
+passvault_cli_tool.egg-info/requires.txt
+passvault_cli_tool.egg-info/top_level.txt
+passvault_core/clipboard.py
+passvault_core/crypto.py
+passvault_core/errors.py
+passvault_core/schema.py
+passvault_core/storage.py
+passvault_core/tests/test_clipboard.py
+passvault_core/tests/test_crypto.py
+passvault_core/tests/test_schema.py
+passvault_core/tests/test_storage.py
+passvault_tui/__init__.py
+passvault_tui/app.py
+passvault_tui/style.css
+passvault_tui/screens/__init__.py
+passvault_tui/utils/__init__.py
+passvault_tui/widgets/__init__.py
+passvault_tui/widgets/add_credential_panel.py
+passvault_tui/widgets/add_vault_panel.py
+passvault_tui/widgets/credential_panel.py
+passvault_tui/widgets/delete_vault_panel.py
+passvault_tui/widgets/export_vault_panel.py
+passvault_tui/widgets/import_vault_panel.py
+passvault_tui/widgets/master_password_panel.py
+utils/__init__.py
+utils/logger.py

passvault_cli_tool-1.0.0/passvault_cli_tool.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

passvault_cli_tool-1.0.0/passvault_cli_tool.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+passvault = passvault_tui.app:run

passvault_cli_tool-1.0.0/passvault_cli_tool.egg-info/requires.txt

@@ -0,0 +1,11 @@
+cryptography>=41.0
+argon2-cffi>=23.0
+appdirs>=1.4
+textual>=0.60
+rich>=13.0
+pydantic>=2.0
+httpx>=0.27
+
+[dev]
+pytest
+pytest-asyncio

passvault_cli_tool-1.0.0/passvault_cli_tool.egg-info/top_level.txt

@@ -0,0 +1,3 @@
+passvault_core
+passvault_tui
+utils