password-wallet 0.1.0__tar.gz

password_wallet-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 imaguss
+
+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.

password_wallet-0.1.0/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: password-wallet
+Version: 0.1.0
+Summary: Administrador de billeteras porque soy imbecil y me olvido de la mayoria de contraseñas complejas
+Author: imaguss
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/imaguss/password-wallet
+Project-URL: Repository, https://github.com/imaguss/password-wallet
+Keywords: password,wallet,clipboard,security
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Natural Language :: Spanish
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography>=49.0.0
+Requires-Dist: pyperclip>=1.11.0
+Dynamic: license-file
+
+# Password Wallet
+
+A CLI password manager that stores encrypted credentials and securely copies them to the clipboard, automatically clearing after 5 seconds.
+
+## Installation
+
+```bash
+pip install password-wallet
+```
+
+## Usage
+
+```bash
+# Create a new vault (first run)
+password-wallet key_file vault_file
+
+# Add a new password
+password-wallet key_file vault_file --new-password
+
+# List stored credentials
+password-wallet key_file vault_file --list
+
+# Search and copy a password
+password-wallet key_file vault_file --search-pass "platform_name"
+
+# Delete a credential
+password-wallet key_file vault_file --delete-pass "platform_name"
+```
+
+## How it works
+
+- Master password is derived using **Argon2id** (memory-hard KDF)
+- Credentials are encrypted with **Fernet** (symmetric AES-128-CBC)
+- Passwords are copied to clipboard and automatically cleared after 5 seconds
+- Key file stores the Argon2 salt for password derivation

password_wallet-0.1.0/README.md

@@ -0,0 +1,35 @@
+# Password Wallet
+
+A CLI password manager that stores encrypted credentials and securely copies them to the clipboard, automatically clearing after 5 seconds.
+
+## Installation
+
+```bash
+pip install password-wallet
+```
+
+## Usage
+
+```bash
+# Create a new vault (first run)
+password-wallet key_file vault_file
+
+# Add a new password
+password-wallet key_file vault_file --new-password
+
+# List stored credentials
+password-wallet key_file vault_file --list
+
+# Search and copy a password
+password-wallet key_file vault_file --search-pass "platform_name"
+
+# Delete a credential
+password-wallet key_file vault_file --delete-pass "platform_name"
+```
+
+## How it works
+
+- Master password is derived using **Argon2id** (memory-hard KDF)
+- Credentials are encrypted with **Fernet** (symmetric AES-128-CBC)
+- Passwords are copied to clipboard and automatically cleared after 5 seconds
+- Key file stores the Argon2 salt for password derivation

password_wallet-0.1.0/password_wallet/Archivos/GestorArchivos.py

@@ -0,0 +1,36 @@
+import json
+import sys
+
+from pathlib import Path
+from cryptography.fernet import Fernet, InvalidToken
+
+class GestorArchivos:
+
+    @staticmethod
+    def cargar_archivo (ruta:Path,llave_maestra:Fernet) -> bytes:
+
+        if ruta.exists():
+            with open(file=ruta,mode='rb') as file:
+                try:
+                    token:bytes = file.read()
+                    archivo:bytes =  llave_maestra.decrypt(token)
+                except InvalidToken as e:
+                    print("Error: Incorrect master password.")
+                    sys.exit(1)
+        else:
+            with open(file=ruta,mode='wb') as file:
+                token = llave_maestra.encrypt(data=b"[]")
+                file.write(token)
+                archivo = b"[]"
+
+        return archivo
+
+
+    @staticmethod
+    def guardar_cifrar_archivo(ruta:Path,archivo_desencriptado:list[dict[str,str]],llave_maestra:Fernet) -> None:
+
+        archivo:str = json.dumps(obj=archivo_desencriptado)
+        archivo_encriptado:bytes = llave_maestra.encrypt(data=archivo.encode(encoding='utf-8'))
+
+        with open(file=ruta,mode="wb") as file:
+            file.write(archivo_encriptado)

password_wallet-0.1.0/password_wallet/Archivos/__init__.py

@@ -0,0 +1 @@
+from .GestorArchivos import GestorArchivos

password_wallet-0.1.0/password_wallet/Llaves/Llave.py

@@ -0,0 +1,32 @@
+import base64
+from pathlib import Path
+from cryptography.hazmat.primitives.kdf.argon2 import Argon2id
+
+class Llave:
+
+    @staticmethod
+    def obtener_llave(ruta:Path) -> bytes:
+
+        with open(file=ruta,mode='rb') as llave:
+            salto:bytes = llave.read()
+
+        return salto
+
+    @staticmethod
+    def guardar_llave(ruta:Path,salto:bytes) -> None:
+
+        with open(file=ruta,mode="wb") as llave:
+            _ = llave.write(salto)
+
+    @staticmethod
+    def crear_llave(contrasena:str,salto:bytes) -> bytes:
+        config:Argon2id = Argon2id(
+            salt= salto,
+            length=32,
+            iterations=3,
+            lanes=4,
+            memory_cost=2**16
+        )
+
+        llave:bytes = base64.urlsafe_b64encode(config.derive(contrasena.encode('utf-8')))
+        return llave

password_wallet-0.1.0/password_wallet/Llaves/__init__.py

@@ -0,0 +1 @@
+from .Llave import Llave

password_wallet-0.1.0/password_wallet/Manejador.py

@@ -0,0 +1,88 @@
+import json
+import sys
+import os
+import time
+import pyperclip
+
+from password_wallet.Llaves.Llave import Llave
+from password_wallet.Archivos.GestorArchivos import GestorArchivos
+from pathlib import Path
+from cryptography.fernet import Fernet
+
+class Manejador:
+
+    def __init__(self,contrasena:str,ruta:Path,ruta_archivo:Path) -> None:
+        self.__llave_maestra:Fernet = Fernet(key=self.obtener_llave(contrasena,ruta))
+        self.__archivo_desencriptado:list[dict[str,str]] = json.loads(GestorArchivos.cargar_archivo(ruta=ruta_archivo,llave_maestra=self.__llave_maestra).decode(encoding='utf-8'))
+
+    def obtener_llave(self, contrasena:str, ruta:Path) -> bytes:
+        salto:bytes
+        llave:bytes
+
+        if ruta.exists():
+            salto = Llave.obtener_llave(ruta)
+            llave = Llave.crear_llave(contrasena,salto)
+        else:
+            salto = os.urandom(16)
+            Llave.guardar_llave(ruta,salto)
+            llave =  Llave.crear_llave(contrasena,salto)
+
+        return llave
+
+    def guardar_cifrar_archivo(self,ruta:Path) -> None:
+        GestorArchivos.guardar_cifrar_archivo(ruta,archivo_desencriptado=self.__archivo_desencriptado,llave_maestra=self.__llave_maestra)
+
+    def cargar_contrasena(self, usuario:str,plataforma:str,contrasena:str) -> None:
+        self.__archivo_desencriptado.append({"usuario":usuario,"plataforma":plataforma,"contrasena":contrasena})
+
+    def mostrar_credenciales(self) -> None:
+
+        print("  Users and Platforms")
+        print("\u2500" * 40)
+
+        for credencial in self.__archivo_desencriptado:
+            print(f"  User:     {credencial["usuario"]}")
+            print(f"  Platform: {credencial["plataforma"]}")
+            print("\u2500" * 40)
+
+    def buscar_contra(self, plataforma:str) -> tuple[int,list[list[str]]]:
+
+        indice:int = -1
+
+        contras:list[list[str]] = [[c["contrasena"],c["usuario"]]
+        for c in self.__archivo_desencriptado
+        if c["plataforma"].lower() == plataforma.lower()]
+
+        try:
+            if len(contras) > 1:
+                print("  Multiple users found. Select one:")
+                for i, usuario in enumerate(contras, start=1):
+                    print(f"    {i}. {usuario[1]}")
+                try:
+                    indice = int(input("> ").strip())
+                except ValueError:
+                    print("  Please enter a valid number.")
+                except IndexError:
+                    print("  Selection out of range.")
+            else:
+                indice = 0
+        except IndexError:
+            print("  Password not found.")
+
+        return indice, contras
+
+    def copiar_al_portapapeles(self, timer:int, contra:str) -> None:
+
+        print(f"  Password copied! Clearing in {timer} seconds...", end=" ", flush=True)
+        pyperclip.copy(text=contra)
+
+        for i in range(timer, 0, -1):
+            print(f"{i}...", end=" ", flush=True)
+            time.sleep(1)
+
+        print("\n  Clipboard cleared.")
+        pyperclip.copy(text="")
+
+    def eliminar_contra(self, indice: int) -> None:
+        del self.__archivo_desencriptado[indice]
+        print("  Credential deleted successfully!")

password_wallet-0.1.0/password_wallet/__init__.py

@@ -0,0 +1 @@
+from .Manejador import Manejador

password_wallet-0.1.0/password_wallet/__main__.py

@@ -0,0 +1,89 @@
+import argparse
+import getpass
+import sys
+
+from password_wallet import Manejador
+from pathlib import Path
+
+
+def argumentos() -> argparse.Namespace:
+    parser: argparse.ArgumentParser = argparse.ArgumentParser(
+        prog="Password Wallet",
+        description="A password wallet that stores credentials in the clipboard and clears them after 5 seconds.",
+        epilog="Thanks for using Password Wallet!",
+    )
+
+    parser.add_argument("Key", type=str, help="Path to the key file that encrypts your data.")
+    parser.add_argument("file", type=str, help="Path to the file containing the encrypted credentials.")
+
+    parser.add_argument("--new-password", "-n", action="store_true", help="Add a new credential to the vault.")
+    parser.add_argument("--list", "-l", action="store_true", help="List all stored usernames and platforms.")
+    parser.add_argument("--search-pass", "-s", help="Search and copy a password by platform name.")
+    parser.add_argument("--delete-pass", "-d", help="Delete a credential by platform name.")
+
+    args: argparse.Namespace = parser.parse_args()
+
+    return args
+
+
+def crear_archivos(llave: Path, ruta: Path) -> None:
+    print("  Setting up a new password vault...")
+    print()
+    contrasena_verificar: str = getpass.getpass(prompt="  Master password: ")
+    contrasena_llave: str = getpass.getpass(prompt="  Master password (again): ")
+    if contrasena_verificar == contrasena_llave:
+        manejador: Manejador = Manejador(contrasena=contrasena_llave, ruta=llave, ruta_archivo=ruta)
+        print("  Vault created successfully!")
+    else:
+        print("  Passwords do not match.")
+        sys.exit(1)
+
+
+def main(args: argparse.Namespace) -> None:
+    ruta: Path = Path(args.file)
+    llave: Path = Path(args.Key)
+    indice: int
+
+    if llave.is_file() and ruta.is_file():
+        contrasena_llave: str = getpass.getpass(prompt="  Master password: ")
+    elif llave.exists() and not llave.is_file():
+        print("  Error: key path is a directory.")
+        sys.exit(1)
+    elif ruta.exists() and not ruta.is_file():
+        print("  Error: data path is a directory.")
+        sys.exit(1)
+    else:
+        crear_archivos(llave, ruta)
+        contrasena_llave = getpass.getpass(prompt="  Master password: ")
+
+    manejador: Manejador = Manejador(contrasena=contrasena_llave, ruta=llave, ruta_archivo=ruta)
+
+    if args.search_pass:
+        indice, contras = manejador.buscar_contra(plataforma=args.search_pass)
+        manejador.copiar_al_portapapeles(timer=5, contra=contras[indice - 1][0])
+    if args.list:
+        manejador.mostrar_credenciales()
+    if args.new_password:
+        user: str = input("User: ").strip()
+        platform: str = input("Platform: ").strip()
+        contrasena_ingresada: str = getpass.getpass(prompt="Password: ")
+        contrasena: str = getpass.getpass(prompt="Password again: ")
+
+        if contrasena_ingresada == contrasena:
+            manejador.cargar_contrasena(usuario=user, plataforma=platform, contrasena=contrasena)
+            manejador.guardar_cifrar_archivo(ruta)
+        else:
+            print("Passwords do not match.")
+            sys.exit(1)
+    if args.delete_pass:
+        indice, _ = manejador.buscar_contra(plataforma=args.delete_pass)
+        manejador.eliminar_contra(indice)
+        manejador.guardar_cifrar_archivo(ruta)
+
+
+def entry() -> None:
+    main(args=argumentos())
+
+
+if __name__ == "__main__":
+    entry()

password_wallet-0.1.0/password_wallet.egg-info/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: password-wallet
+Version: 0.1.0
+Summary: Administrador de billeteras porque soy imbecil y me olvido de la mayoria de contraseñas complejas
+Author: imaguss
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/imaguss/password-wallet
+Project-URL: Repository, https://github.com/imaguss/password-wallet
+Keywords: password,wallet,clipboard,security
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Natural Language :: Spanish
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography>=49.0.0
+Requires-Dist: pyperclip>=1.11.0
+Dynamic: license-file
+
+# Password Wallet
+
+A CLI password manager that stores encrypted credentials and securely copies them to the clipboard, automatically clearing after 5 seconds.
+
+## Installation
+
+```bash
+pip install password-wallet
+```
+
+## Usage
+
+```bash
+# Create a new vault (first run)
+password-wallet key_file vault_file
+
+# Add a new password
+password-wallet key_file vault_file --new-password
+
+# List stored credentials
+password-wallet key_file vault_file --list
+
+# Search and copy a password
+password-wallet key_file vault_file --search-pass "platform_name"
+
+# Delete a credential
+password-wallet key_file vault_file --delete-pass "platform_name"
+```
+
+## How it works
+
+- Master password is derived using **Argon2id** (memory-hard KDF)
+- Credentials are encrypted with **Fernet** (symmetric AES-128-CBC)
+- Passwords are copied to clipboard and automatically cleared after 5 seconds
+- Key file stores the Argon2 salt for password derivation

password_wallet-0.1.0/password_wallet.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+password_wallet/Manejador.py
+password_wallet/__init__.py
+password_wallet/__main__.py
+password_wallet.egg-info/PKG-INFO
+password_wallet.egg-info/SOURCES.txt
+password_wallet.egg-info/dependency_links.txt
+password_wallet.egg-info/entry_points.txt
+password_wallet.egg-info/requires.txt
+password_wallet.egg-info/top_level.txt
+password_wallet/Archivos/GestorArchivos.py
+password_wallet/Archivos/__init__.py
+password_wallet/Llaves/Llave.py
+password_wallet/Llaves/__init__.py

password_wallet-0.1.0/password_wallet.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

password_wallet-0.1.0/password_wallet.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+password-wallet = password_wallet.__main__:entry

password_wallet-0.1.0/password_wallet.egg-info/requires.txt

@@ -0,0 +1,2 @@
+cryptography>=49.0.0
+pyperclip>=1.11.0

password_wallet-0.1.0/password_wallet.egg-info/top_level.txt

@@ -0,0 +1 @@
+password_wallet

password_wallet-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=75"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "password-wallet"
+version = "0.1.0"
+description = "Administrador de billeteras porque soy imbecil y me olvido de la mayoria de contraseñas complejas"
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "imaguss" }
+]
+keywords = ["password", "wallet", "clipboard", "security"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Natural Language :: Spanish",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Security :: Cryptography",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "cryptography>=49.0.0",
+    "pyperclip>=1.11.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/imaguss/password-wallet"
+Repository = "https://github.com/imaguss/password-wallet"
+
+[project.scripts]
+password-wallet = "password_wallet.__main__:entry"
+
+[tool.setuptools.packages.find]
+include = ["password_wallet", "password_wallet.*"]
+
+[tool.basedpyright]
+typeCheckingMode = "standard"
+reportUnusedExpression = false
+reportUnusedVariable = false
+reportIncompatibleMethodOverride = false

password_wallet-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+