pyutils-extended 0.1.0__py3-none-any.whl

pyutils_extended/__init__.py

@@ -0,0 +1,3 @@
+"""pyutils_extended — a small collection of handy utility functions."""
+from .utils import slugify, pluralize, humanize_bytes
+__version__ = "0.1.0"

pyutils_extended/setup.py

@@ -0,0 +1,13 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="pyutils-extended",
+    version="0.1.0",
+    packages=find_packages(),
+    description="A small collection of handy utility functions.",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    author="Revenue Worker",
+    license="MIT",
+    python_requires=">=3.8",
+)

pyutils_extended/tests/test_utils.py

@@ -0,0 +1,21 @@
+"""Unit tests for pyutils_extended.utils."""
+from pyutils_extended.utils import slugify, pluralize, humanize_bytes
+
+
+def test_slugify():
+    assert slugify("Hello World!") == "hello-world"
+    assert slugify("Multiple   Spaces") == "multiple-spaces"
+    assert slugify("Special!@#$%^&*()") == "special"
+
+
+def test_pluralize():
+    assert pluralize("apple", 1) == "apple"
+    assert pluralize("apple", 5) == "apples"
+    assert pluralize("bus", 2) == "buses"
+    assert pluralize("day", 3) == "days"
+
+
+def test_humanize_bytes():
+    assert humanize_bytes(1000) == "1.0 KiB"
+    assert humanize_bytes(1500) == "1.5 KiB"
+    assert humanize_bytes(0) == "0.0 B"

pyutils_extended/utils.py

@@ -0,0 +1,38 @@
+"""String helpers, pluralization, and size formatting."""
+import re
+import math
+
+def slugify(text: str) -> str:
+    """Convert arbitrary text to a URL-safe slug."""
+    text = text.lower().strip()
+    text = re.sub(r'[^a-z0-9]+', '-', text)
+    return re.sub(r'-+', '-', text).strip('-')
+
+def pluralize(word: str, count: int) -> str:
+    """Return plural form. Singular form is used only when count == 1."""
+    if count == 1:
+        return word
+    # Simple English pluralization
+    if word.endswith(('s', 'x', 'z', 'sh', 'ch')):
+        return word + 'es'
+    # y preceded by consonant → -ies (fly→flies)
+    # y preceded by vowel → -s (day→days, key→keys)
+    if word.endswith('y') and len(word) > 1:
+        if word[-2] not in 'aeiou':
+            return word[:-1] + 'ies'
+    return word + 's'
+
+def humanize_bytes(size: int, binary: bool = False) -> str:
+    """Format bytes as human-readable string.
+    
+    Args:
+        size: Number of bytes.
+        binary: If True, use 1024 base (KiB/MiB); else 1000.
+    """
+    base = 1024 if binary else 1000
+    units = ['B', 'KiB', 'MiB', 'GiB', 'TiB']
+    for unit in units:
+        if abs(size) < base:
+            return f"{size:.1f} {unit}"
+        size /= base
+    return f"{size:.1f} PiB"

pyutils_extended-0.1.0.dist-info/METADATA

@@ -0,0 +1,24 @@
+Metadata-Version: 2.1
+Name: pyutils-extended
+Version: 0.1.0
+Summary: A small collection of handy utility functions.
+Author: Revenue Worker
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# pyutils-extended
+
+A small collection of handy utility functions.
+
+## Installation
+
+```bash
+pip install pyutils-extended
+```
+
+## Usage
+
+```python
+from pyutils_extended import slugify, pluralize, humanize_bytes
+```

pyutils_extended-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+pyutils_extended/__init__.py,sha256=3BexNer4DBSQ6SKMBZe2YUWGYXFslyKm7nCv9Ce0z6o,150
+pyutils_extended/setup.py,sha256=-oTEtPGpPwAdhG2kEesLmjPbLeqB6zimZ5pJsdEOYlY,375
+pyutils_extended/utils.py,sha256=joyybVo6R7YmEEEXfCKYnweMU64MUh6U12JF08dNbaQ,1257
+pyutils_extended/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pyutils_extended/tests/test_utils.py,sha256=iYTLS3CShLztj9PE-3moIBYgtUJV-KVzKf8vH1a0TJo,658
+pyutils_extended-0.1.0.dist-info/METADATA,sha256=2vWMWZ_LclbJVyKpXgtJ44CFQ5EfLb_vjB11S7c_Mlk,431
+pyutils_extended-0.1.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+pyutils_extended-0.1.0.dist-info/top_level.txt,sha256=Dqe0ypfozbEzDz21o7BDTnKorVTLeIrTw2OFvCpn9pY,17
+pyutils_extended-0.1.0.dist-info/RECORD,,

pyutils_extended-0.1.0.dist-info/WHEEL

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

pyutils_extended-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pyutils_extended