Smart Passwords Library (smartpasslib) v2.1.0

feat: add update functionality for smart password metadata

Add `SmartPassword.update()` and `SmartPasswordManager.update_smart_password()` methods
to modify description and length of existing smart passwords without affecting
cryptographic integrity. Public keys remain unchanged, ensuring backward compatibility
within v2.0.x/v2.1.x series.

- Add comprehensive test coverage for new functionality
- Update README.md

This allows users to modify service descriptions and password lengths without
recreating password entries, improving usability while maintaining security.

Author: smartlegionlab

README.md

@@ -0,0 +1,2 @@
+pytest
+pytest-cov

data/images/cov.png

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "smartpasslib"
-version = "2.0.0"
-description = "Cross-platform library for generating smart passwords."
+version = "2.1.0"
+description = "Smart Passwords Library: Cryptographic password generation and management without storage. Generate passwords from secrets, verify knowledge without exposure, manage metadata securely."
 authors = [
     {name = "Alexander Suvorov", email = "smartlegiondev@gmail.com"}
 ]

data/requirements-dev.txt

@@ -1,5 +1,6 @@
 # Copyright (©) 2025, Alexander Suvorov. All rights reserved.
-"""Smart Password Library - Cross-platform library for generating smart passwords."""
+"""Smart Passwords Library: Cryptographic password generation and management without storage.
+Generate passwords from secrets, verify knowledge without exposure, manage metadata securely."""
 from smartpasslib.factories.smart_password_factory import SmartPasswordFactory
 from smartpasslib.generators.base import BasePasswordGenerator
 from smartpasslib.generators.hash import HashGenerator
@@ -11,7 +12,7 @@
 from smartpasslib.managers.smart_password_manager import SmartPasswordManager
 from smartpasslib.masters.smart_password_master import SmartPasswordMaster
 from smartpasslib.smart_passwords.smart_password import SmartPassword
-__version__ = '2.0.0'
+__version__ = '2.1.0'
 __author__ = 'A.A. Suvorov'
 __all__ = [
     "SmartPasswordMaster",

pyproject.toml

@@ -112,6 +112,29 @@ def get_smart_password(self, public_key: str) -> Optional[SmartPassword]:
         """
         return self.smart_passwords.get(public_key)
 
+    def update_smart_password(self, public_key: str, description: str = None, length: int = None) -> bool:
+        """
+        Update metadata of an existing smart password.
+
+        Args:
+            public_key: Public key of the password to update
+            description: New description (optional)
+            length: New password length (optional)
+
+        Returns:
+            bool: True if update was successful, False if password not found
+
+        Raises:
+            ValueError: If length is provided and less than 1
+        """
+        password = self.get_smart_password(public_key)
+        if password is None:
+            return False
+
+        password.update(description=description, length=length)
+        self._write_data()
+        return True
+
     def delete_smart_password(self, public_key: str):
         """
         Delete smart password metadata by public key.

smartpasslib/__init__.py

@@ -52,6 +52,25 @@ def length(self) -> int:
         """
         return self._length
 
+    def update(self, description: str = None, length: int = None) -> None:
+        """
+        Update password metadata (description and/or length).
+
+        Args:
+            description: New service/account description (optional)
+            length: New password length (optional, must be >= 1)
+
+        Raises:
+            ValueError: If length is provided and less than 1
+        """
+        if description is not None:
+            self._description = description
+
+        if length is not None:
+            if length < 1:
+                raise ValueError("Password length must be at least 1 character")
+            self._length = length
+
     def to_dict(self) -> Dict[str, str | int]:
         """
         Convert to dictionary for serialization.

smartpasslib/managers/smart_password_manager.py

@@ -1,5 +1,7 @@
 # Copyright (©) 2025, Alexander Suvorov. All rights reserved.
 import pytest
+
+from smartpasslib import SmartPassword
 from smartpasslib.managers.smart_password_manager import SmartPasswordManager
 
 
@@ -88,3 +90,92 @@ def test_check_public_key(self, test_secret):
         assert SmartPasswordManager.check_public_key(test_secret, public_key) is True
         assert SmartPasswordManager.check_public_key("wrong_secret", public_key) is False
         assert SmartPasswordManager.check_public_key(test_secret, "wrong_key") is False
+
+    def test_update_smart_password(self, temp_file, test_password):
+        manager = SmartPasswordManager(filename=temp_file)
+        manager.add_smart_password(test_password)
+
+        assert manager.update_smart_password(test_password.public_key, description="Updated Description") is True
+        updated = manager.get_smart_password(test_password.public_key)
+        assert updated.description == "Updated Description"
+        assert updated.length == test_password.length  # Length unchanged
+
+        assert manager.update_smart_password(test_password.public_key, length=20) is True
+        updated = manager.get_smart_password(test_password.public_key)
+        assert updated.description == "Updated Description"  # Description unchanged
+        assert updated.length == 20
+
+        assert manager.update_smart_password(
+            test_password.public_key,
+            description="Final Description",
+            length=16
+        ) is True
+        updated = manager.get_smart_password(test_password.public_key)
+        assert updated.description == "Final Description"
+        assert updated.length == 16
+
+        manager2 = SmartPasswordManager(filename=temp_file)
+        reloaded = manager2.get_smart_password(test_password.public_key)
+        assert reloaded.description == "Final Description"
+        assert reloaded.length == 16
+
+    def test_update_nonexistent_password(self, temp_file):
+        manager = SmartPasswordManager(filename=temp_file)
+        assert manager.update_smart_password("nonexistent_key", description="Test") is False
+
+    def test_update_invalid_length(self, temp_file, test_password):
+        manager = SmartPasswordManager(filename=temp_file)
+        manager.add_smart_password(test_password)
+
+        with pytest.raises(ValueError, match="Password length must be at least 1 character"):
+            manager.update_smart_password(test_password.public_key, length=0)
+
+        original = manager.get_smart_password(test_password.public_key)
+        assert original.length == test_password.length
+        assert original.description == test_password.description
+
+    def test_update_no_changes(self, temp_file, test_password):
+        manager = SmartPasswordManager(filename=temp_file)
+        manager.add_smart_password(test_password)
+
+        assert manager.update_smart_password(test_password.public_key) is True
+
+        password = manager.get_smart_password(test_password.public_key)
+        assert password.description == test_password.description
+        assert password.length == test_password.length
+
+    def test_smart_password_update_method(self):
+        password = SmartPassword(
+            public_key="test_key",
+            description="Original Description",
+            length=12
+        )
+
+        password.update(description="New Description")
+        assert password.description == "New Description"
+        assert password.length == 12
+
+        password.update(length=20)
+        assert password.description == "New Description"
+        assert password.length == 20
+
+        password.update(description="Final Description", length=16)
+        assert password.description == "Final Description"
+        assert password.length == 16
+
+        with pytest.raises(ValueError, match="Password length must be at least 1 character"):
+            password.update(length=0)
+
+    def test_smart_password_update_preserves_public_key(self, temp_file, test_password):
+        manager = SmartPasswordManager(filename=temp_file)
+        manager.add_smart_password(test_password)
+
+        original_public_key = test_password.public_key
+        manager.update_smart_password(
+            test_password.public_key,
+            description="Updated",
+            length=20
+        )
+
+        updated = manager.get_smart_password(test_password.public_key)
+        assert updated.public_key == original_public_key  # Public key unchanged