simple-rands 0.0.1__tar.gz

simple_rands-0.0.1/LICENSE

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

simple_rands-0.0.1/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: simple-rands
+Version: 0.0.1
+Summary: a very simple tool to generate random string with digits and numbers.
+License: MIT
+License-File: LICENSE
+Author: GGN_2015
+Author-email: neko@jlulug.org
+Requires-Python: >=3.10
+Classifier: License :: OSI Approved :: MIT License
+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
+Description-Content-Type: text/markdown
+
+# simple-rands
+a very simple tool to generate random string with digits and numbers.
+
+## Install
+
+```bash
+pip install simple-rands
+```
+
+## Usage
+
+```python
+import simple_rands
+
+# optional: set seed for generator
+simple_rands.seed(12345)
+
+length = 10
+print(simple_rands.gen(length))
+```
+

simple_rands-0.0.1/README.md

@@ -0,0 +1,20 @@
+# simple-rands
+a very simple tool to generate random string with digits and numbers.
+
+## Install
+
+```bash
+pip install simple-rands
+```
+
+## Usage
+
+```python
+import simple_rands
+
+# optional: set seed for generator
+simple_rands.seed(12345)
+
+length = 10
+print(simple_rands.gen(length))
+```

simple_rands-0.0.1/pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "simple-rands"
+version = "0.0.1"
+description = "a very simple tool to generate random string with digits and numbers."
+authors = [
+    {name = "GGN_2015",email = "neko@jlulug.org"}
+]
+license = {text = "MIT"}
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+]
+
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"

simple_rands-0.0.1/simple_rands/__init__.py

@@ -0,0 +1,6 @@
+from .main import gen, seed
+
+__all__ = [
+    "gen",
+    "seed"
+]

simple_rands-0.0.1/simple_rands/main.py

@@ -0,0 +1,55 @@
+import random
+import string
+from typing import Optional
+
+# random value generator
+RNG = random.Random()
+
+# set seed for random generator
+def seed(value:int):
+    RNG.seed(value)
+
+def gen(length:int, rng:Optional[random.Random]=None):
+    """
+    Generate a random string of specified length containing lowercase letters, uppercase letters and numbers
+    
+    Parameters:
+        length (int): The length of the string to be generated, must be a positive integer
+    
+    Returns:
+        str: Randomly generated string
+    
+    Raises:
+        ValueError: Raised when the length is not a positive integer
+    """
+    # Validate input parameter legality
+    if not isinstance(length, int) or length <= 0:
+        raise ValueError("String length must be a positive integer greater than 0")
+    
+    if rng is None: # use default
+        rng = RNG
+
+    # type of rng should be verified
+    if not isinstance(rng, random.Random):
+        raise TypeError()
+
+    # Build character pool: lowercase letters + uppercase letters + digits
+    char_pool = string.ascii_lowercase + string.ascii_uppercase + string.digits
+    
+    # Randomly select specified number of characters from the character pool and concatenate into a string
+    random_chars = [rng.choice(char_pool) for _ in range(length)]
+    random_string = ''.join(random_chars)
+    
+    return random_string
+
+# Test examples
+if __name__ == "__main__":
+    # set seed for generator
+    seed(42)
+
+    # Generate random string with length 8
+    print("Random string of length 8:", gen(8))
+    # Generate random string with length 16
+    print("Random string of length 16:", gen(16))
+    # Generate random string with length 20
+    print("Random string of length 20:", gen(20))