Smart Random v0.1.0 Corrected errors. Code refactoring. Stable version.

Author: smartlegionlab

README.md

@@ -1,10 +1,11 @@
-# smartrandom <sup>v0.0.3</sup>
+# smartrandom <sup>v0.1.0</sup>
 ---
 
 ## Random Data Generators:
 
-Allows you to generate random strings of a given length from letters, numbers, symbols.
-Helps to generate passwords, service codes (for example, for sending via SMS), hashes and much more.
+Allows you to generate random strings of a given length from letters, numbers, and symbols.
+Helps to generate passwords, service codes (for example, for sending via SMS), hashes, and much more.
+
 ---
 
 [![GitHub release (latest by date)](https://img.shields.io/github/v/release/smartlegionlab/smartrandom)](https://github.com/smartlegionlab/smartrandom/)
@@ -14,19 +15,25 @@ Helps to generate passwords, service codes (for example, for sending via SMS), h
 [![GitHub](https://img.shields.io/github/license/smartlegionlab/smartrandom)](https://github.com/smartlegionlab/smartrandom/blob/master/LICENSE)
 [![PyPI - Format](https://img.shields.io/pypi/format/smartrandom)](https://pypi.org/project/smartrandom)
 
+***
+
+Author and developer: ___A.A Suvorov.___
+
+***
 
 ## Help:
 
+`pip install smartrandom`
+
 ```python
-from smartrandom.random_master import RandomMaster
-
-random_string = RandomMaster.string.create(length=10)
-random_number_string = RandomMaster.number.create(length=10)
-password = RandomMaster.password.create(length=10)
-random_hash = RandomMaster.hash.create(text='give me hash')
-random_number_code = RandomMaster.create_code(length=10, number_flag=True)
-random_string_code = RandomMaster.create_code(length=10, string_flag=True)
-random_symbol_code = RandomMaster.create_code(length=10, symbol_flag=True)
+from smartrandom.random_master import RandomStringMaster
+
+random_string = RandomStringMaster.create_string(length=10)
+string_hash = RandomStringMaster.create_hash('text')
+number_code = RandomStringMaster.create_numeric_code(length=6)
+letter_code = RandomStringMaster.create_letters_code(length=6)
+symbol_code = RandomStringMaster.create_letters_code(length=6)
+code = RandomStringMaster.create_code(length=10, numeric_flag=True, letters_flag=True, symbols_flag=True)
 
 ```
 

setup.cfg

@@ -3,7 +3,7 @@ name = smartrandom
 version = attr: smartrandom.__version__
 author = A.A Suvorov
 author_email = [email protected]
-description = Random Data Generators
+description = Random Data Generators.
 long_description = file: README.md
 long_description_content_type = text/markdown
 url = https://github.com/smartlegionlab/smartrandom/
@@ -22,6 +22,10 @@ classifiers =
 
 keywords =
     password generator
+    code generator
+    random generator
+    random code generator
+    random string generator
     smartrandom
     smartlegionlab
 

setup.py

@@ -1,3 +1,11 @@
+# --------------------------------------------------------
+# Licensed under the terms of the BSD 3-Clause License
+# (see LICENSE for details).
+# Copyright © 2018-2024, A.A Suvorov
+# All rights reserved.
+# --------------------------------------------------------
+# https://github.com/smartlegionlab
+# --------------------------------------------------------
 from setuptools import setup, find_packages
 
 setup(

smartrandom/__init__.py

@@ -6,5 +6,9 @@
 # --------------------------------------------------------
 # https://github.com/smartlegionlab
 # --------------------------------------------------------
-"""Smart Random"""
-__version__ = '0.0.3'
+"""Smart Random - Random Data Generators.
+
+Allows you to generate random strings of a given length from letters, numbers, and symbols.
+Helps to generate passwords, service codes (for example, for sending via SMS), hashes, and much more.
+"""
+__version__ = '0.1.0'

smartrandom/random_master.py

@@ -6,67 +6,81 @@
 # --------------------------------------------------------
 # https://github.com/smartlegionlab
 # --------------------------------------------------------
+"""Random Data Generators."""
 import hashlib
 import random
 import string
 
 
-class RandomStringMaster:
+class RandomLettersMaster:
     letters = string.ascii_letters
 
     @classmethod
     def create(cls, length=10):
         return ''.join((random.choice(cls.letters) for _ in range(length)))
 
 
-class RandomNumberMaster:
+class RandomNumericMaster:
     numbers = string.digits
 
     @classmethod
     def create(cls, length=10):
         return ''.join((random.choice(cls.numbers) for _ in range(length)))
 
 
-class RandomSymbolMaster:
+class RandomSymbolsMaster:
     symbols = '@$!%*#?&-'
 
     @classmethod
     def create(cls, length=10):
         return ''.join((random.choice(cls.symbols) for _ in range(length)))
 
 
-class RandomPasswordMaster:
-    letters = string.ascii_letters
-    numbers = string.digits
-    symbols = '@$!%*#?&-'
+class HashMaster:
+    @classmethod
+    def create(cls, text: str):
+        text = str(text)
+        sha = hashlib.sha3_512(text.encode('utf-8'))
+        new_hash = sha.hexdigest()
+        return new_hash
+
+
+class RandomStringMaster:
+    letters_master = RandomLettersMaster()
+    numeric_master = RandomNumericMaster()
+    symbols_master = RandomSymbolsMaster()
+    hash_master = HashMaster()
 
     @classmethod
-    def create(cls, length=10):
-        return ''.join((random.choice(cls.letters + cls.numbers + cls.symbols) for _ in range(length)))
+    def create_string(cls, length=10):
+        random_string = cls.letters_master.letters + cls.numeric_master.numbers + cls.symbols_master.symbols
+        return ''.join((random.choice(random_string) for _ in range(length)))
 
+    @classmethod
+    def create_hash(cls, text):
+        return cls.hash_master.create(text)
 
-class RandomHashMaster:
     @classmethod
-    def create(cls, text):
-        sha = hashlib.sha3_512(text.encode('utf-8'))
-        new_hash = sha.hexdigest()
-        return new_hash
+    def create_numeric_code(cls, length):
+        return cls.numeric_master.create(length)
 
+    @classmethod
+    def create_letters_code(cls, length):
+        return cls.letters_master.create(length)
 
-class RandomMaster:
-    string = RandomStringMaster()
-    number = RandomNumberMaster()
-    symbol = RandomSymbolMaster()
-    password = RandomPasswordMaster()
-    hash = RandomHashMaster()
+    @classmethod
+    def create_symbols_code(cls, length):
+        return cls.symbols_master.create(length)
 
     @classmethod
-    def create_code(cls, length=10, number_flag=False, string_flag=False, symbol_flag=False):
+    def create_code(cls, length=10, numeric_flag=False, letters_flag=False, symbols_flag=False):
         data = ''
-        if string_flag:
-            data += cls.string.letters
-        if number_flag:
-            data += cls.number.numbers
-        if symbol_flag:
-            data += cls.symbol.symbols
-        return ''.join((random.choice(data) for _ in range(length)))
+        if letters_flag:
+            data += cls.letters_master.letters
+        if numeric_flag:
+            data += cls.numeric_master.numbers
+        if symbols_flag:
+            data += cls.symbols_master.symbols
+        if data:
+            return ''.join((random.choice(data) for _ in range(length)))
+        return None