pyutils-extended 0.1.0__tar.gz

pyutils-extended-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,15 @@
+# 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/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-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-0.1.0/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-0.1.0/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/pyutils_extended.egg-info/PKG-INFO

@@ -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/pyutils_extended.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+setup.py
+pyutils_extended/__init__.py
+pyutils_extended/setup.py
+pyutils_extended/utils.py
+pyutils_extended.egg-info/PKG-INFO
+pyutils_extended.egg-info/SOURCES.txt
+pyutils_extended.egg-info/dependency_links.txt
+pyutils_extended.egg-info/top_level.txt
+pyutils_extended/tests/__init__.py
+pyutils_extended/tests/test_utils.py

pyutils-extended-0.1.0/pyutils_extended.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pyutils-extended-0.1.0/pyutils_extended.egg-info/top_level.txt

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

pyutils-extended-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pyutils-extended-0.1.0/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",
+)