testsweet 0.2.0__tar.gz → 0.2.2__tar.gz

testsweet-0.2.2/.github/workflows/lint.yml

@@ -0,0 +1,16 @@
+name: lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  ruff:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv run ruff check

testsweet-0.2.2/.github/workflows/publish.yml

@@ -0,0 +1,71 @@
+name: publish
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv build
+      - uses: actions/upload-artifact@v4
+        with: { name: dist, path: dist/ }
+
+  testpypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with: { name: dist, path: dist/ }
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  pypi:
+    needs: testpypi
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with: { name: dist, path: dist/ }
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    needs: pypi
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Extract changelog entry
+        id: changelog
+        env:
+          VERSION: ${{ github.ref_name }}
+        run: |
+          python3 -c '
+          import re, os
+          version = os.environ["VERSION"].lstrip("v")
+          text = open("CHANGELOG.md").read()
+          m = re.search(
+              rf"\[{re.escape(version)}\] \([^)]+\)\n-+\n(.*?)(?=\n\[{re.escape(version)}\]: |\Z)",
+              text, re.DOTALL,
+          )
+          print(m.group(1).strip() if m else "")
+          ' > /tmp/notes.txt
+          {
+            echo 'notes<<NOTES_EOF'
+            cat /tmp/notes.txt
+            echo 'NOTES_EOF'
+          } >> "$GITHUB_OUTPUT"
+      - uses: softprops/action-gh-release@v2
+        with:
+          body: ${{ steps.changelog.outputs.notes }}

{testsweet-0.2.0 → testsweet-0.2.2}/.github/workflows/tests.yml

@@ -6,7 +6,7 @@ on:
   pull_request:
 
 jobs:
-  test:
+  testsweet:
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
@@ -14,14 +14,9 @@ jobs:
         python-version: ['3.11', '3.12', '3.13', '3.14']
     steps:
       - uses: actions/checkout@v4
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v5
+      - uses: astral-sh/setup-uv@v5
         with:
           python-version: ${{ matrix.python-version }}
-
-      - name: Sync dependencies
-        run: uv sync
-
+          enable-cache: true
       - name: Run tests
-        run: uv run python -m testsweet
+        run: uv run testsweet

testsweet-0.2.2/.github/workflows/types.yml

@@ -0,0 +1,16 @@
+name: types
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  ty:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv run ty check src/ tests/

testsweet-0.2.2/CHANGELOG.md

@@ -0,0 +1,103 @@
+Changelog
+=========
+
+[0.2.2] (2026-06-27)
+--------------------
+
+### Bug Fixes
+
+- Fixed loading a test file by path (e.g. `testsweet path/to/tests.py`)
+  when the module uses relative imports.
+- Fixed resolving dotted targets (e.g. `testsweet tests.foo`) when run
+  via the installed `testsweet` console script.
+
+[0.2.2]: https://github.com/kaapstorm/testsweet/releases/tag/v0.2.2
+
+
+[0.2.1] (2026-06-27)
+--------------------
+
+### Improvements
+
+- Switched type checking from mypy to ty
+- Extended settings for linting and tightened type hints
+- Added "authors" and "keywords" to `pyproject.toml`
+- Tweaked CHANGELOG.md formatting
+- Automated GitHub releases
+
+
+[0.2.1]: https://github.com/kaapstorm/testsweet/releases/tag/v0.2.1
+
+
+[0.2.0] (2026-05-04)
+--------------------
+
+### Improvements
+
+- Added `@skip`, `@xfail`, and `@tag` decorators for marking tests.
+- Added command-line tag filtering: `-t`/`--tag` to include and
+  `-T`/`--exclude-tag` to exclude (both repeatable). A class-level
+  `@tag` propagates to every method on the class.
+- Discovery now rejects orphan modifier decorators — a callable
+  carrying `@skip`, `@xfail`, `@tag`, or `@params` without `@test`
+  raises `ConfigurationError` rather than being silently ignored.
+
+### Deprecations
+
+- `@test_params` and `@test_params_lazy` were renamed to `@params`
+  and `@params_lazy` and no longer imply `@test`. Stack `@test` on
+  top of `@params(...)` (or `@params_lazy(...)`) on the functions
+  or methods you want discovered.
+
+[0.2.0]: https://github.com/kaapstorm/testsweet/releases/tag/v0.2.0
+
+
+[0.1.5] (2026-05-03)
+--------------------
+
+### Improvements
+
+- Added convenience context manager method `__test_context__` for set-up and
+  tear-down to be applied to all test methods.
+- Added the ability to run plugins. (The first plugin, testsweet-django, will
+  be available soon.)
+
+[0.1.5]: https://github.com/kaapstorm/testsweet/releases/tag/v0.1.5
+
+
+[0.1.4] (2026-04-30)
+--------------------
+
+### Improvements
+
+- Improved output.
+- Added `--help` command line option.
+- Can be invoked using `testsweet`
+
+### Documentation
+
+- Clarified that class context managers are treated like
+  `setUpClass()`/`tearDownClass()`.
+
+[0.1.4]: https://github.com/kaapstorm/testsweet/releases/tag/v0.1.4
+
+
+[0.1.3] (2026-04-29)
+--------------------
+
+### Improvements
+
+- Tightened typing and added py.typed marker
+
+[0.1.3]: https://github.com/kaapstorm/testsweet/releases/tag/v0.1.3
+
+
+[0.1.2] (2026-04-29)
+--------------------
+
+### Documentation
+
+- Used absolute URLs in README.md to link to documentation on GitHub.
+- Added CHANGELOG.md.
+
+[0.1.2]: https://github.com/kaapstorm/testsweet/releases/tag/v0.1.2

{testsweet-0.2.0 → testsweet-0.2.2}/CLAUDE.md

@@ -5,6 +5,9 @@
 Start commands with `uv run ...` to run in the uv virtualenv.
 
 * Python: `uv run python ...`
+* Run tests: `uv run testsweet`
+* Run linter: `uv run ruff check`
+* Run type checker: `uv run ty check src/ tests/`
 
 ## File locations
 

{testsweet-0.2.0 → testsweet-0.2.2}/PKG-INFO

@@ -1,13 +1,15 @@
 Metadata-Version: 2.4
 Name: testsweet
-Version: 0.2.0
+Version: 0.2.2
 Summary: Python testing for humans
 Project-URL: Homepage, https://github.com/kaapstorm/testsweet
 Project-URL: Source, https://github.com/kaapstorm/testsweet
 Project-URL: Documentation, https://github.com/kaapstorm/testsweet/blob/main/README.md
 Project-URL: Changelog, https://github.com/kaapstorm/testsweet/blob/main/CHANGELOG.md
+Author-email: Norman Hooper <kaapstorm@gmail.com>
 License-Expression: Apache-2.0
 License-File: LICENSE
+Keywords: pytest,pythonic,tdd,test,test-discovery,test-framework,test-runner,testing,unit-testing,unittest
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3

{testsweet-0.2.0 → testsweet-0.2.2}/docs/reference.md

@@ -286,6 +286,11 @@ Installing a plugin from PyPI is a trust decision equivalent to
 installing any other dependency — testsweet does not sandbox or
 allowlist plugins.
 
+### Known plugins
+
+* [testsweet-django](https://github.com/kaapstorm/testsweet-django/) is
+  the first plugin and example implementation. 
+
 
 Errors
 ------

{testsweet-0.2.0 → testsweet-0.2.2}/pyproject.toml

@@ -1,12 +1,24 @@
 [project]
 name = "testsweet"
-version = "0.2.0"
+version = "0.2.2"
 description = "Python testing for humans"
-readme = "README.md"
-requires-python = ">=3.11"
 license = "Apache-2.0"
 license-files = ["LICENSE"]
-dependencies = []
+authors = [
+    { name = "Norman Hooper", email = "kaapstorm@gmail.com" },
+]
+keywords = [
+    "testing",
+    "test",
+    "test-framework",
+    "test-runner",
+    "unit-testing",
+    "test-discovery",
+    "tdd",
+    "pytest",
+    "unittest",
+    "pythonic",
+]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
@@ -17,6 +29,9 @@ classifiers = [
     "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Testing",
 ]
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = []
 
 [project.scripts]
 testsweet = "testsweet.__main__:cli"
@@ -36,9 +51,9 @@ packages = ["src/testsweet"]
 
 [dependency-groups]
 dev = [
-    "mypy",
     "pre-commit",
     "ruff",
+    "ty",
 ]
 
 [[tool.uv.index]]
@@ -56,18 +71,19 @@ explicit = true
 [tool.ruff]
 line-length = 79
 
+[tool.ruff.lint]
+select = ["E", "F", "ANN"]
+ignore = [
+    "ANN002",  # missing annotation for *args
+    "ANN003",  # missing annotation for **kwargs
+]
+
+[tool.ruff.lint.flake8-annotations]
+ignore-fully-untyped = true
+
 [tool.ruff.format]
 quote-style = "single"
 
-[tool.mypy]
-python_version = "3.11"
-files = ["src", "tests"]
-mypy_path = "src"
-disallow_incomplete_defs = true
-check_untyped_defs = true
-warn_unused_ignores = true
-warn_redundant_casts = true
-
 [tool.testsweet.discovery]
 include_paths = ["tests"]
 exclude_paths = ["tests/fixtures"]

{testsweet-0.2.0 → testsweet-0.2.2}/src/testsweet/__main__.py

@@ -84,6 +84,13 @@ def main(argv: list[str]) -> int:
         if (include or exclude) else None
     )
     with scoped_sys_path():
+        # `python -m testsweet` prepends the cwd to sys.path, but the
+        # installed console script does not (sys.path[0] is its own bin
+        # directory). Put the cwd on the path so dotted targets resolve
+        # against the project the same way under both invocations.
+        cwd = str(pathlib.Path.cwd())
+        if cwd not in sys.path:
+            sys.path.insert(0, cwd)
         config = load_config(pathlib.Path.cwd())
         plugins = load_plugins()
         wrap_unit = unit_wrapper(plugins)

{testsweet-0.2.0 → testsweet-0.2.2}/src/testsweet/_assertion.py

@@ -10,7 +10,7 @@ Failures (missing source, syntax errors, eval errors) silently yield
 ``None`` — the explainer is a nicety, not a correctness requirement.
 """
 import ast
-from types import TracebackType
+from types import FrameType, TracebackType
 
 
 def assertion_source(exc: AssertionError) -> str | None:
@@ -55,7 +55,7 @@ def explain_assertion(exc: AssertionError) -> str | None:
 
 def _locate_assert(
     exc: AssertionError,
-) -> tuple[object, str, ast.Assert] | None:
+) -> tuple[FrameType, str, ast.Assert] | None:
     tb = _innermost_tb(exc.__traceback__)
     if tb is None:
         return None

{testsweet-0.2.0 → testsweet-0.2.2}/src/testsweet/_condition_decorator.py

@@ -13,7 +13,8 @@ Condition = Union[bool, Callable[[], bool]]
 
 
 def make_condition_decorator(decorator_name, marker_cls, attr):
-    """Build a decorator that attaches ``marker_cls(reason, condition)`` under ``attr``.
+    """Build a decorator that attaches ``marker_cls(reason, condition)``
+    under ``attr``.
 
     The returned decorator supports the bare form (``@dec``) and the
     called form (``@dec(reason='…')``, ``@dec(condition=expr)``,

{testsweet-0.2.0 → testsweet-0.2.2}/src/testsweet/_config.py

@@ -2,7 +2,7 @@
 import pathlib
 import tomllib
 from dataclasses import dataclass, field
-
+from typing import cast
 
 _VALID_KEYS = frozenset({'include_paths', 'exclude_paths', 'test_files'})
 
@@ -71,6 +71,6 @@ def _to_string_tuple(value: object, key: str) -> tuple[str, ...]:
     err = f'tool.testsweet.discovery.{key} must be a list of strings'
     if not isinstance(value, list):
         raise ConfigurationError(err)
-    if not all(isinstance(item, str) for item in value):
+    if any(not isinstance(item, str) for item in value):
         raise ConfigurationError(err)
-    return tuple(value)
+    return cast(tuple[str, ...], tuple(value))

{testsweet-0.2.0 → testsweet-0.2.2}/src/testsweet/_discover.py

@@ -1,6 +1,6 @@
 """Discover ``@test``-marked callables and classes in a module."""
 from types import ModuleType
-from typing import Callable
+from typing import Protocol
 
 from testsweet._config import ConfigurationError
 from testsweet._markers import (
@@ -12,6 +12,13 @@ from testsweet._markers import (
 from testsweet._params import PARAMS_MARKER
 
 
+class TestUnit(Protocol):
+    __name__: str
+    __qualname__: str
+
+    def __call__(self, *args, **kwargs): ...
+
+
 _MODIFIER_DECORATORS = {
     PARAMS_MARKER: '@params',
     SKIP_MARKER: '@skip',
@@ -20,7 +27,7 @@ _MODIFIER_DECORATORS = {
 }
 
 
-def discover(module: ModuleType) -> list[Callable]:
+def discover(module: ModuleType) -> list[TestUnit]:
     """Return module-level callables marked as test units.
 
     Order follows ``vars(module)`` (definition order on CPython 3.7+).
@@ -31,7 +38,7 @@ def discover(module: ModuleType) -> list[Callable]:
     ``@xfail``, ``@tag``) without ``@test``. Imported callables are
     not checked — they were decorated wherever they were defined.
     """
-    tests: list[Callable] = []
+    tests = []
     for name, value in vars(module).items():
         if not callable(value):
             continue

{testsweet-0.2.0 → testsweet-0.2.2}/src/testsweet/_loaders.py

@@ -39,10 +39,6 @@ def _exec_module_from_path(path: pathlib.Path) -> ModuleType:
     return module
 
 
-def _load_path(target: str) -> ModuleType:
-    return _exec_module_from_path(pathlib.Path(target).resolve())
-
-
 def _load_path_for_walk(path: pathlib.Path) -> ModuleType:
     info = _dotted_name_for_path(path)
     if info is None:

{testsweet-0.2.0 → testsweet-0.2.2}/src/testsweet/_report.py

@@ -95,12 +95,18 @@ def _print_traceback_block(
 
 def _outcome_key(outcome: Outcome) -> str:
     match outcome:
-        case Passed(): return 'passed'
-        case Failed(): return 'failed'
-        case Errored(): return 'errored'
-        case Skipped(): return 'skipped'
-        case XFailed(): return 'xfailed'
-        case XPassed(): return 'xpassed'
+        case Passed():
+            return 'passed'
+        case Failed():
+            return 'failed'
+        case Errored():
+            return 'errored'
+        case Skipped():
+            return 'skipped'
+        case XFailed():
+            return 'xfailed'
+        case XPassed():
+            return 'xpassed'
 
 
 _SUMMARY_ORDER = (

{testsweet-0.2.0 → testsweet-0.2.2}/src/testsweet/_resolve.py

@@ -12,7 +12,7 @@ from types import ModuleType
 from typing import Any, Callable, Iterator
 
 from testsweet._class_helpers import _public_methods
-from testsweet._discover import discover
+from testsweet._discover import TestUnit, discover
 from testsweet._markers import TAGS_MARKER
 from testsweet._params import PARAMS_MARKER
 
@@ -46,14 +46,12 @@ def resolve_units(
 
 
 def _expand_unit(
-    unit: Any,
+    unit: TestUnit,
     method_filter: set[str] | None,
     keep: TagFilter | None,
 ) -> Iterator[tuple[str, Callable[[], Any]]]:
     if isinstance(unit, type):
-        class_tags: frozenset[str] = getattr(
-            unit, TAGS_MARKER, frozenset(),
-        )
+        class_tags: frozenset[str] = getattr(unit, TAGS_MARKER, frozenset())
         eligible = [
             method_name
             for method_name in _public_methods(unit)
@@ -78,9 +76,10 @@ def _expand_unit(
             test_context = getattr(instance, '__test_context__', None)
             for method_name in eligible:
                 bound = getattr(instance, method_name)
+                qualname: str = bound.__qualname__
                 if test_context is not None:
                     bound = _wrap_in_cm(bound, test_context)
-                yield from _expand_callable(bound, bound.__qualname__)
+                yield from _expand_callable(bound, qualname)
     else:
         if keep is not None:
             tags: frozenset[str] = getattr(
@@ -101,7 +100,7 @@ def _wrap_in_cm(
     cm_factory: Callable[[], Any],
 ) -> Callable[..., Any]:
     @functools.wraps(call)
-    def wrapped(*args: Any, **kwargs: Any) -> Any:
+    def wrapped(*args, **kwargs):
         with cm_factory():
             return call(*args, **kwargs)
     return wrapped
@@ -126,7 +125,7 @@ def _expand_callable(
 
 
 def _build_plan(
-    units: list[Any],
+    units: list[TestUnit],
     names: list[str],
 ) -> dict[str, set[str] | None]:
     """Map unit qualnames to method-name filters.

{testsweet-0.2.0 → testsweet-0.2.2}/src/testsweet/_tag.py

@@ -17,7 +17,7 @@ def tag(*names):
     new = frozenset(names)
 
     def decorator(func):
-        existing = getattr(func, TAGS_MARKER, frozenset())
+        existing: frozenset[str] = getattr(func, TAGS_MARKER, frozenset())
         setattr(func, TAGS_MARKER, existing | new)
         return func
 

{testsweet-0.2.0 → testsweet-0.2.2}/src/testsweet/_targets.py

@@ -9,7 +9,7 @@ from types import ModuleType
 
 from testsweet._classify import _resolve_dotted
 from testsweet._config import DiscoveryConfig
-from testsweet._loaders import _load_path, _load_path_for_walk
+from testsweet._loaders import _load_path_for_walk
 from testsweet._walk import (
     _build_exclude_set,
     _resolve_include_paths,
@@ -73,7 +73,7 @@ def parse_target(
                     excluded=excluded,
                 )
             ]
-        return [(_load_path(target), None)]
+        return [(_load_path_for_walk(path), None)]
     return [_resolve_dotted(target)]
 
 

{testsweet-0.2.0 → testsweet-0.2.2}/tests/cli.py

@@ -394,6 +394,19 @@ class Cli:
         assert result.returncode == 0
         assert result.stdout.startswith('Usage: testsweet')
 
+    def installed_entry_point_resolves_dotted_target(self):
+        script = pathlib.Path(sys.executable).with_name('testsweet')
+        if not script.exists():
+            return  # not an installed environment; skip silently
+        result = subprocess.run(
+            [str(script), 'tests.fixtures.runner.all_pass'],
+            capture_output=True,
+            text=True,
+            cwd=_REPO_ROOT,
+        )
+        assert result.returncode == 0, result.stderr
+        assert 'passes_one ... ok' in result.stdout
+
     @params([(('-h',),), (('--help',),)])
     def help_flag_prints_usage_and_exits_zero(self, args):
         result = _run_cli(*args)

testsweet-0.2.2/tests/fixtures/runner/has_broken_import.py

@@ -0,0 +1 @@
+import this_dependency_does_not_exist  # ty: ignore[unresolved-import]  # noqa: F401

testsweet-0.2.2/tests/fixtures/runner/uses_relative_import.py

@@ -0,0 +1,8 @@
+from testsweet import test
+
+from .all_pass import passes_one  # noqa: F401
+
+
+@test
+def uses_rel():
+    pass

{testsweet-0.2.0 → testsweet-0.2.2}/tests/outcomes.py

@@ -30,7 +30,7 @@ class FailedOutcome:
     def is_frozen(self):
         out = Failed(AssertionError())
         with catch_exceptions() as caught:
-            out.exc = AssertionError()  # type: ignore[misc]
+            out.exc = AssertionError()  # ty: ignore[invalid-assignment]
         assert len(caught) == 1
 
 
@@ -58,7 +58,7 @@ class SkippedOutcome:
     def is_frozen(self):
         s = Skipped('r')
         with catch_exceptions() as caught:
-            s.reason = 'mutate'  # type: ignore[misc]
+            s.reason = 'mutate'  # ty: ignore[invalid-assignment]
         assert len(caught) == 1
 
 

{testsweet-0.2.0 → testsweet-0.2.2}/tests/plugins.py

@@ -143,7 +143,7 @@ class LoadPlugins:
             value='fake_module',
             load=lambda: plugin,
         )
-        _plugins.entry_points = lambda group: [fake_ep]
+        _plugins.entry_points = lambda group: [fake_ep]  # ty: ignore[invalid-assignment]
         loaded = load_plugins()
         assert loaded == [plugin]
 
@@ -160,7 +160,7 @@ class LoadPlugins:
             value='broken_module',
             load=lambda: bad,
         )
-        _plugins.entry_points = lambda group: [fake_ep]
+        _plugins.entry_points = lambda group: [fake_ep]  # ty: ignore[invalid-assignment]
         with catch_exceptions() as excs:
             load_plugins()
         assert len(excs) == 1
@@ -169,7 +169,7 @@ class LoadPlugins:
 
     def empty_entry_points_yields_empty_list(self):
         from testsweet import _plugins
-        _plugins.entry_points = lambda group: []
+        _plugins.entry_points = lambda group: []  # ty: ignore[invalid-assignment]
         assert load_plugins() == []
 
     def import_failure_raises_configuration_error(self):
@@ -183,7 +183,7 @@ class LoadPlugins:
             value='broken_module',
             load=raises,
         )
-        _plugins.entry_points = lambda group: [fake_ep]
+        _plugins.entry_points = lambda group: [fake_ep]  # ty: ignore[invalid-assignment]
         with catch_exceptions() as excs:
             load_plugins()
         assert len(excs) == 1