doc and comments tweaks

python-pyo3/src/lib.rs

@@ -17,6 +17,8 @@ fn vault_error_to_anyhow(err: VaultError) -> anyhow::Error {
     err.into()
 }
 
+// These signatures can be removed in a future version since these are all required arguments
+// https://github.com/PyO3/pyo3/blob/main/guide/src/function/signature.md#trailing-optional-arguments
 #[pyfunction(signature = (vault_stack=None, region=None, bucket=None, key=None, prefix=None))]
 fn all(
     vault_stack: Option<String>,

python/README.md

@@ -54,7 +54,7 @@ Or install inside venv with:
 # With uv
 uv pip install .
 # Normal venv
-python -m pip install -e .
+python -m pip install .
 ```
 
 After installing, you will have `vault` available in path.

python/n_vault/cli.py

@@ -34,12 +34,12 @@ def main():
     action.add_argument(
         "--version",
         action="store_true",
-        help="Print vault version",
+        help="Print vault version and exit",
     )
     action.add_argument(
         "-s",
         "--store",
-        help="Name of element to store. Optionally read from file name",
+        help="Key name to use for stored value. Optionally read from file name",
         nargs="?",
         default="",
     )
@@ -157,6 +157,7 @@ def main():
     if args.version:
         print(VERSION)
         exit(0)
+
     try:
         if args.store and not (args.value or args.file):
             parser.error("--store requires --value or --file")