Smart Random v0.0.1

Author: smartlegionlab

.gitignore

@@ -157,4 +157,4 @@ cython_debug/
 #  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-#.idea/
+.idea/

LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License
 
-Copyright (c) 2023, Smart Bear
+Copyright (c) 2023, A.A Suvorov
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:

README.md

@@ -1 +1,49 @@
-# smartrandom
+# smartrandom
+
+---
+
+## 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.
+---
+
+## Help:
+
+```python
+from smartrandom.random_master import RandomMaster
+
+random_string = RandomMaster.string.get(length=10)
+random_number_string = RandomMaster.number.get(length=10)
+password = RandomMaster.password.get(length=10)
+random_hash = RandomMaster.hash.get(text='give me hash')
+random_number_code = RandomMaster.get_code(length=10, number_flag=True)
+random_string_code = RandomMaster.get_code(length=10, string_flag=True)
+random_symbol_code = RandomMaster.get_code(length=10, symbol_flag=True)
+
+```
+
+***
+
+## Disclaimer of liability:
+
+    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+    AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+    IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+    DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+    FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+    DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+    SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+    CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+    OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+***
+
+## Copyright:
+    --------------------------------------------------------
+    Licensed under the terms of the BSD 3-Clause License
+    (see LICENSE for details).
+    Copyright © 2018-2023, A.A Suvorov
+    All rights reserved.
+    --------------------------------------------------------

smartrandom/__init__.py

@@ -0,0 +1,73 @@
+# -*- coding: utf-8 -*-
+# --------------------------------------------------------
+# Licensed under the terms of the BSD 3-Clause License
+# (see LICENSE for details).
+# Copyright © 2018-2023, A.A Suvorov
+# All rights reserved.
+# --------------------------------------------------------
+# https://github.com/smartlegionlab
+# --------------------------------------------------------
+import hashlib
+import random
+import string
+
+
+class RandomStringMaster:
+    letters = string.ascii_letters
+
+    @classmethod
+    def get(cls, length=10):
+        return ''.join((random.choice(cls.letters) for _ in range(length)))
+
+
+class RandomNumberMaster:
+    numbers = string.digits
+
+    @classmethod
+    def get(cls, length=10):
+        return ''.join((random.choice(cls.numbers) for _ in range(length)))
+
+
+class RandomSymbolMaster:
+    symbols = '@$!%*#?&-'
+
+    @classmethod
+    def get(cls, length=10):
+        return ''.join((random.choice(cls.symbols) for _ in range(length)))
+
+
+class RandomPasswordMaster:
+    letters = string.ascii_letters
+    numbers = string.digits
+    symbols = '@$!%*#?&-'
+
+    @classmethod
+    def get(cls, length=10):
+        return ''.join((random.choice(cls.letters + cls.numbers + cls.symbols) for _ in range(length)))
+
+
+class RandomHashMaster:
+    @classmethod
+    def get(cls, text):
+        sha = hashlib.sha3_512(text.encode('utf-8'))
+        new_hash = sha.hexdigest()
+        return new_hash
+
+
+class RandomMaster:
+    string = RandomStringMaster()
+    number = RandomNumberMaster()
+    symbol = RandomSymbolMaster()
+    password = RandomPasswordMaster()
+    hash = RandomHashMaster()
+
+    @classmethod
+    def get_code(cls, length=10, number_flag=False, string_flag=False, symbol_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)))