quicktools-atom 0.1.1__py3-none-any.whl

quicktools/__init__.py

@@ -0,0 +1,3 @@
+"""quicktools: a small toolkit with math and string utilities."""
+
+__version__ = "0.1.0"

quicktools/cli.py

@@ -0,0 +1,36 @@
+"""Command-line interface for quicktools."""
+import argparse
+from quicktools import mathtools, strtools
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(prog="quicktools", description="Quick math and text utilities.")
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    p_prime = subparsers.add_parser("is-prime", help="Check if a number is prime")
+    p_prime.add_argument("number", type=int)
+
+    p_stats = subparsers.add_parser("stats", help="Compute mean/median/stdev of numbers")
+    p_stats.add_argument("numbers", type=float, nargs="+")
+
+    p_slug = subparsers.add_parser("slugify", help="Convert text into a url-friendly slug")
+    p_slug.add_argument("text")
+
+    p_palin = subparsers.add_parser("is-palindrome", help="Check if text is a palindrome")
+    p_palin.add_argument("text")
+
+    args = parser.parse_args()
+
+    if args.command == "is-prime":
+        print(f"{args.number} is prime: {mathtools.is_prime(args.number)}")
+    elif args.command == "stats":
+        nums = args.numbers
+        print(f"mean={mathtools.mean(nums):.4f} median={mathtools.median(nums):.4f} stdev={mathtools.std_dev(nums):.4f}")
+    elif args.command == "slugify":
+        print(strtools.slugify(args.text))
+    elif args.command == "is-palindrome":
+        print(strtools.is_palindrome(args.text))
+
+
+if __name__ == "__main__":
+    main()

quicktools/mathtools.py

@@ -0,0 +1,50 @@
+"""Math utilities: primes, number theory, and basic statistics."""
+import math
+
+
+def is_prime(n: int) -> bool:
+    """Return True if n is a prime number."""
+    if n < 2:
+        return False
+    for i in range(2, int(math.sqrt(n)) + 1):
+        if n % i == 0:
+            return False
+    return True
+
+
+def gcd(a: int, b: int) -> int:
+    """Greatest common divisor of a and b."""
+    return math.gcd(a, b)
+
+
+def lcm(a: int, b: int) -> int:
+    """Least common multiple of a and b."""
+    return abs(a * b) // math.gcd(a, b)
+
+
+def mean(numbers: list[float]) -> float:
+    """Arithmetic mean of a list of numbers."""
+    if not numbers:
+        raise ValueError("mean() requires at least one number")
+    return sum(numbers) / len(numbers)
+
+
+def median(numbers: list[float]) -> float:
+    """Median of a list of numbers."""
+    if not numbers:
+        raise ValueError("median() requires at least one number")
+    nums = sorted(numbers)
+    n = len(nums)
+    mid = n // 2
+    if n % 2 == 0:
+        return (nums[mid - 1] + nums[mid]) / 2
+    return nums[mid]
+
+
+def std_dev(numbers: list[float]) -> float:
+    """Population standard deviation of a list of numbers."""
+    if not numbers:
+        raise ValueError("std_dev() requires at least one number")
+    m = mean(numbers)
+    variance = sum((x - m) ** 2 for x in numbers) / len(numbers)
+    return math.sqrt(variance)

quicktools/strtools.py

@@ -0,0 +1,41 @@
+"""String utilities: text checks, transforms, and simple ciphers."""
+import re
+
+
+def is_palindrome(text: str) -> bool:
+    """Return True if text reads the same forwards and backwards (ignoring case/spaces)."""
+    cleaned = re.sub(r"[^a-zA-Z0-9]", "", text).lower()
+    return cleaned == cleaned[::-1]
+
+
+def slugify(text: str) -> str:
+    """Convert text into a url-friendly slug, e.g. 'Hello World!' -> 'hello-world'."""
+    text = text.lower().strip()
+    text = re.sub(r"[^a-z0-9]+", "-", text)
+    return text.strip("-")
+
+
+def word_frequency(text: str) -> dict[str, int]:
+    """Count occurrences of each word in text (case-insensitive)."""
+    words = re.findall(r"[a-zA-Z']+", text.lower())
+    freq: dict[str, int] = {}
+    for w in words:
+        freq[w] = freq.get(w, 0) + 1
+    return freq
+
+
+def caesar_cipher(text: str, shift: int) -> str:
+    """Shift each letter in text by `shift` positions (Caesar cipher). Negative shift decodes."""
+    result = []
+    for ch in text:
+        if ch.isalpha():
+            base = ord('A') if ch.isupper() else ord('a')
+            result.append(chr((ord(ch) - base + shift) % 26 + base))
+        else:
+            result.append(ch)
+    return "".join(result)
+
+
+def reverse_words(text: str) -> str:
+    """Reverse the order of words in a sentence."""
+    return " ".join(text.split()[::-1])

quicktools_atom-0.1.1.dist-info/METADATA

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: quicktools-atom
+Version: 0.1.1
+Summary: Math and string utilities with a bundled CLI
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+\# quicktools
+
+
+
+A small toolkit with math and string utilities, plus a bundled CLI.
+
+
+
+\## Install
+
+
+
+    pip install quicktools-atom
+
+
+
+\## Usage
+
+
+
+    from quicktools import mathtools, strtools
+
+
+
+    mathtools.is\_prime(97)
+
+    strtools.slugify("Hello World")
+
+
+
+\## CLI
+
+
+
+    quicktools is-prime 97
+
+    quicktools stats 1 2 3 4 5
+
+    quicktools slugify "Hello World"
+

quicktools_atom-0.1.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+quicktools/__init__.py,sha256=PQokgdYhG5o-RDpKnFb1XP8uABgWY08dl60ns7XF2BE,90
+quicktools/cli.py,sha256=YErG025DnvXsbanhAVjoZjDfk7Ld-7aIIFCl3fJmkZM,1399
+quicktools/mathtools.py,sha256=-Y4-AjEVm02sZm-YZEZn1Mfewhm8Ydspyw2zzfAjNb8,1420
+quicktools/strtools.py,sha256=X7bL94JHUi64Tqn6uw0TOhGd8mojEjSKuZs_v7E3g64,1379
+quicktools_atom-0.1.1.dist-info/METADATA,sha256=HTjLIHs84SiwA6gamVQd51Fm8PvUV1EEHwNYXCcJGyM,637
+quicktools_atom-0.1.1.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+quicktools_atom-0.1.1.dist-info/entry_points.txt,sha256=4UbXWWnZ4fyJbLuv0LF6TgI6b5xmZAY8pt5ApYVw6nM,51
+quicktools_atom-0.1.1.dist-info/top_level.txt,sha256=T-poQmFZxSoiRJtukhHFde7Iz2CVNE0I5d42k5M5AkE,11
+quicktools_atom-0.1.1.dist-info/RECORD,,

quicktools_atom-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

quicktools_atom-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+quicktools = quicktools.cli:main

quicktools_atom-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+quicktools