smartrandom v0.2.1

Author: smartlegionlab

README.md

@@ -1,10 +1,9 @@
-# smartrandom <sup>v0.2.0</sup>
+# smartrandom <sup>v0.2.1</sup>
 ---
 
 ## Random Data Generators:
 
-Allows you to generate random strings of a given length from letters, numbers and symbols, as well as randomize text.
-Helps generate passwords, service codes (for example, for sending via SMS), hashes and much more.
+Random data generators. Allows you to generate random strings of a given length from letters, numbers and symbols, as well as randomize text. Helps generate passwords, service codes (for example, for sending via SMS), hashes and much more. Generates smart, recoverable passwords.
 
 ---
 
@@ -23,20 +22,11 @@ Author and developer: ___A.A. Suvorov.___
 
 ## What is news:
 
-smartrandom 0.2.0 - new improved version of the library.
+smartrandom 0.2.1 - new improved version of the library.
 
-> WARNING! This version is not backward compatible with previous versions.
-
-- Completely rewritten and improved code.
-- Simplified import
-- Uses more secure and cryptographically strong secrets instead of random
-- Generated passwords must now contain at least one digit, one lowercase letter, one uppercase letter and one symbol. Length is at least 4.
-- Random letter generation is now at least 2. At least 1 lowercase letter and one uppercase letter are required.
-- Improved UrandomGenerator default size=128.
-- Added TextRandomizer.
-- Added tests.
-- Test coverage 100%.
-- Added documentation.
+- Added a regular password generator.
+- Added a smart password generator.
+- Improved tests
 
 ***
 

data/images/coverage_report.png

@@ -3,7 +3,7 @@ name = smartrandom
 version = attr: smartrandom.__version__
 author = A.A. Suvorov
 author_email = [email protected]
-description = Random Data Generators. Allows you to generate random strings of a given length from letters, numbers and symbols, as well as randomize text. Helps generate passwords, service codes (for example, for sending via SMS), hashes and much more.
+description = Random data generators. Allows you to generate random strings of a given length from letters, numbers and symbols, as well as randomize text. Helps generate passwords, service codes (for example, for sending via SMS), hashes and much more. Generates smart, recoverable passwords.
 long_description = file: README.md
 long_description_content_type = text/markdown
 url = https://github.com/smartlegionlab/smartrandom/

setup.cfg

@@ -7,10 +7,11 @@
 # https://github.com/smartlegionlab/
 # --------------------------------------------------------
 """
-Smart Random - Random Data Generators.
+Random data generators.
 
 Allows you to generate random strings of a given length from letters, numbers and symbols, as well as randomize text.
 Helps generate passwords, service codes (for example, for sending via SMS), hashes and much more.
+Generates smart, recoverable passwords.
 
 """
 from .generators import (
@@ -20,8 +21,10 @@
     HashGenerator,
     UrandomGenerator,
     TextRandomizer,
+    BasePasswordGenerator,
     PasswordGenerator,
+    SmartPasswordGenerator,
     SecretCodeGenerator,
     RandomDataGenerator,
 )
-__version__ = '0.2.0'
+__version__ = '0.2.1'

smartrandom/__init__.py

@@ -9,6 +9,7 @@
 """Random Data Generators."""
 import hashlib
 import os
+import random
 import re
 import secrets
 import string
@@ -159,6 +160,25 @@ def generate(cls, length: int = 10) -> str:
         return ''.join(result)
 
 
+class BasePasswordGenerator:
+    letters = string.ascii_letters
+    digits = string.digits
+    symbols = '!@#$%&^_'
+
+    @classmethod
+    def generate(cls, length=10):
+        """
+        Generates a random password of the specified length.
+
+        :param length: Length of the password (default is 10).
+        :return: A randomly generated password as a string.
+        """
+        if length < 4:
+            raise ValueError("The length must be at least 3.")
+        symbols_string = cls.letters + cls.digits + cls.symbols
+        return ''.join((random.choice(symbols_string) for _ in range(length)))
+
+
 class PasswordGenerator:
     upper_letters = string.ascii_uppercase
     lower_letters = string.ascii_lowercase
@@ -191,6 +211,50 @@ def generate(cls, length: int = 10) -> str:
         return ''.join(result)
 
 
+class SmartPasswordGenerator:
+    @classmethod
+    def generate(cls, seed: str = '', length=15, size: int = 32) -> str:
+        """
+        Generates a "smart" password using the specified seed.
+
+        :param seed: Seed for generation (default is an empty string).
+        :param length: Length of the password (default is 15).
+        :param size: Size of the seed for generation (default is 32).
+        :return: A generated "smart" password as a string.
+        """
+        if length < 4:
+            raise ValueError("The length cannot be less than 4.")
+        if not seed:
+            seed = cls.get_seed(size)
+        cls._set_seed(seed)
+        password = BasePasswordGenerator.generate(length)
+        seed = str(cls.get_seed())
+        cls._set_seed(seed)
+        return password
+
+    @classmethod
+    def _set_seed(cls, seed):
+        """
+        Sets the seed for the random number generator.
+
+        :param seed: Seed to set.
+        :return: The set seed as a string.
+        """
+        seed = str(seed)
+        random.seed(seed)
+        return seed
+
+    @classmethod
+    def get_seed(cls, size=32) -> bytes:
+        """
+        Generates a seed of the specified size.
+
+        :param size: Size of the seed (default is 32).
+        :return: Generated seed as bytes.
+        """
+        return UrandomGenerator.generate(size=size)
+
+
 class RandomDataGenerator:
     @staticmethod
     def generate_random_letters(length: int) -> str:
@@ -262,6 +326,27 @@ def randomize_text(text: str) -> str:
         """
         return TextRandomizer.randomize(text)
 
+    @staticmethod
+    def generate_base_password(length: int = 10) -> str:
+        """
+        Generates a base password using the BasePasswordGenerator class.
+
+        :param length: Length of the password (default is 10).
+        :return: A generated base password as a string.
+        """
+        return BasePasswordGenerator.generate(length)
+
+    @staticmethod
+    def generate_smart_password(seed: str, length: int = 10) -> str:
+        """
+        Generates a "smart" password using the specified seed.
+
+        :param seed: Seed for generation.
+        :param length: Length of the password (default is 10).
+        :return: A generated "smart" password as a string.
+        """
+        return SmartPasswordGenerator.generate(seed, length)
+
     @staticmethod
     def generate_password(length: int = 10) -> str:
         """