textutils-hs 0.1.0__tar.gz

textutils_hs-0.1.0/LICENSE

@@ -0,0 +1,8 @@
+MIT License
+
+Copyright (c) 2026 Hamza Fikri
+
+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. See the full MIT License text at
+https://opensource.org/license/mit.

textutils_hs-0.1.0/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: textutils-hs
+Version: 0.1.0
+Summary: Small, dependency-free helpers for common text tasks.
+Author: Hamza Fikri
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/hamzasinko/textutils
+Project-URL: Repository, https://github.com/hamzasinko/textutils
+Project-URL: Issues, https://github.com/hamzasinko/textutils/issues
+Project-URL: Changelog, https://github.com/hamzasinko/textutils/blob/main/CHANGELOG.md
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Text Processing
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: pre-commit>=3.7; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# textutils
+
+Small, dependency-free Python helpers for common text tasks: counting words,
+counting characters, reversing a string, and capitalizing each word. Every
+function has type hints, a full docstring, and tests.
+
+## Features
+
+- `word_count(text)` — number of words in a string.
+- `character_count(text)` — number of characters in a string.
+- `reverse(text)` — the string reversed.
+- `capitalize_words(text)` — first letter of each word capitalized.
+- `slugify(text)` — a URL-friendly slug (lowercase, hyphen-separated).
+
+Edge cases are handled: empty strings return empty results, and non-string
+input raises `TypeError`.
+
+## Installation
+
+Requires Python 3.9 or newer. No third-party runtime dependencies.
+
+Clone and install in editable mode with the development tools:
+
+```bash
+git clone https://github.com/hamzasinko/textutils.git
+cd textutils
+python -m pip install -e ".[dev]"
+```
+
+Run the tests:
+
+```bash
+python -m pytest
+```
+
+## Usage
+
+```python
+from textutils import word_count, character_count, reverse, capitalize_words, slugify
+
+word_count("hello world") # 2
+character_count("hello")          # 5
+reverse("stressed")              # "desserts"
+capitalize_words("hello world")   # "Hello World"
+slugify("Hello, World!")          # "hello-world"
+```
+
+## Contributing
+
+Contributions are welcome.
+
+1. Fork the repository on GitHub.
+2. Create a branch: `git checkout -b feature/my-change`.
+3. Make your change, keeping commits small and focused.
+4. Run the tests: `python -m pytest`.
+5. Push your branch and open a pull request.
+
+## License
+
+Released under the MIT License. See [LICENSE](LICENSE) for details.

textutils_hs-0.1.0/README.md

@@ -0,0 +1,60 @@
+# textutils
+
+Small, dependency-free Python helpers for common text tasks: counting words,
+counting characters, reversing a string, and capitalizing each word. Every
+function has type hints, a full docstring, and tests.
+
+## Features
+
+- `word_count(text)` — number of words in a string.
+- `character_count(text)` — number of characters in a string.
+- `reverse(text)` — the string reversed.
+- `capitalize_words(text)` — first letter of each word capitalized.
+- `slugify(text)` — a URL-friendly slug (lowercase, hyphen-separated).
+
+Edge cases are handled: empty strings return empty results, and non-string
+input raises `TypeError`.
+
+## Installation
+
+Requires Python 3.9 or newer. No third-party runtime dependencies.
+
+Clone and install in editable mode with the development tools:
+
+```bash
+git clone https://github.com/hamzasinko/textutils.git
+cd textutils
+python -m pip install -e ".[dev]"
+```
+
+Run the tests:
+
+```bash
+python -m pytest
+```
+
+## Usage
+
+```python
+from textutils import word_count, character_count, reverse, capitalize_words, slugify
+
+word_count("hello world") # 2
+character_count("hello")          # 5
+reverse("stressed")              # "desserts"
+capitalize_words("hello world")   # "Hello World"
+slugify("Hello, World!")          # "hello-world"
+```
+
+## Contributing
+
+Contributions are welcome.
+
+1. Fork the repository on GitHub.
+2. Create a branch: `git checkout -b feature/my-change`.
+3. Make your change, keeping commits small and focused.
+4. Run the tests: `python -m pytest`.
+5. Push your branch and open a pull request.
+
+## License
+
+Released under the MIT License. See [LICENSE](LICENSE) for details.

textutils_hs-0.1.0/pyproject.toml

@@ -0,0 +1,75 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "textutils-hs"
+version = "0.1.0"
+description = "Small, dependency-free helpers for common text tasks."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+authors = [
+    { name = "Hamza Fikri" },
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Text Processing",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "black>=24.0",
+    "ruff>=0.5",
+    "pre-commit>=3.7",
+    "build>=1.2",
+    "twine>=5.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/hamzasinko/textutils"
+Repository = "https://github.com/hamzasinko/textutils"
+Issues = "https://github.com/hamzasinko/textutils/issues"
+Changelog = "https://github.com/hamzasinko/textutils/blob/main/CHANGELOG.md"
+
+[tool.setuptools.packages.find]
+include = ["textutils*"]
+
+[tool.pytest.ini_options]
+addopts = [
+    "--cov=textutils",
+    "--cov-report=term-missing",
+]
+testpaths = ["tests"]
+
+[tool.black]
+line-length = 88
+target-version = ["py39"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "B", "UP", "D"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "numpy"
+
+[tool.coverage.run]
+source = ["textutils"]
+
+[tool.coverage.report]
+show_missing = true

textutils_hs-0.1.0/setup.cfg

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

textutils_hs-0.1.0/tests/test_counting.py

@@ -0,0 +1,49 @@
+"""Tests for textutils.counting."""
+
+import pytest
+
+from textutils import character_count, word_count
+
+# --- word_count -------------------------------------------------------------
+
+WORD_COUNT_CASES = [
+    pytest.param("hello world", 2, id="counts-two-words"),
+    pytest.param("one two three", 3, id="counts-three-words"),
+    pytest.param("hello", 1, id="single-word"),
+    pytest.param("", 0, id="empty-string"),
+    pytest.param("   \t\n ", 0, id="whitespace-only"),
+    pytest.param("  a   b  c ", 3, id="ignores-multiple-spaces"),
+    pytest.param("a\tb\nc\r\nd", 4, id="tabs-and-newlines-separate-words"),
+    pytest.param("  hi  ", 1, id="ignores-leading-trailing-whitespace"),
+    pytest.param("!!!", 1, id="punctuation-only-is-one-token"),
+    pytest.param("héllo wörld", 2, id="unicode-words"),
+    pytest.param("Hello WORLD", 2, id="mixed-case"),
+    pytest.param("word " * 10_000, 10_000, id="very-long-input"),
+]
+
+
+@pytest.mark.parametrize("text, expected", WORD_COUNT_CASES)
+def test_word_count(text: str, expected: int) -> None:
+    """Return the number of whitespace-separated words."""
+    assert word_count(text) == expected
+
+
+# --- character_count --------------------------------------------------------
+
+CHARACTER_COUNT_CASES = [
+    pytest.param("hello", 5, id="ascii"),
+    pytest.param("hi there", 8, id="counts-spaces"),
+    pytest.param("", 0, id="empty-string"),
+    pytest.param(" \t\n", 3, id="whitespace-only"),
+    pytest.param("a\tb\n", 4, id="counts-tabs-and-newlines"),
+    pytest.param("héllo", 5, id="unicode-code-points"),
+    pytest.param("👍", 1, id="emoji-single-code-point"),
+    pytest.param("e\u0301", 2, id="combining-mark-counts-twice"),
+    pytest.param("a" * 100_000, 100_000, id="very-long-input"),
+]
+
+
+@pytest.mark.parametrize("text, expected", CHARACTER_COUNT_CASES)
+def test_character_count(text: str, expected: int) -> None:
+    """Return the number of characters."""
+    assert character_count(text) == expected

textutils_hs-0.1.0/tests/test_public_api.py

@@ -0,0 +1,62 @@
+"""Tests for the public textutils API surface."""
+
+import pytest
+
+import textutils
+from textutils import (
+    capitalize_words,
+    character_count,
+    reverse,
+    slugify,
+    word_count,
+)
+
+ALL_FUNCTIONS = (word_count, character_count, reverse, capitalize_words, slugify)
+
+EXPECTED_ALL = [
+    "capitalize_words",
+    "character_count",
+    "reverse",
+    "slugify",
+    "word_count",
+]
+
+
+def test_all_lists_the_public_api() -> None:
+    """Check that __all__ lists exactly the public API."""
+    assert textutils.__all__ == EXPECTED_ALL
+
+
+@pytest.mark.parametrize("name", EXPECTED_ALL)
+def test_public_names_are_importable(name: str) -> None:
+    """Check that every name in __all__ is importable."""
+    assert hasattr(textutils, name)
+
+
+@pytest.mark.parametrize("function", ALL_FUNCTIONS, ids=lambda f: f.__name__)
+@pytest.mark.parametrize(
+    "value, type_name",
+    [
+        pytest.param(None, "NoneType", id="none"),
+        pytest.param(42, "int", id="int"),
+        pytest.param(3.14, "float", id="float"),
+        pytest.param(["a"], "list", id="list"),
+        pytest.param({"k": "v"}, "dict", id="dict"),
+        pytest.param(b"bytes", "bytes", id="bytes"),
+    ],
+)
+def test_non_string_input_raises_type_error(
+    function: object, value: object, type_name: str
+) -> None:
+    """Every public function rejects non-string input with a helpful message."""
+    with pytest.raises(TypeError, match=f"must be str, not {type_name}"):
+        function(value)
+
+
+def test_accepts_str_subclass() -> None:
+    """Check that public functions accept a str subclass."""
+
+    class MyStr(str):
+        pass
+
+    assert word_count(MyStr("hello world")) == 2

textutils_hs-0.1.0/tests/test_transform.py

@@ -0,0 +1,88 @@
+"""Tests for textutils.transform."""
+
+import pytest
+
+from textutils import capitalize_words, reverse, slugify
+
+# --- reverse ----------------------------------------------------------------
+
+REVERSE_CASES = [
+    pytest.param("stressed", "desserts", id="reverses-word"),
+    pytest.param("ab c", "c ba", id="reverses-sentence"),
+    pytest.param("AbC", "CbA", id="mixed-case"),
+    pytest.param("", "", id="empty-string"),
+    pytest.param("a", "a", id="single-character"),
+    pytest.param("racecar", "racecar", id="palindrome-unchanged"),
+    pytest.param("a\tb\n", "\nb\ta", id="reverses-tabs-and-newlines"),
+    pytest.param("héllo", "olléh", id="unicode"),
+    pytest.param("a\u0301b", "b\u0301a", id="combining-mark-order-flips"),
+    pytest.param("abc" * 20_000, ("abc" * 20_000)[::-1], id="very-long-input"),
+]
+
+
+@pytest.mark.parametrize("text, expected", REVERSE_CASES)
+def test_reverse(text: str, expected: str) -> None:
+    """Return the characters in reverse order."""
+    assert reverse(text) == expected
+
+
+def test_reverse_does_not_mutate_input() -> None:
+    """Return a new string and leave the input unchanged."""
+    original = "abc"
+    reverse(original)
+    assert original == "abc"
+
+
+# --- capitalize_words -------------------------------------------------------
+
+CAPITALIZE_WORDS_CASES = [
+    pytest.param("hello world", "Hello World", id="capitalizes-each-word"),
+    pytest.param("hello WORLD", "Hello WORLD", id="leaves-rest-unchanged"),
+    pytest.param("it's fine", "It's Fine", id="does-not-break-apostrophes"),
+    pytest.param("a\tb", "A\tB", id="tab-is-a-separator"),
+    pytest.param("", "", id="empty-string"),
+    pytest.param(
+        "  hello  world\nagain", "  Hello  World\nAgain", id="preserves-whitespace"
+    ),
+    pytest.param("Hello World", "Hello World", id="already-capitalized"),
+    pytest.param("héllo wörld", "Héllo Wörld", id="unicode-word-start"),
+    pytest.param("123 abc", "123 Abc", id="leading-digits"),
+    pytest.param("!!!", "!!!", id="punctuation-only"),
+    pytest.param("(hello)", "(hello)", id="not-after-whitespace"),
+    pytest.param("well-known", "Well-known", id="hyphen-not-a-separator"),
+]
+
+
+@pytest.mark.parametrize("text, expected", CAPITALIZE_WORDS_CASES)
+def test_capitalize_words(text: str, expected: str) -> None:
+    """Uppercase the first character of each word."""
+    assert capitalize_words(text) == expected
+
+
+# --- slugify ----------------------------------------------------------------
+
+SLUGIFY_CASES = [
+    pytest.param("Hello, World!", "hello-world", id="punctuation-to-hyphen"),
+    pytest.param(
+        "  Hello, World! Open Source  ",
+        "hello-world-open-source",
+        id="collapses-repeated-spaces",
+    ),
+    pytest.param("Python --- is fun", "python-is-fun", id="collapses-repeated-hyphens"),
+    pytest.param("Version 2.0 released", "version-2-0-released", id="keeps-digits"),
+    pytest.param("", "", id="empty-string"),
+    pytest.param("!!!", "", id="punctuation-only"),
+    pytest.param("café au lait", "caf-au-lait", id="strips-non-ascii"),
+    pytest.param("well-known", "well-known", id="keeps-existing-hyphen"),
+    pytest.param("foo_bar", "foo-bar", id="underscore-to-hyphen"),
+    pytest.param("HELLO", "hello", id="lowercases-input"),
+    pytest.param("a\tb\nc", "a-b-c", id="tabs-and-newlines"),
+    pytest.param("--Foo--", "foo", id="strips-leading-trailing-hyphens"),
+    pytest.param("a" * 100_000, "a" * 100_000, id="very-long-input"),
+]
+
+
+@pytest.mark.parametrize("text, expected", SLUGIFY_CASES)
+def test_slugify(text: str, expected: str) -> None:
+    """Return a lowercase, hyphen-separated slug."""
+    assert slugify(text) == expected

textutils_hs-0.1.0/tests/test_validation.py

@@ -0,0 +1,30 @@
+"""Tests for the private textutils._validation module."""
+
+import pytest
+
+from textutils._validation import _ensure_str
+
+
+@pytest.mark.parametrize(
+    "text", ["hello", "", " "], ids=["ascii", "empty", "whitespace"]
+)
+def test_ensure_str_accepts_strings(text: str) -> None:
+    """Return None for string input."""
+    assert _ensure_str(text) is None
+
+
+@pytest.mark.parametrize(
+    "value, type_name",
+    [
+        pytest.param(None, "NoneType", id="none"),
+        pytest.param(42, "int", id="int"),
+        pytest.param(3.14, "float", id="float"),
+        pytest.param(["a"], "list", id="list"),
+        pytest.param({"k": "v"}, "dict", id="dict"),
+        pytest.param(b"bytes", "bytes", id="bytes"),
+    ],
+)
+def test_ensure_str_rejects_non_strings(value: object, type_name: str) -> None:
+    """Raise TypeError naming the offending type."""
+    with pytest.raises(TypeError, match=f"must be str, not {type_name}"):
+        _ensure_str(value)

textutils_hs-0.1.0/textutils/__init__.py

@@ -0,0 +1,24 @@
+"""textutils: small, dependency-free helpers for common text tasks.
+
+Public API:
+    ``word_count``, ``character_count``, ``reverse``, ``capitalize_words``,
+    ``slugify``.
+
+Everything else (modules or names starting with ``_``) is internal and may
+change without notice.
+"""
+
+from importlib.metadata import version
+
+from .counting import character_count, word_count
+from .transform import capitalize_words, reverse, slugify
+
+__all__ = [
+    "capitalize_words",
+    "character_count",
+    "reverse",
+    "slugify",
+    "word_count",
+]
+
+__version__ = version("textutils-hs")

textutils_hs-0.1.0/textutils/_validation.py

@@ -0,0 +1,7 @@
+"""Private input-validation helpers for textutils."""
+
+
+def _ensure_str(text: object) -> None:
+    """Raise a ``TypeError`` if *text* is not a :class:`str`."""
+    if not isinstance(text, str):
+        raise TypeError(f"text must be str, not {type(text).__name__}")

textutils_hs-0.1.0/textutils/counting.py

@@ -0,0 +1,70 @@
+"""Word-counting helpers for textutils."""
+
+from ._validation import _ensure_str
+
+__all__ = ["word_count", "character_count"]
+
+
+def word_count(text: str) -> int:
+    """Count the words in *text*.
+
+    Words are separated by any amount of whitespace, so runs of spaces,
+    tabs, and newlines all act as a single separator.
+
+    Parameters
+    ----------
+    text : str
+        The string to count words in.
+
+    Returns
+    -------
+    int
+        The number of words in *text*. An empty string returns ``0``.
+
+    Raises
+    ------
+    TypeError
+        If *text* is not a :class:`str`.
+
+    Examples
+    --------
+    >>> word_count("hello world")
+    2
+    >>> word_count("  spaced   out  ")
+    2
+    >>> word_count("")
+    0
+    """
+    _ensure_str(text)
+    return len(text.split())
+
+
+def character_count(text: str) -> int:
+    """Count the characters in *text*, spaces included.
+
+    Parameters
+    ----------
+    text : str
+        The string to count characters in.
+
+    Returns
+    -------
+    int
+        The number of characters in *text*. An empty string returns ``0``.
+
+    Raises
+    ------
+    TypeError
+        If *text* is not a :class:`str`.
+
+    Examples
+    --------
+    >>> character_count("hello")
+    5
+    >>> character_count("hi there")
+    8
+    >>> character_count("")
+    0
+    """
+    _ensure_str(text)
+    return len(text)

textutils_hs-0.1.0/textutils/transform.py

@@ -0,0 +1,122 @@
+"""String-transforming helpers for textutils."""
+
+import re
+
+from ._validation import _ensure_str
+
+__all__ = ["reverse", "capitalize_words", "slugify"]
+
+_WORD_START = re.compile(r"(?<!\S)\w")
+
+
+def reverse(text: str) -> str:
+    """Return *text* with its characters in reverse order.
+
+    Parameters
+    ----------
+    text : str
+        The string to reverse.
+
+    Returns
+    -------
+    str
+        A new string holding the characters of *text* in reverse order. An
+        empty string returns an empty string.
+
+    Raises
+    ------
+    TypeError
+        If *text* is not a :class:`str`.
+
+    Examples
+    --------
+    >>> reverse("stressed")
+    'desserts'
+    >>> reverse("abc")
+    'cba'
+    >>> reverse("")
+    ''
+    """
+    _ensure_str(text)
+    return text[::-1]
+
+
+def capitalize_words(text: str) -> str:
+    """Uppercase the first character of every word in *text*.
+
+    Only the first character of each word is changed; the rest of each word
+    is left exactly as it was. Whitespace, including newlines, is preserved.
+
+    Parameters
+    ----------
+    text : str
+        The string to transform.
+
+    Returns
+    -------
+    str
+        A new string with the first character of each word uppercased. An
+        empty string returns an empty string.
+
+    Raises
+    ------
+    TypeError
+        If *text* is not a :class:`str`.
+
+    Examples
+    --------
+    >>> capitalize_words("hello world")
+    'Hello World'
+    >>> capitalize_words("hello WORLD")
+    'Hello WORLD'
+    >>> capitalize_words("it's fine")
+    "It's Fine"
+    >>> capitalize_words("")
+    ''
+    """
+    _ensure_str(text)
+    return _WORD_START.sub(lambda match: match.group(0).upper(), text)
+
+
+def slugify(text: str) -> str:
+    """Turn *text* into a URL-friendly slug.
+
+    The input is lowercased, every run of characters outside ``a-z0-9``
+    (spaces, punctuation, underscores, accents, ...) is replaced by a single
+    hyphen, and leading/trailing hyphens are removed. Existing hyphens are
+    kept as separators, so ``"well-known"`` stays ``"well-known"`` while
+    ``"foo_bar"`` becomes ``"foo-bar"``.
+
+    Parameters
+    ----------
+    text : str
+        The string to slugify.
+
+    Returns
+    -------
+    str
+        A slug containing only lowercase ASCII letters, digits, and internal
+        hyphens. An empty string, or a string with no letters/digits,
+        returns ``""``.
+
+    Raises
+    ------
+    TypeError
+        If *text* is not a :class:`str`.
+
+    Examples
+    --------
+    >>> slugify("Hello, World!")
+    'hello-world'
+    >>> slugify("  Hello, World! Open Source  ")
+    'hello-world-open-source'
+    >>> slugify("Python --- is fun")
+    'python-is-fun'
+    >>> slugify("Version 2.0 released")
+    'version-2-0-released'
+    >>> slugify("!!!")
+    ''
+    """
+    _ensure_str(text)
+    slug = re.sub(r"[^a-z0-9]+", "-", text.lower())
+    return slug.strip("-")

textutils_hs-0.1.0/textutils_hs.egg-info/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: textutils-hs
+Version: 0.1.0
+Summary: Small, dependency-free helpers for common text tasks.
+Author: Hamza Fikri
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/hamzasinko/textutils
+Project-URL: Repository, https://github.com/hamzasinko/textutils
+Project-URL: Issues, https://github.com/hamzasinko/textutils/issues
+Project-URL: Changelog, https://github.com/hamzasinko/textutils/blob/main/CHANGELOG.md
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Text Processing
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: pre-commit>=3.7; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# textutils
+
+Small, dependency-free Python helpers for common text tasks: counting words,
+counting characters, reversing a string, and capitalizing each word. Every
+function has type hints, a full docstring, and tests.
+
+## Features
+
+- `word_count(text)` — number of words in a string.
+- `character_count(text)` — number of characters in a string.
+- `reverse(text)` — the string reversed.
+- `capitalize_words(text)` — first letter of each word capitalized.
+- `slugify(text)` — a URL-friendly slug (lowercase, hyphen-separated).
+
+Edge cases are handled: empty strings return empty results, and non-string
+input raises `TypeError`.
+
+## Installation
+
+Requires Python 3.9 or newer. No third-party runtime dependencies.
+
+Clone and install in editable mode with the development tools:
+
+```bash
+git clone https://github.com/hamzasinko/textutils.git
+cd textutils
+python -m pip install -e ".[dev]"
+```
+
+Run the tests:
+
+```bash
+python -m pytest
+```
+
+## Usage
+
+```python
+from textutils import word_count, character_count, reverse, capitalize_words, slugify
+
+word_count("hello world") # 2
+character_count("hello")          # 5
+reverse("stressed")              # "desserts"
+capitalize_words("hello world")   # "Hello World"
+slugify("Hello, World!")          # "hello-world"
+```
+
+## Contributing
+
+Contributions are welcome.
+
+1. Fork the repository on GitHub.
+2. Create a branch: `git checkout -b feature/my-change`.
+3. Make your change, keeping commits small and focused.
+4. Run the tests: `python -m pytest`.
+5. Push your branch and open a pull request.
+
+## License
+
+Released under the MIT License. See [LICENSE](LICENSE) for details.

textutils_hs-0.1.0/textutils_hs.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+tests/test_counting.py
+tests/test_public_api.py
+tests/test_transform.py
+tests/test_validation.py
+textutils/__init__.py
+textutils/_validation.py
+textutils/counting.py
+textutils/transform.py
+textutils_hs.egg-info/PKG-INFO
+textutils_hs.egg-info/SOURCES.txt
+textutils_hs.egg-info/dependency_links.txt
+textutils_hs.egg-info/requires.txt
+textutils_hs.egg-info/top_level.txt

textutils_hs-0.1.0/textutils_hs.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

textutils_hs-0.1.0/textutils_hs.egg-info/requires.txt

@@ -0,0 +1,9 @@
+
+[dev]
+pytest>=8.0
+pytest-cov>=5.0
+black>=24.0
+ruff>=0.5
+pre-commit>=3.7
+build>=1.2
+twine>=5.0

textutils_hs-0.1.0/textutils_hs.egg-info/top_level.txt

@@ -0,0 +1 @@
+textutils