truthcheck2 0.1.0__tar.gz

truthcheck2-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Format & Lint
+        run: |
+          ruff format --check .
+          ruff check .
+      - name: Type check
+        run: mypy src/truthcheck
+      - name: Test
+        run: pytest
+      - name: Build
+        run: python -m build

truthcheck2-0.1.0/LICENSE

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

truthcheck2-0.1.0/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: truthcheck2
+Version: 0.1.0
+Summary: A minimal utility to evaluate truthiness and count tokens.
+Author-email: buckethq <onebucket@proton.me>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: tiktoken>=0.7.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5.0; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# truthcheck
+ PyPI package structure focused on modern Python packaging standards

truthcheck2-0.1.0/README.md

@@ -0,0 +1,2 @@
+# truthcheck
+ PyPI package structure focused on modern Python packaging standards

truthcheck2-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "truthcheck2"
+version = "0.1.0"
+description = "A minimal utility to evaluate truthiness and count tokens."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+authors = [
+    {name = "buckethq", email = "onebucket@proton.me"}
+]
+dependencies = [
+    "tiktoken>=0.7.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "ruff>=0.5.0",
+    "mypy>=1.10",
+    "build>=1.2",
+    "twine>=5.0",
+]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+lint.select = ["E", "F", "I", "N", "UP", "B", "SIM", "TCH"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--cov=src/truthcheck --cov-report=term-missing"

truthcheck2-0.1.0/src/truthcheck2/__init__.py

@@ -0,0 +1,8 @@
+"""truthcheck: Evaluate truthiness and count tokens for any Python object."""
+
+__version__ = "0.1.0"
+
+from .core import is_truthy
+from .tokenizer import count_tokens, print_token_count
+
+__all__ = ["is_truthy", "count_tokens", "print_token_count"]

truthcheck2-0.1.0/src/truthcheck2/core.py

@@ -0,0 +1,6 @@
+from typing import Any
+
+
+def is_truthy(value: Any) -> bool:
+    """Evaluate the truthiness of any Python object."""
+    return bool(value)

truthcheck2-0.1.0/src/truthcheck2/tokenizer.py

@@ -0,0 +1,25 @@
+from typing import Any
+
+import tiktoken
+
+
+def count_tokens(value: Any, model: str = "cl100k_base") -> int:
+    """Count tokens in the string representation of any object."""
+    try:
+        encoding = tiktoken.get_encoding(model)
+    except Exception as e:
+        raise ValueError(f"Failed to load tiktoken model '{model}': {e}") from e
+
+    try:
+        text = str(value)
+    except Exception as e:
+        raise TypeError(f"Cannot convert {type(value).__name__} to string: {e}") from e
+
+    return len(encoding.encode(text))
+
+
+def print_token_count(value: Any, model: str = "cl100k_base") -> int:
+    """Print and return the token count for any object."""
+    count = count_tokens(value, model)
+    print(f"🔢 Token count ({model}): {count}")
+    return count

truthcheck2-0.1.0/tests/test_core.py

@@ -0,0 +1,25 @@
+import pytest
+
+from truthcheck2.core import is_truthy
+
+
+@pytest.mark.parametrize(
+    "value,expected",
+    [
+        (0, False),
+        (1, True),
+        ("", False),
+        ("hello", True),
+        ([], False),
+        ([1], True),
+        ({}, False),
+        ({"a": 1}, True),
+        (None, False),
+        (False, False),
+        (True, True),
+        (0.0, False),
+        (0.1, True),
+    ],
+)
+def test_is_truthy(value: object, expected: bool) -> None:
+    assert is_truthy(value) is expected

truthcheck2-0.1.0/tests/test_tokenizer.py

@@ -0,0 +1,20 @@
+import pytest
+
+from truthcheck2.tokenizer import count_tokens, print_token_count
+
+
+def test_count_tokens_basic() -> None:
+    assert count_tokens("hello world") > 0
+    assert count_tokens("") == 0
+
+
+def test_count_tokens_non_string() -> None:
+    assert count_tokens(42) >= 1
+    assert count_tokens([1, 2, 3]) >= 1
+
+
+def test_print_token_count(capsys: pytest.CaptureFixture) -> None:
+    count = print_token_count("test")
+    captured = capsys.readouterr()
+    assert "🔢 Token count (cl100k_base):" in captured.out
+    assert isinstance(count, int)