am-i-even-or-odd 0.2.0__tar.gz

am_i_even_or_odd-0.2.0/LICENSE

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

am_i_even_or_odd-0.2.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: am-i-even-or-odd
+Version: 0.2.0
+Summary: A tiny Python library for checking whether numbers are even or odd.
+Author: Ken Kambi
+License: MIT
+Project-URL: Homepage, https://github.com/KenKambi/am-i-even-or-odd
+Project-URL: Repository, https://github.com/KenKambi/am-i-even-or-odd
+Project-URL: Bug Tracker, https://github.com/KenKambi/am-i-even-or-odd/issues
+Project-URL: Changelog, https://github.com/KenKambi/am-i-even-or-odd/blob/main/CHANGELOG.md
+Keywords: even,odd,math,parity,python
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# Am I Even Or Odd 
+
+[![PyPI version](https://img.shields.io/pypi/v/am-i-even-or-odd.svg)](https://pypi.org/project/am-i-even-or-odd/)
+[![CI](https://github.com/KenKambi/am-i-even-or-odd/actions/workflows/ci.yml/badge.svg)](https://github.com/KenKambi/am-i-even-or-odd/actions/workflows/ci.yml)
+[![Python versions](https://img.shields.io/pypi/pyversions/am-i-even-or-odd.svg)](https://pypi.org/project/am-i-even-or-odd/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/KenKambi/am-i-even-or-odd/blob/main/LICENSE)
+
+A tiny Python package that answers one simple question:
+is your number even, or odd tho?
+
+Yes, `n % 2 == 0` does the same thing :)
+
+## Installation
+
+```bash
+pip install am-i-even-or-odd
+```
+
+## Usage
+
+```python
+from am_i_even_or_odd import is_it_even_tho, is_it_odd_tho
+
+print(is_it_even_tho(4))
+print(is_it_odd_tho(5))
+```
+
+Output
+
+```
+True
+True
+```
+
+### Error handling
+
+Only `int` values are accepted. Anything else — floats, strings,
+`None`, booleans — raises a `TypeError` with a message explaining
+why, rather than silently returning a possibly-wrong answer:
+
+```python
+>>> is_it_even_tho(4.0)
+TypeError: expected an int, got 'float' (4.0). Floats and other
+numeric types aren't supported to avoid ambiguity around what
+counts as 'even' or 'odd'.
+```
+
+## Development
+
+```bash
+git clone https://github.com/KenKambi/am-i-even-or-odd.git
+cd am-i-even-or-odd
+pip install -e ".[dev]"
+pytest -v
+```
+
+Contributions and issues are welcome — see the
+[issue tracker](https://github.com/KenKambi/am-i-even-or-odd/issues).
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

am_i_even_or_odd-0.2.0/README.md

@@ -0,0 +1,66 @@
+# Am I Even Or Odd 
+
+[![PyPI version](https://img.shields.io/pypi/v/am-i-even-or-odd.svg)](https://pypi.org/project/am-i-even-or-odd/)
+[![CI](https://github.com/KenKambi/am-i-even-or-odd/actions/workflows/ci.yml/badge.svg)](https://github.com/KenKambi/am-i-even-or-odd/actions/workflows/ci.yml)
+[![Python versions](https://img.shields.io/pypi/pyversions/am-i-even-or-odd.svg)](https://pypi.org/project/am-i-even-or-odd/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/KenKambi/am-i-even-or-odd/blob/main/LICENSE)
+
+A tiny Python package that answers one simple question:
+is your number even, or odd tho?
+
+Yes, `n % 2 == 0` does the same thing :)
+
+## Installation
+
+```bash
+pip install am-i-even-or-odd
+```
+
+## Usage
+
+```python
+from am_i_even_or_odd import is_it_even_tho, is_it_odd_tho
+
+print(is_it_even_tho(4))
+print(is_it_odd_tho(5))
+```
+
+Output
+
+```
+True
+True
+```
+
+### Error handling
+
+Only `int` values are accepted. Anything else — floats, strings,
+`None`, booleans — raises a `TypeError` with a message explaining
+why, rather than silently returning a possibly-wrong answer:
+
+```python
+>>> is_it_even_tho(4.0)
+TypeError: expected an int, got 'float' (4.0). Floats and other
+numeric types aren't supported to avoid ambiguity around what
+counts as 'even' or 'odd'.
+```
+
+## Development
+
+```bash
+git clone https://github.com/KenKambi/am-i-even-or-odd.git
+cd am-i-even-or-odd
+pip install -e ".[dev]"
+pytest -v
+```
+
+Contributions and issues are welcome — see the
+[issue tracker](https://github.com/KenKambi/am-i-even-or-odd/issues).
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

am_i_even_or_odd-0.2.0/am_i_even_or_odd/__init__.py

@@ -0,0 +1,8 @@
+from .checker import is_it_odd_tho, is_it_even_tho
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "is_it_odd_tho",
+    "is_it_even_tho",
+]

am_i_even_or_odd-0.2.0/am_i_even_or_odd/checker.py

@@ -0,0 +1,34 @@
+def _validate(number: int) -> None:
+    """Raise a clear error if ``number`` isn't a whole number.
+
+    ``bool`` is deliberately rejected even though it's technically an
+    ``int`` subclass in Python, since checking parity of True/False
+    is almost certainly a mistake on the caller's part.
+    """
+    if isinstance(number, bool) or not isinstance(number, int):
+        raise TypeError(
+            f"expected an int, got {type(number).__name__!r} "
+            f"({number!r}). Floats and other numeric types aren't "
+            "supported to avoid ambiguity around what counts as "
+            "'even' or 'odd'."
+        )
+
+
+def is_it_even_tho(number: int) -> bool:
+    """Return True if ``number`` is even.
+
+    :param number: the whole number to check.
+    :raises TypeError: if ``number`` is not an ``int``.
+    """
+    _validate(number)
+    return number % 2 == 0
+
+
+def is_it_odd_tho(number: int) -> bool:
+    """Return True if ``number`` is odd.
+
+    :param number: the whole number to check.
+    :raises TypeError: if ``number`` is not an ``int``.
+    """
+    _validate(number)
+    return number % 2 != 0

am_i_even_or_odd-0.2.0/am_i_even_or_odd.egg-info/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: am-i-even-or-odd
+Version: 0.2.0
+Summary: A tiny Python library for checking whether numbers are even or odd.
+Author: Ken Kambi
+License: MIT
+Project-URL: Homepage, https://github.com/KenKambi/am-i-even-or-odd
+Project-URL: Repository, https://github.com/KenKambi/am-i-even-or-odd
+Project-URL: Bug Tracker, https://github.com/KenKambi/am-i-even-or-odd/issues
+Project-URL: Changelog, https://github.com/KenKambi/am-i-even-or-odd/blob/main/CHANGELOG.md
+Keywords: even,odd,math,parity,python
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# Am I Even Or Odd 
+
+[![PyPI version](https://img.shields.io/pypi/v/am-i-even-or-odd.svg)](https://pypi.org/project/am-i-even-or-odd/)
+[![CI](https://github.com/KenKambi/am-i-even-or-odd/actions/workflows/ci.yml/badge.svg)](https://github.com/KenKambi/am-i-even-or-odd/actions/workflows/ci.yml)
+[![Python versions](https://img.shields.io/pypi/pyversions/am-i-even-or-odd.svg)](https://pypi.org/project/am-i-even-or-odd/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/KenKambi/am-i-even-or-odd/blob/main/LICENSE)
+
+A tiny Python package that answers one simple question:
+is your number even, or odd tho?
+
+Yes, `n % 2 == 0` does the same thing :)
+
+## Installation
+
+```bash
+pip install am-i-even-or-odd
+```
+
+## Usage
+
+```python
+from am_i_even_or_odd import is_it_even_tho, is_it_odd_tho
+
+print(is_it_even_tho(4))
+print(is_it_odd_tho(5))
+```
+
+Output
+
+```
+True
+True
+```
+
+### Error handling
+
+Only `int` values are accepted. Anything else — floats, strings,
+`None`, booleans — raises a `TypeError` with a message explaining
+why, rather than silently returning a possibly-wrong answer:
+
+```python
+>>> is_it_even_tho(4.0)
+TypeError: expected an int, got 'float' (4.0). Floats and other
+numeric types aren't supported to avoid ambiguity around what
+counts as 'even' or 'odd'.
+```
+
+## Development
+
+```bash
+git clone https://github.com/KenKambi/am-i-even-or-odd.git
+cd am-i-even-or-odd
+pip install -e ".[dev]"
+pytest -v
+```
+
+Contributions and issues are welcome — see the
+[issue tracker](https://github.com/KenKambi/am-i-even-or-odd/issues).
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

am_i_even_or_odd-0.2.0/am_i_even_or_odd.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+am_i_even_or_odd/__init__.py
+am_i_even_or_odd/checker.py
+am_i_even_or_odd/py.typed
+am_i_even_or_odd.egg-info/PKG-INFO
+am_i_even_or_odd.egg-info/SOURCES.txt
+am_i_even_or_odd.egg-info/dependency_links.txt
+am_i_even_or_odd.egg-info/requires.txt
+am_i_even_or_odd.egg-info/top_level.txt
+tests/test_checker.py

am_i_even_or_odd-0.2.0/am_i_even_or_odd.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

am_i_even_or_odd-0.2.0/am_i_even_or_odd.egg-info/requires.txt

@@ -0,0 +1,3 @@
+
+[dev]
+pytest>=7.0

am_i_even_or_odd-0.2.0/am_i_even_or_odd.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+am_i_even_or_odd
+dist

am_i_even_or_odd-0.2.0/pyproject.toml

@@ -0,0 +1,60 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "am-i-even-or-odd"
+version = "0.2.0"
+description = "A tiny Python library for checking whether numbers are even or odd."
+readme = "README.md"
+requires-python = ">=3.8"
+
+authors = [
+  { name = "Ken Kambi" }
+]
+
+license = { text = "MIT" }
+
+keywords = [
+    "even",
+    "odd",
+    "math",
+    "parity",
+    "python"
+]
+
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3 :: Only",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/KenKambi/am-i-even-or-odd"
+Repository = "https://github.com/KenKambi/am-i-even-or-odd"
+"Bug Tracker" = "https://github.com/KenKambi/am-i-even-or-odd/issues"
+Changelog = "https://github.com/KenKambi/am-i-even-or-odd/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+exclude = ["tests", "tests.*"]
+
+[tool.setuptools.package-data]
+am_i_even_or_odd = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

am_i_even_or_odd-0.2.0/setup.cfg

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

am_i_even_or_odd-0.2.0/tests/test_checker.py

@@ -0,0 +1,42 @@
+import pytest
+
+from am_i_even_or_odd import is_it_even_tho, is_it_odd_tho
+
+
+def test_even():
+    assert is_it_even_tho(2) is True
+    assert is_it_even_tho(12) is True
+    assert is_it_even_tho(3) is False
+
+
+def test_odd():
+    assert is_it_odd_tho(3) is True
+    assert is_it_odd_tho(13) is True
+    assert is_it_odd_tho(100) is False
+
+
+def test_zero_is_even():
+    assert is_it_even_tho(0) is True
+    assert is_it_odd_tho(0) is False
+
+
+def test_negative_numbers():
+    assert is_it_even_tho(-4) is True
+    assert is_it_odd_tho(-3) is True
+    assert is_it_even_tho(-3) is False
+
+
+@pytest.mark.parametrize("bad_value", [4.0, "4", None, [4], (4,), 4 + 0j])
+def test_non_int_raises_type_error(bad_value):
+    with pytest.raises(TypeError):
+        is_it_even_tho(bad_value)
+    with pytest.raises(TypeError):
+        is_it_odd_tho(bad_value)
+
+
+@pytest.mark.parametrize("bool_value", [True, False])
+def test_bool_raises_type_error(bool_value):
+    # bool is technically an int subclass in Python, but treating
+    # True/False as numbers here would be a footgun for callers.
+    with pytest.raises(TypeError):
+        is_it_even_tho(bool_value)