ExtraFunctions 0.1.5__tar.gz → 0.1.7__tar.gz

{extrafunctions-0.1.5 → extrafunctions-0.1.7}/ExtraFunctions/__init__.py

@@ -1,8 +1,10 @@
+from copy import deepcopy
 import json
 import os
 import random as r
 from PIL import Image
 import time as t
+import secrets as s
 
 
 
@@ -34,6 +36,7 @@ def negative(used):
 
 
 
+
     
 class SaveError(Exception):
     pass
@@ -338,4 +341,133 @@ def DistanceTranslate(amount, from_unit, to_unit):
         raise ValueError(f"Unknown distance unit: {to_unit}")
 
     metres = amount * units[from_unit]
-    return metres / units[to_unit]
+    return metres / units[to_unit]
+def GeneratePassword(length):
+    characters = [
+        "a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m",
+        "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z",
+        "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M",
+        "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z",
+        "0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
+        " ", "!", "\"", "#", "$", "%", "&", "'", "(", ")", "*", "+", ",",
+        "-", ".", "/", ":", ";", "<", "=", ">", "?", "@", "[", "\\", "]",
+        "^", "_", "`", "{", "|", "}", "~"]
+    password = ""
+    for i in range(length):
+        password += s.choice(characters)
+    return password
+def DrawProgressBar(percent=0):
+    print("[", end="", flush=True)
+    for i in range(percent//10):
+        print("█", end="", flush=True)
+    for i in range((10 - (percent//10))):
+        print(" ", end="", flush=True)
+    print("]", end="", flush=True)
+def UpdateProgressBar(Npercent):
+    print("\r[", end="", flush=True)
+    for i in range(Npercent//10):
+            print("█", end="", flush=True)
+    for i in range((10 - (Npercent//10))):
+            print(" ", end="", flush=True)
+    print("]", end="", flush=True)
+def FormatTime(seconds):
+    seconds = int(seconds)
+
+    days = seconds // 86400
+    seconds %= 86400
+
+    hours = seconds // 3600
+    seconds %= 3600
+
+    minutes = seconds // 60
+    seconds %= 60
+
+    parts = []
+
+    if days:
+        parts.append(f"{days} day" + ("s" if days != 1 else ""))
+
+    if hours:
+        parts.append(f"{hours} hour" + ("s" if hours != 1 else ""))
+
+    if minutes:
+        parts.append(f"{minutes} minute" + ("s" if minutes != 1 else ""))
+
+    if seconds or not parts:
+        parts.append(f"{seconds} second" + ("s" if seconds != 1 else ""))
+
+    return " ".join(parts)
+def CaesarEncrypt(text, shift):
+    result = ""
+
+    for character in text:
+
+        if character.isalpha():
+
+            if character.isupper():
+                start = ord("A")
+            else:
+                start = ord("a")
+
+            position = ord(character) - start
+            new_position = (position + shift) % 26
+
+            result += chr(start + new_position)
+
+        else:
+            result += character
+
+    return result
+
+
+def CaesarDecrypt(text, shift):
+    return CaesarEncrypt(text, -shift)
+def DrawLoadingSpinner():
+    print("-", end="", flush=True)
+def UpdateLoadingSpinner(rotation):
+    if rotation % 4 == 0:
+        rotate = "\r-"
+    elif rotation % 4 == 1:
+        rotate = "\r\\"
+    elif rotation % 4 == 2:
+        rotate = "\r|"
+    elif rotation % 4 == 3:
+        rotate = "\r/"
+    print( rotate, end="", flush=True)
+def StartCountdown(seconds):
+    print(f"{seconds} seconds remaining", end = "", flush=True)
+def UpdateCountdown(time):
+    if time>0:
+        print(f"\r{time} seconds remaining ", end = "", flush=True)
+    else:
+        print("\r                    ", end = "", flush = True)
+def SlowWrite(txt, speed=0.5):
+    letters = list(txt)
+    for i in range(len(letters)):
+        try:
+            print(letters[i], end = "", flush = True)
+        except:
+            pass
+        t.sleep(speed)
+def RandomChoice(choices, amount=1):
+    mchoices = deepcopy(choices)
+    clist = []
+    for i in range(amount):
+        choice = r.choice(mchoices)
+        mchoices.remove(choice)
+        clist += [choice]
+    return clist
+def RemoveDuplicates(List):
+    return list(set(List))
+def IsPalindrone(txt):
+    if negative(txt) == txt:
+        return True
+    else:
+        return False
+def percentage(part, total):
+    return (part/total)*100
+def ValidateInput(Input, type):
+    try:
+        return type(Input)
+    except:
+        raise TypeError(f"{Input} canot be turned into {type} format.")

extrafunctions-0.1.7/ExtraFunctions.egg-info/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: ExtraFunctions
+Version: 0.1.7
+Summary: A collection of useful Python utility functions.
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: Pillow==10
+
+# ExtraFunctions
+
+ExtraFunctions is a collection of useful Python functions designed to make common programming tasks simpler.
+
+It includes utilities for saving data, generating random values, working with files, terminal displays, text manipulation, encryption, and more.
+
+## Installation
+
+Install ExtraFunctions using pip:
+
+```bash
+pip install ExtraFunctions
+```
+
+## Functions
+
+### General Utilities
+
+* `negative(used)` — Reverses strings or makes numbers negative.
+* `average(numbers)` — Calculates the average of a collection of numbers.
+* `clamp(variable, top, bottom)` — Keeps a value between two limits.
+* `WaitUntil(boolean, max_frames)` — Waits until a condition becomes true.
+* `TimeLenFunc(func, *input)` — Measures how long a function takes to run.
+* `attempt(func, *inputs, times)` — Attempts to run a function multiple times.
+
+### Save System
+
+* `Save(variable, name)` — Saves a variable.
+* `SaveReset()` — Resets saved data.
+* `SaveReturn(name)` — Returns a saved value.
+* `DeleteSave(name)` — Deletes a saved value.
+* `SaveChange(variable, name)` — Changes an existing saved value.
+* `Exists(name)` — Checks whether a saved value exists.
+* `ReturnSaved()` — Returns all saved data.
+
+### Random Utilities
+
+* `RandomString(length)` — Generates a random string.
+* `RandomChoice(choices, amount=1)` — Selects one or more unique random choices.
+* `WeightedRandom(options, values)` — Makes a weighted random selection.
+* `PasswordGenerator(length)` — Generates a secure random password.
+
+### Files and Data
+
+* `FileExists(file)` — Checks whether a file exists.
+* `load(file)` — Loads supported files.
+
+### Terminal Utilities
+
+* `DrawProgressBar(percent)` — Draws a terminal progress bar.
+* `UpdateProgressBar(percent)` — Updates the progress bar.
+* `DrawLoadingSpinner()` — Draws a loading spinner.
+* `UpdateLoadingSpinner(rotation)` — Updates the loading spinner.
+* `StartCountdown(seconds)` — Starts a terminal countdown.
+* `UpdateCountdown(time)` — Updates a countdown.
+* `SlowWrite(text, speed=0.5)` — Prints text gradually, like a typewriter.
+
+### Text and Encryption
+
+* `CaesarEncrypt(text, shift)` — Encrypts text using a Caesar cipher.
+* `CaesarDecrypt(text, shift)` — Decrypts Caesar cipher text.
+* `IsPalindrome(text)` — Checks whether text reads the same forwards and backwards.
+
+### Other Utilities
+
+* `FormatTime(seconds)` — Converts seconds into a readable time format.
+* `RemoveDuplicates(list)` — Removes duplicate items from a list.
+* `PlanetInfo(planet, info=False)` — Returns information about a planet.
+* `DistanceTranslate(amount, from_unit, to_unit)` — Converts between supported distance units.
+
+## Examples
+
+### Generate a password
+
+```python
+from ExtraFunctions import PasswordGenerator
+
+password = PasswordGenerator(20)
+
+print(password)
+```
+
+### Create a progress bar
+
+```python
+from ExtraFunctions import DrawProgressBar, UpdateProgressBar
+import time
+
+DrawProgressBar(0)
+
+for i in range(101):
+    UpdateProgressBar(i)
+    time.sleep(0.05)
+
+print()
+```
+
+### Slowly print text
+
+```python
+from ExtraFunctions import SlowWrite
+
+SlowWrite("Hello, World!", 0.1)
+```
+
+### Random choices
+
+```python
+from ExtraFunctions import RandomChoice
+
+planets = ["Mercury", "Venus", "Earth", "Mars"]
+
+print(RandomChoice(planets, 2))
+```
+
+## Errors
+
+ExtraFunctions includes several custom errors:
+
+* `UknownFormatError`
+* `SaveError`
+* `InfiniteError`
+* `NonexistentPlanetError`
+
+## Notes
+
+ExtraFunctions is an independent Python project that is continually being expanded with new functions and utilities.
+
+More features may be added in future updates.s

extrafunctions-0.1.7/ExtraFunctions.egg-info/requires.txt

@@ -0,0 +1 @@
+Pillow==10

{extrafunctions-0.1.5 → extrafunctions-0.1.7}/ExtraFunctions.egg-info/top_level.txt

@@ -1,2 +1 @@
 ExtraFunctions
-dist

extrafunctions-0.1.7/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: ExtraFunctions
+Version: 0.1.7
+Summary: A collection of useful Python utility functions.
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: Pillow==10
+
+# ExtraFunctions
+
+ExtraFunctions is a collection of useful Python functions designed to make common programming tasks simpler.
+
+It includes utilities for saving data, generating random values, working with files, terminal displays, text manipulation, encryption, and more.
+
+## Installation
+
+Install ExtraFunctions using pip:
+
+```bash
+pip install ExtraFunctions
+```
+
+## Functions
+
+### General Utilities
+
+* `negative(used)` — Reverses strings or makes numbers negative.
+* `average(numbers)` — Calculates the average of a collection of numbers.
+* `clamp(variable, top, bottom)` — Keeps a value between two limits.
+* `WaitUntil(boolean, max_frames)` — Waits until a condition becomes true.
+* `TimeLenFunc(func, *input)` — Measures how long a function takes to run.
+* `attempt(func, *inputs, times)` — Attempts to run a function multiple times.
+
+### Save System
+
+* `Save(variable, name)` — Saves a variable.
+* `SaveReset()` — Resets saved data.
+* `SaveReturn(name)` — Returns a saved value.
+* `DeleteSave(name)` — Deletes a saved value.
+* `SaveChange(variable, name)` — Changes an existing saved value.
+* `Exists(name)` — Checks whether a saved value exists.
+* `ReturnSaved()` — Returns all saved data.
+
+### Random Utilities
+
+* `RandomString(length)` — Generates a random string.
+* `RandomChoice(choices, amount=1)` — Selects one or more unique random choices.
+* `WeightedRandom(options, values)` — Makes a weighted random selection.
+* `PasswordGenerator(length)` — Generates a secure random password.
+
+### Files and Data
+
+* `FileExists(file)` — Checks whether a file exists.
+* `load(file)` — Loads supported files.
+
+### Terminal Utilities
+
+* `DrawProgressBar(percent)` — Draws a terminal progress bar.
+* `UpdateProgressBar(percent)` — Updates the progress bar.
+* `DrawLoadingSpinner()` — Draws a loading spinner.
+* `UpdateLoadingSpinner(rotation)` — Updates the loading spinner.
+* `StartCountdown(seconds)` — Starts a terminal countdown.
+* `UpdateCountdown(time)` — Updates a countdown.
+* `SlowWrite(text, speed=0.5)` — Prints text gradually, like a typewriter.
+
+### Text and Encryption
+
+* `CaesarEncrypt(text, shift)` — Encrypts text using a Caesar cipher.
+* `CaesarDecrypt(text, shift)` — Decrypts Caesar cipher text.
+* `IsPalindrome(text)` — Checks whether text reads the same forwards and backwards.
+
+### Other Utilities
+
+* `FormatTime(seconds)` — Converts seconds into a readable time format.
+* `RemoveDuplicates(list)` — Removes duplicate items from a list.
+* `PlanetInfo(planet, info=False)` — Returns information about a planet.
+* `DistanceTranslate(amount, from_unit, to_unit)` — Converts between supported distance units.
+
+## Examples
+
+### Generate a password
+
+```python
+from ExtraFunctions import PasswordGenerator
+
+password = PasswordGenerator(20)
+
+print(password)
+```
+
+### Create a progress bar
+
+```python
+from ExtraFunctions import DrawProgressBar, UpdateProgressBar
+import time
+
+DrawProgressBar(0)
+
+for i in range(101):
+    UpdateProgressBar(i)
+    time.sleep(0.05)
+
+print()
+```
+
+### Slowly print text
+
+```python
+from ExtraFunctions import SlowWrite
+
+SlowWrite("Hello, World!", 0.1)
+```
+
+### Random choices
+
+```python
+from ExtraFunctions import RandomChoice
+
+planets = ["Mercury", "Venus", "Earth", "Mars"]
+
+print(RandomChoice(planets, 2))
+```
+
+## Errors
+
+ExtraFunctions includes several custom errors:
+
+* `UknownFormatError`
+* `SaveError`
+* `InfiniteError`
+* `NonexistentPlanetError`
+
+## Notes
+
+ExtraFunctions is an independent Python project that is continually being expanded with new functions and utilities.
+
+More features may be added in future updates.s

extrafunctions-0.1.7/README.md

@@ -0,0 +1,129 @@
+# ExtraFunctions
+
+ExtraFunctions is a collection of useful Python functions designed to make common programming tasks simpler.
+
+It includes utilities for saving data, generating random values, working with files, terminal displays, text manipulation, encryption, and more.
+
+## Installation
+
+Install ExtraFunctions using pip:
+
+```bash
+pip install ExtraFunctions
+```
+
+## Functions
+
+### General Utilities
+
+* `negative(used)` — Reverses strings or makes numbers negative.
+* `average(numbers)` — Calculates the average of a collection of numbers.
+* `clamp(variable, top, bottom)` — Keeps a value between two limits.
+* `WaitUntil(boolean, max_frames)` — Waits until a condition becomes true.
+* `TimeLenFunc(func, *input)` — Measures how long a function takes to run.
+* `attempt(func, *inputs, times)` — Attempts to run a function multiple times.
+
+### Save System
+
+* `Save(variable, name)` — Saves a variable.
+* `SaveReset()` — Resets saved data.
+* `SaveReturn(name)` — Returns a saved value.
+* `DeleteSave(name)` — Deletes a saved value.
+* `SaveChange(variable, name)` — Changes an existing saved value.
+* `Exists(name)` — Checks whether a saved value exists.
+* `ReturnSaved()` — Returns all saved data.
+
+### Random Utilities
+
+* `RandomString(length)` — Generates a random string.
+* `RandomChoice(choices, amount=1)` — Selects one or more unique random choices.
+* `WeightedRandom(options, values)` — Makes a weighted random selection.
+* `PasswordGenerator(length)` — Generates a secure random password.
+
+### Files and Data
+
+* `FileExists(file)` — Checks whether a file exists.
+* `load(file)` — Loads supported files.
+
+### Terminal Utilities
+
+* `DrawProgressBar(percent)` — Draws a terminal progress bar.
+* `UpdateProgressBar(percent)` — Updates the progress bar.
+* `DrawLoadingSpinner()` — Draws a loading spinner.
+* `UpdateLoadingSpinner(rotation)` — Updates the loading spinner.
+* `StartCountdown(seconds)` — Starts a terminal countdown.
+* `UpdateCountdown(time)` — Updates a countdown.
+* `SlowWrite(text, speed=0.5)` — Prints text gradually, like a typewriter.
+
+### Text and Encryption
+
+* `CaesarEncrypt(text, shift)` — Encrypts text using a Caesar cipher.
+* `CaesarDecrypt(text, shift)` — Decrypts Caesar cipher text.
+* `IsPalindrome(text)` — Checks whether text reads the same forwards and backwards.
+
+### Other Utilities
+
+* `FormatTime(seconds)` — Converts seconds into a readable time format.
+* `RemoveDuplicates(list)` — Removes duplicate items from a list.
+* `PlanetInfo(planet, info=False)` — Returns information about a planet.
+* `DistanceTranslate(amount, from_unit, to_unit)` — Converts between supported distance units.
+
+## Examples
+
+### Generate a password
+
+```python
+from ExtraFunctions import PasswordGenerator
+
+password = PasswordGenerator(20)
+
+print(password)
+```
+
+### Create a progress bar
+
+```python
+from ExtraFunctions import DrawProgressBar, UpdateProgressBar
+import time
+
+DrawProgressBar(0)
+
+for i in range(101):
+    UpdateProgressBar(i)
+    time.sleep(0.05)
+
+print()
+```
+
+### Slowly print text
+
+```python
+from ExtraFunctions import SlowWrite
+
+SlowWrite("Hello, World!", 0.1)
+```
+
+### Random choices
+
+```python
+from ExtraFunctions import RandomChoice
+
+planets = ["Mercury", "Venus", "Earth", "Mars"]
+
+print(RandomChoice(planets, 2))
+```
+
+## Errors
+
+ExtraFunctions includes several custom errors:
+
+* `UknownFormatError`
+* `SaveError`
+* `InfiniteError`
+* `NonexistentPlanetError`
+
+## Notes
+
+ExtraFunctions is an independent Python project that is continually being expanded with new functions and utilities.
+
+More features may be added in future updates.s

extrafunctions-0.1.7/pyproject.toml

@@ -0,0 +1,13 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ExtraFunctions"
+version = "0.1.7"
+description = "A collection of useful Python utility functions."
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    "Pillow==10"
+]

extrafunctions-0.1.5/ExtraFunctions.egg-info/PKG-INFO

@@ -1,6 +0,0 @@
-Metadata-Version: 2.4
-Name: ExtraFunctions
-Version: 0.1.5
-Summary: A collection of useful Python utility functions. - 0.1.3 Adds a bug fix on save.
-Requires-Python: >=3.8
-Requires-Dist: Pillow==11.1.0

extrafunctions-0.1.5/ExtraFunctions.egg-info/requires.txt

@@ -1 +0,0 @@
-Pillow==11.1.0

extrafunctions-0.1.5/PKG-INFO

@@ -1,6 +0,0 @@
-Metadata-Version: 2.4
-Name: ExtraFunctions
-Version: 0.1.5
-Summary: A collection of useful Python utility functions. - 0.1.3 Adds a bug fix on save.
-Requires-Python: >=3.8
-Requires-Dist: Pillow==11.1.0

extrafunctions-0.1.5/README.md

@@ -1 +0,0 @@
-#DONT README

extrafunctions-0.1.5/pyproject.toml

@@ -1,15 +0,0 @@
-[build-system]
-requires = ["setuptools>=61"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "ExtraFunctions"
-version = "0.1.5"
-description = "A collection of useful Python utility functions. - 0.1.3 Adds a bug fix on save."
-requires-python = ">=3.8"
-dependencies = [
-    "Pillow==11.1.0"
-]
-
-[tool.setuptools.packages.find]
-where = ["."]