snackutils 0.1.0__py3-none-any.whl

snackutils/__init__.py

@@ -0,0 +1 @@
+from .utils import *

snackutils/utils.py

@@ -0,0 +1,73 @@
+#== 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"
+    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(list)
+
+mean_list = average_list

snackutils-0.1.0.dist-info/METADATA

@@ -0,0 +1,42 @@
+Metadata-Version: 2.5
+Name: snackutils
+Version: 0.1.0
+Summary: Tiny, dependency-free utilities that might save you a few lines.
+Project-URL: Homepage, https://github.com/techrul/snackutils
+Author: Techrul
+License-Expression: MIT
+License-File: LICENSE
+Keywords: 8ball,helpers,os,tiny,utilities
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# Snackutils
+
+Tiny utilities that could save you a few lines
+## Install
+
+```bash
+pip install snackutils
+```
+
+## Utilities
+Want a utility? Suggest it in [issues](https://github.com/techrul/snackutils/issues)!
+
+| Function | What it does |
+| --- | --- |
+| `eight_ball()` | Returns a random magic 8-ball answer |
+| `flip_coin()` | Returns `"Heads"` or `"Tails"` |
+| `roll_dice()` | Rolls a six-sided die, returns 1 to 6 |
+| `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 |
+
+## Requests
+
+Bug? Issue? Feature request? Submit it in [issues](https://github.com/techrul/snackutils/issues)!
+
+## License
+
+MIT

snackutils-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+snackutils/__init__.py,sha256=pG-YPVG0gJIJ6s4xcAz9S_CnUxpUcz33wl9eNUSgxGk,20
+snackutils/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+snackutils/utils.py,sha256=x7QEFL9dm8EgKuRirZ-qyZhRI4CRofg54rd4djq9qqY,1776
+snackutils-0.1.0.dist-info/METADATA,sha256=YLJ5gcXFWuIap6L3dqN5OsNUVchJL-3CFgGGRsg4i50,1224
+snackutils-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+snackutils-0.1.0.dist-info/licenses/LICENSE,sha256=0PbPAII4VYrABiK0ErYZLRc57dmRw3NSJ5_XybpDxYo,1064
+snackutils-0.1.0.dist-info/RECORD,,

snackutils-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

snackutils-0.1.0.dist-info/licenses/LICENSE

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