passvault-cli 0.1.0__tar.gz → 0.1.2__tar.gz

{passvault_cli-0.1.0 → passvault_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: passvault-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: A local, encrypted, offline password manager CLI.
 Project-URL: Homepage, https://github.com/Ajeet2005/passvault
 Project-URL: Repository, https://github.com/Ajeet2005/passvault
@@ -91,13 +91,43 @@ we never return garbage plaintext.
 
 ## Install
 
-From PyPI:
+### Option 1 — pipx (recommended)
+
+[pipx](https://pipx.pypa.io/) installs CLI tools in isolated environments and
+puts their commands on your PATH. This is the best way to install `passvault`,
+and it avoids the Windows "`passvault` is not recognized" problem entirely:
+
+```bash
+# install pipx if you don't have it
+python -m pip install --user pipx
+python -m pipx ensurepath   # adds pipx's bin dir to PATH; restart your terminal after
+
+# then install passvault
+pipx install passvault-cli
+passvault init
+```
+
+### Option 2 — pip
 
 ```bash
 pip install passvault-cli
 ```
 
-Or from source:
+> **Windows note:** with a plain `pip install`, the `passvault.exe` launcher
+> lands in your Python `Scripts\` directory (e.g.
+> `...\Python313\Scripts\`), which is often **not** on your PATH — so running
+> `passvault` gives "command not found" / "is not recognized". Either:
+>
+> 1. add that `Scripts\` directory to your PATH, or
+> 2. skip PATH entirely and run the CLI as a module:
+>
+>    ```bash
+>    python -m passvault init
+>    ```
+>
+>    The `-m` form works with every install method, on every OS.
+
+### Option 3 — from source
 
 ```bash
 git clone https://github.com/Ajeet2005/passvault.git
@@ -112,6 +142,9 @@ Requires Python 3.10+.
 
 ## Usage
 
+All commands below also work as `python -m passvault <command>` if the
+`passvault` command itself is not on your PATH.
+
 ### Create a vault
 
 ```bash
@@ -208,4 +241,4 @@ battle-tested password manager.
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT — see [LICENSE](https://github.com/Ajeet2005/passvault/blob/main/LICENSE).

{passvault_cli-0.1.0 → passvault_cli-0.1.2}/README.md

@@ -34,13 +34,43 @@ we never return garbage plaintext.
 
 ## Install
 
-From PyPI:
+### Option 1 — pipx (recommended)
+
+[pipx](https://pipx.pypa.io/) installs CLI tools in isolated environments and
+puts their commands on your PATH. This is the best way to install `passvault`,
+and it avoids the Windows "`passvault` is not recognized" problem entirely:
+
+```bash
+# install pipx if you don't have it
+python -m pip install --user pipx
+python -m pipx ensurepath   # adds pipx's bin dir to PATH; restart your terminal after
+
+# then install passvault
+pipx install passvault-cli
+passvault init
+```
+
+### Option 2 — pip
 
 ```bash
 pip install passvault-cli
 ```
 
-Or from source:
+> **Windows note:** with a plain `pip install`, the `passvault.exe` launcher
+> lands in your Python `Scripts\` directory (e.g.
+> `...\Python313\Scripts\`), which is often **not** on your PATH — so running
+> `passvault` gives "command not found" / "is not recognized". Either:
+>
+> 1. add that `Scripts\` directory to your PATH, or
+> 2. skip PATH entirely and run the CLI as a module:
+>
+>    ```bash
+>    python -m passvault init
+>    ```
+>
+>    The `-m` form works with every install method, on every OS.
+
+### Option 3 — from source
 
 ```bash
 git clone https://github.com/Ajeet2005/passvault.git
@@ -55,6 +85,9 @@ Requires Python 3.10+.
 
 ## Usage
 
+All commands below also work as `python -m passvault <command>` if the
+`passvault` command itself is not on your PATH.
+
 ### Create a vault
 
 ```bash
@@ -151,4 +184,4 @@ battle-tested password manager.
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT — see [LICENSE](https://github.com/Ajeet2005/passvault/blob/main/LICENSE).

{passvault_cli-0.1.0 → passvault_cli-0.1.2}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 [project]
 # PyPI distribution name; the importable package remains `passvault`.
 name = "passvault-cli"
-version = "0.1.0"
+version = "0.1.2"
 description = "A local, encrypted, offline password manager CLI."
 readme = "README.md"
 requires-python = ">=3.10"

{passvault_cli-0.1.0 → passvault_cli-0.1.2}/src/passvault/__init__.py

@@ -2,6 +2,6 @@
 
 from __future__ import annotations
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"
 
 __all__ = ["__version__"]

passvault_cli-0.1.2/src/passvault/__main__.py

@@ -0,0 +1,14 @@
+"""Allow running the CLI as ``python -m passvault``.
+
+Handy when the ``passvault`` console script is not on your PATH — a common
+situation with a plain ``pip install`` on Windows, where the launcher lands in
+the Python ``Scripts\\`` directory. This module makes the invocation work
+regardless of how the package was installed.
+"""
+
+from __future__ import annotations
+
+from .cli import app
+
+if __name__ == "__main__":
+    app()

{passvault_cli-0.1.0 → passvault_cli-0.1.2}/tests/test_cli.py

@@ -182,4 +182,4 @@ def test_generate_invalid_length_errors(vault_file, prompts):
 def test_version(vault_file):
     result = runner.invoke(cli.app, ["--version"])
     assert result.exit_code == 0
-    assert "0.1.0" in result.output
+    assert "0.1.2" in result.output