snackutils 0.1.2__tar.gz → 0.1.6__tar.gz

{snackutils-0.1.2 → snackutils-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: snackutils
-Version: 0.1.2
+Version: 0.1.6
 Summary: Tiny, dependency-free utilities that might save you a few lines.
 Project-URL: Homepage, https://github.com/techrul/snackutils
 Author: Techrul
@@ -34,6 +34,14 @@ Want a utility? Suggest it in [issues](https://github.com/techrul/snackutils/iss
 | `detect_os()` | Returns your OS name, like `"Windows"`, `"MacOS"`, or `"Linux"` |
 | `average(a, b)` / `mean(a, b)` | Average of two numbers |
 | `average_list(numbers)` / `mean_list(numbers)` | Average of a list of numbers |
+| `percent_choose(a,b)` | Chooses 1(a) or 2(b) using the percent given (a and b). Goes up to a float of one decimal (rounds if not) and a and b has to add to 100 or it doesn't work properly |
+| `better_sleep(a, b)` | Sleep but you can use units (seconds, minutes, hours, days)|
+| `ai_detector(text)` | Detects if text was made with AI with 100% accuracy (checks if there's em dashes)|
+| `lazy_randint(num)` | Gives you a random integer from 1 to num, saves you like 1 key press and all the control|
+| `unhelpful_friend(question)` | Your friend gives you unhelpful answers. Input is optional as it doesn't do anything|
+| `strip_punctuation(text)` | Removes all punctuation from inputted text|
+
+
 
 ## Requests
 
@@ -41,4 +49,4 @@ Bug? Issue? Feature request? Submit it in [issues](https://github.com/techrul/sn
 
 ## License
 
-MIT
+[MIT](https://github.com/Techrul/snackutils/blob/main/LICENSE)

{snackutils-0.1.2 → snackutils-0.1.6}/README.md

@@ -20,6 +20,14 @@ Want a utility? Suggest it in [issues](https://github.com/techrul/snackutils/iss
 | `detect_os()` | Returns your OS name, like `"Windows"`, `"MacOS"`, or `"Linux"` |
 | `average(a, b)` / `mean(a, b)` | Average of two numbers |
 | `average_list(numbers)` / `mean_list(numbers)` | Average of a list of numbers |
+| `percent_choose(a,b)` | Chooses 1(a) or 2(b) using the percent given (a and b). Goes up to a float of one decimal (rounds if not) and a and b has to add to 100 or it doesn't work properly |
+| `better_sleep(a, b)` | Sleep but you can use units (seconds, minutes, hours, days)|
+| `ai_detector(text)` | Detects if text was made with AI with 100% accuracy (checks if there's em dashes)|
+| `lazy_randint(num)` | Gives you a random integer from 1 to num, saves you like 1 key press and all the control|
+| `unhelpful_friend(question)` | Your friend gives you unhelpful answers. Input is optional as it doesn't do anything|
+| `strip_punctuation(text)` | Removes all punctuation from inputted text|
+
+
 
 ## Requests
 
@@ -27,4 +35,4 @@ Bug? Issue? Feature request? Submit it in [issues](https://github.com/techrul/sn
 
 ## License
 
-MIT
+[MIT](https://github.com/Techrul/snackutils/blob/main/LICENSE)

{snackutils-0.1.2 → snackutils-0.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "snackutils"
-version = "0.1.2"
+version = "0.1.6"
 description = "Tiny, dependency-free utilities that might save you a few lines."
 readme = "README.md"
 requires-python = ">=3.9"

snackutils-0.1.6/src/snackutils/utils.py

@@ -0,0 +1,177 @@
+#== Import Stuff ==
+import random
+import sys
+import time
+
+#== State functions ==
+# not in chronogical or alphabetical order
+__all__ = ["strip_punctuation", "unhelpful_friend", "eight_ball", "flip_coin", "roll_dice", "detect_os", "average", "mean", "average_list", "mean_list","percent_choose", "better_sleep", "ai_detector", "lazy_randint"]
+
+#== Functions ==
+
+_EIGHT_BALL_ANSWERS = [
+    "It is certain",
+    "It is decidedly so",
+    "Without a doubt",
+    "Yes definitely",
+    "You may rely on it",
+    "As I see it, yes",
+    "Most likely",
+    "Outlook good",
+    "Yes",
+    "Signs point to yes",
+    "Reply hazy, try again",
+    "Ask again later",
+    "Better not tell you now",
+    "Cannot predict now",
+    "Concentrate and ask again",
+    "Don't count on it",
+    "My reply is no",
+    "My sources say no",
+    "Outlook not so good",
+    "Very doubtful",
+]
+
+def eight_ball() -> str:
+    return random.choice(_ANSWERS)
+
+# --------------------------------------------------------------------------
+
+def flip_coin() -> str:
+    num = random.randint(1,2)
+    if num == 1:
+        return "Heads"
+    else:
+        return "Tails"
+
+# --------------------------------------------------------------------------
+
+def roll_dice() -> int:
+    return random.randint(1,6)
+
+# --------------------------------------------------------------------------
+
+def detect_os() -> str: # I made this as readable as possible in my opinion
+    name = sys.platform
+    if name == "win32":
+        return "Windows"
+    elif name == "darwin":
+        return "MacOS"
+    elif name == "ios":
+        return "iOS"
+    else:
+        return name.title()
+
+# --------------------------------------------------------------------------
+
+def average(num1: float, num2: float) -> float:
+    return sum([num1, num2]) / 2
+
+mean = average
+
+# --------------------------------------------------------------------------
+
+def average_list(numbers: list[float]) -> float:
+    return sum(numbers) / len(numbers)
+
+mean_list = average_list
+
+# --------------------------------------------------------------------------
+
+def percent_choose(a: float, b: float) -> int:# a and b are percentages for options 1 and 2; each is rounded to the
+
+    a_tenths = round(a * 10)                  # nearest tenth, must be between 0 and 100, and must add to 100.
+    b_tenths = round(b * 10)
+
+    if not (0 <= a_tenths <= 1000 and 0 <= b_tenths <= 1000):
+        raise ValueError("Percentages must be between 0 and 100")
+    if a_tenths + b_tenths != 1000:
+        raise ValueError("Percentages must add to exactly 100")
+
+    if random.randrange(1000) < a_tenths:
+        return 1
+    else:
+        return 2
+    
+# --------------------------------------------------------------------------
+
+_UNITS = {"second": 1, "minute": 60, "hour": 3600, "day": 86400}
+
+def better_sleep(value: float, units: str = "seconds") -> None:
+    unit = units.lower().removesuffix("s")
+    if unit not in _UNITS:
+        raise ValueError(f"Unknown unit: {units!r}. Use seconds, minutes, hours or days.")
+    time.sleep(value * _UNITS[unit])
+    
+# --------------------------------------------------------------------------
+
+def ai_detector(text: str) -> bool: #100% accuracy btw
+    return "—" in text
+
+# --------------------------------------------------------------------------
+
+def lazy_randint(num) -> int:
+    return random.randint(1, num)
+
+# --------------------------------------------------------------------------
+
+_FRIEND_ANSWERS = [
+    "Yes",
+    "No",
+    "Huh?",
+    "What?",
+    "I don't know",
+    "Google it",
+    "What do you mean?",
+    "Maybe",
+    "Nah",
+    "Yeah",
+    "Come again?",
+    "I beg your pardon?",
+    "Uhh",
+    "Umm",
+    "Ask someone else",
+    "I'm busy",
+    "*Has headphones on*",
+    "*Ghosts you*",
+    "Ask an eight ball",
+    "Go flip a coin",
+    "Who knows?",
+    "*Ignores you*",
+    "True",
+    "False",
+    "Sometimes",
+    "I don't think so",
+    "I think so",
+    "I'm not sure",
+    "I'm not positive",
+    "Why?",
+    "¿Puedes repetir, por favor?",
+    "Sí",
+    "*Scrolling TikTok*",
+    "*Sleeping*",
+    "Ask AI",
+    "..."
+]
+
+def unhelpful_friend(question: str = "") -> str: #The question doesn't matter it's only there for cosmetic purposes
+    return random.choice(_FRIEND_ANSWERS)
+
+# --------------------------------------------------------------------------
+
+_PUNCTUATION = [
+    ".", 
+    ",", 
+    "!", 
+    "?", 
+    "'", 
+    '"', 
+    "—"
+]
+
+def strip_punctuation(text: str) -> str:
+    stripped = ""
+    for ch in text:
+        if ch not in _PUNCTUATION:
+            stripped += ch
+    return stripped

snackutils-0.1.2/src/snackutils/utils.py

@@ -1,75 +0,0 @@
-#== Import Stuff ==
-import random
-import sys
-
-#== State functions ==
-__all__ = ["eight_ball", "flip_coin", "roll_dice", "detect_os", "average", "mean", "average_list", "mean_list"]
-
-#== Functions ==
-
-_ANSWERS = [
-    "It is certain",
-    "It is decidedly so",
-    "Without a doubt",
-    "Yes definitely",
-    "You may rely on it",
-    "As I see it, yes",
-    "Most likely",
-    "Outlook good",
-    "Yes",
-    "Signs point to yes",
-    "Reply hazy, try again",
-    "Ask again later",
-    "Better not tell you now",
-    "Cannot predict now",
-    "Concentrate and ask again",
-    "Don't count on it",
-    "My reply is no",
-    "My sources say no",
-    "Outlook not so good",
-    "Very doubtful",
-]
-
-def eight_ball() -> str:
-    return random.choice(_ANSWERS)
-
-# --------------------------------------------------------------------------
-
-def flip_coin() -> str:
-    num = random.randint(1,2)
-    if num == 1:
-        return "Heads"
-    else:
-        return "Tails"
-
-# --------------------------------------------------------------------------
-
-def roll_dice() -> int:
-    return random.randint(1,6)
-
-# --------------------------------------------------------------------------
-
-def detect_os() -> str: #I made this as readable as possible in my opinion
-    name = sys.platform
-    if name == "win32":
-        return "Windows"
-    elif name == "darwin":
-        return "MacOS"
-    elif name == "ios":
-        return "iOS"
-    else:
-        return name.title()
-
-# --------------------------------------------------------------------------
-
-def average(num1: float, num2: float) -> float:
-    return sum([num1, num2]) / 2
-
-mean = average
-
-# --------------------------------------------------------------------------
-
-def average_list(numbers: list[float]) -> float:
-    return sum(numbers) / len(numbers)
-
-mean_list = average_list