Initial open-source release

Claude-Session: https://claude.ai/code/session_01B65qLEKnkeYTGdbwhLpjCu

fixtures/python-app/.gitignore

@@ -0,0 +1,4 @@
+__pycache__/
+.venv/
+*.egg-info/
+.pytest_cache/

fixtures/python-app/pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "openidea-fixture-tasks"
+version = "0.1.0"
+description = "OpenIDEA QA fixture: a tiny task tracker"
+requires-python = ">=3.10"
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["pytest>=8"]
+
+[project.scripts]
+tasks = "tasks.cli:main"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"

fixtures/python-app/src/tasks/__init__.py

@@ -0,0 +1,5 @@
+"""A tiny task tracker used as an OpenIDEA QA fixture."""
+
+from .models import Priority, Task, TaskList
+
+__all__ = ["Priority", "Task", "TaskList"]

fixtures/python-app/src/tasks/cli.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+import argparse
+from datetime import date, timedelta
+
+from .models import Priority, TaskList
+
+
+def build_demo() -> TaskList:
+    today = date.today()
+    tasks = TaskList()
+    tasks.add("Write release notes", Priority.HIGH, today + timedelta(days=1), "docs")
+    tasks.add("Fix flaky test", Priority.HIGH, today - timedelta(days=2), "ci")
+    tasks.add("Update dependencies", Priority.LOW, None, "chore")
+    return tasks
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(prog="tasks")
+    parser.add_argument("--overdue", action="store_true", help="only show overdue tasks")
+    args = parser.parse_args(argv)
+
+    tasks = build_demo()
+    # Set a breakpoint here (QA: debugger) and inspect `tasks`.
+    shown = tasks.overdue(date.today()) if args.overdue else tasks.pending()
+    for task in shown:
+        flag = "!" if task.priority is Priority.HIGH else " "
+        print(f"{flag} {task.title} ({', '.join(sorted(task.tags))})")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

fixtures/python-app/src/tasks/models.py

@@ -0,0 +1,57 @@
+from __future__ import annotations
+
+import os
+import sys
+from dataclasses import dataclass, field
+from datetime import date
+from enum import IntEnum
+
+
+class Priority(IntEnum):
+    LOW = 1
+    NORMAL = 2
+    HIGH = 3
+
+
+@dataclass
+class Task:
+    title: str
+    priority: Priority = Priority.NORMAL
+    due: date | None = None
+    done: bool = False
+    tags: set[str] = field(default_factory=set)
+
+    def is_overdue(self, today: date) -> bool:
+        return not self.done and self.due is not None and self.due < today
+
+
+class TaskList:
+    def __init__(self) -> None:
+        self._tasks: list[Task] = []
+
+    def add(self, title: str, priority: Priority = Priority.NORMAL, due: date | None = None, *tags: str) -> Task:
+        if not title.strip():
+            raise ValueError("title must not be empty")
+        task = Task(title.strip(), priority, due, tags=set(tags))
+        self._tasks.append(task)
+        return task
+
+    def complete(self, title: str) -> Task:
+        for task in self._tasks:
+            if task.title == title:
+                task.done = True
+                return task
+        raise KeyError(title)
+
+    def pending(self) -> list[Task]:
+        # TODO: stable ordering for equal priorities (by due date)
+        return sorted((t for t in self._tasks if not t.done), key=lambda t: -t.priority)
+
+    def overdue(self, today: date) -> list[Task]:
+        return [t for t in self._tasks if t.is_overdue(today)]
+
+    def by_tag(self, tag: str) -> list[Task]:
+        return [t for t in self._tasks if tag in t.tags]
+
+    def __len__(self) -> int:
+        return len(self._tasks)

fixtures/python-app/tests/test_models.py

@@ -0,0 +1,39 @@
+import os
+from datetime import date
+
+import pytest
+
+from tasks import Priority, TaskList
+
+
+def test_pending_is_sorted_by_priority():
+    tasks = TaskList()
+    tasks.add("low", Priority.LOW)
+    tasks.add("high", Priority.HIGH)
+    assert [t.title for t in tasks.pending()] == ["high", "low"]
+
+
+def test_complete_and_overdue():
+    tasks = TaskList()
+    tasks.add("late", Priority.NORMAL, date(2020, 1, 1))
+    assert [t.title for t in tasks.overdue(date(2024, 1, 1))] == ["late"]
+    tasks.complete("late")
+    assert tasks.overdue(date(2024, 1, 1)) == []
+
+
+def test_rejects_empty_titles():
+    with pytest.raises(ValueError):
+        TaskList().add("   ")
+
+
+def test_tags():
+    tasks = TaskList()
+    tasks.add("a", Priority.LOW, None, "x", "y")
+    tasks.add("b", Priority.LOW, None, "y")
+    assert len(tasks.by_tag("y")) == 2
+
+
+@pytest.mark.skipif(not os.environ.get("OPENIDEA_FAIL"), reason="set OPENIDEA_FAIL=1 to run")
+def test_intentionally_failing():
+    # FIXME: wrong on purpose (QA: failing test in the test tree)
+    assert len(TaskList()) == 1