timeout-dead 0.1.0__tar.gz

timeout_dead-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,26 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

timeout_dead-0.1.0/.github/workflows/pyright.yml

@@ -0,0 +1,26 @@
+name: Pyright
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  typecheck:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run pyright
+        run: uv run pyright src/timeout_dead/

timeout_dead-0.1.0/.github/workflows/ruff.yml

@@ -0,0 +1,23 @@
+name: Ruff
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Run ruff
+        run: uvx ruff check src/timeout_dead/ tests/

timeout_dead-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,26 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run tests
+        run: uv run pytest

timeout_dead-0.1.0/.gitignore

@@ -0,0 +1,158 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# PDM
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+.idea/
+
+# VS Code
+.vscode/*
+!.vscode/settings.json
+
+# Solution data
+*solved.ipynb
+*solved.py
+*solved
+
+# Other files
+*.docx
+*.doc
+*.exe
+*.rtf
+*.xlsx
+*.env*
+temp.*
+
+# Ruff
+.ruff_cache/
+
+# PyPI config
+.pypirc
+
+# Auto-generated by setuptools-scm
+src/timeout_dead/_version.py

timeout_dead-0.1.0/AGENTS.md

@@ -0,0 +1,208 @@
+# AGENTS.md
+
+## Project & Profile
+
+`timeout-dead` — lightweight command timeout utility with zero external dependencies. Runs any shell command with a configurable timeout and signal, terminating the process if it exceeds the limit. Works on Unix (Linux/macOS) and Windows (with Git Bash or WSL).
+
+### Code style
+
+You MUST strictly follow the project's coding standards, naming conventions, and language-specific rules.
+
+Before generating, refactoring, or modifying any code, you are REQUIRED to read and apply the guidelines defined in the external style guide:
+
+- **File Path:** [`./CODE-STYLE.md`](./CODE-STYLE.md)
+
+_Instruction for Agent:_ If you haven't read `./CODE-STYLE.md` in the current session, use your file-reading tool to fetch its content before writing any code. Do not hallucinate styles.
+
+## Operational Rules & Critical Restrictions
+
+**UNDER NO CIRCUMSTANCES may you commit, push, amend, rebase, or modify the git history without an EXPLICIT instruction to do so.** This is the most important rule in this document. Violating it may result in lost work and broken branches.
+
+This specifically includes:
+
+- `git commit` / `git commit --amend` / `git commit -m "..."`
+- `git push` / `git push --force` / `git push --force-with-lease`
+- `git add` (stage for commit — prefer working-tree-only edits)
+- `git rebase` / `git reset` / `git checkout` (to modify branches)
+- Any other command that creates or alters commits
+
+If the user asks "what should the commit message be?" — **suggest a message but do NOT commit**. Wait for an explicit directive such as:
+
+- "commit"
+- "commit and push"
+- "закоммить"
+- "сделай коммит"
+
+**If the user says "обнови AGENTS.md" or similar — this is NOT a commit instruction. Do NOT add or commit files unless told to.**
+
+## Workflow & Verification Commands
+
+### Time limit (HARD REQUIREMENT)
+
+**Every bash command MUST complete within 60 seconds.** All commands must be invoked through the timeout wrapper:
+
+```bash
+timeout-dead --sec 60 "<your command>"
+```
+
+Long-running daemons must use `nohup ... >/dev/null 2>&1 &` so the wrapper returns immediately.
+
+### Setup
+
+```bash
+timeout-dead --sec 60 "uv sync"
+```
+
+### Verify after changes
+
+Run **all** checks in this order — treat errors as blockers:
+
+```bash
+timeout-dead --sec 60 "ruff check ."
+timeout-dead --sec 60 "ruff format --check ."
+timeout-dead --sec 60 "pyright ."
+timeout-dead --sec 60 "python -m pytest tests/ -v"
+```
+
+### Fix formatting & imports
+
+```bash
+timeout-dead --sec 60 "ruff check --fix . && ruff format ."
+```
+
+**LSP is mandatory.** Configure `pyright-langserver` and `ruff server` in your editor. After every change, confirm lint, format, and type-check show **0 errors**. `ruff format` is the single source of truth for formatting — no `black`, no `isort`.
+
+### Run a single test
+
+```bash
+timeout-dead --sec 60 "python -m pytest tests/test_file.py::test_name -v"
+```
+
+### Mandatory testing
+
+**Every change must be verified by running the test suite.** No exceptions. If any test fails, fix the issue before considering the change complete.
+
+## Software Architecture & Design Patterns
+
+### Documentation
+
+- **Standalone Markdown documentation pages** → `SCREAMING_SNAKE_CASE` names (e.g., `CONFIG.md`, `ARCHITECTURE.md`, `CODE-STYLE.md`). Keep conventional repository files such as `README.md` unchanged unless explicitly requested.
+
+### Package Layout
+
+- Source code lives under `src/<project_name>/` (or directly in `<project_name>/` depending on preference). Choose one convention and stick to it.
+- Separate packages by concern — do not dump all classes in a single flat directory.
+- Example layout for a typical project:
+
+```
+src/myproject/
+  __init__.py           ← exports public API via __all__
+  core/                 ← domain logic, entities, services
+  cli/                  ← CLI entry points (typer/click)
+  api/                  ← HTTP API layer (if applicable)
+  config/               ← configuration models (pydantic/dataclass)
+  constants.py          ← shared constants
+  utils/                ← shared utility functions
+```
+
+- **Never create a `model.py` dumping ground.** Split types into explicit purpose modules (e.g., `entities.py`, `dto.py`, `enums.py`).
+
+### Separation of Concerns
+
+- **Core logic** lives in `core/` and has zero dependencies on CLI, HTTP, or file I/O. Pure domain logic only.
+- **CLI layer** delegates to core services — never contains business logic.
+- **Configuration** uses `pydantic.BaseModel` or `dataclasses.dataclass` for typed, validated settings loaded from environment, config files, or CLI arguments.
+
+### Dependency Management
+
+- Use **`uv`** for dependency management (recommended). Alternatives: `pip` with `requirements.txt`.
+- **Never edit `uv.lock` manually.** It is regenerated by `uv lock` or `uv sync` when dependencies change.
+- Dependencies are declared in `pyproject.toml`.
+
+### CLI Design
+
+- Use `typer` or `click` for CLI tools. For web APIs, use `fastapi` or `flask`.
+- Each command groups related operations — use subcommands for modularity.
+- CLI entry points handle argument parsing, then delegate to core services.
+- For CLI testing, use the appropriate test harness (e.g., `CliRunner`) and verify that output is captured correctly.
+
+```python
+# src/myproject/cli/main.py
+import typer
+
+
+app = typer.Typer()
+
+# ------------------------------------------------
+
+@app.command()
+def process(file: str):
+  """Process a file."""
+  result = service.process(file)
+  print(result)
+```
+
+### Exceptions
+
+- Define a custom exception hierarchy rooted in a `BaseError` (or use a library like `pydantic_core` for validation errors).
+- For HTTP APIs: return structured error responses, never let bare tracebacks leak to clients.
+- CLI entry points catch exceptions, log the error, and return a non-zero exit code.
+
+```python
+class BaseError(Exception):
+  """Base exception for application errors."""
+
+# ------------------------------------------------
+
+class NotFoundError(BaseError):
+  """Resource not found."""
+
+# ------------------------------------------------
+
+class ConflictError(BaseError):
+  """Resource conflict."""
+```
+
+## Testing Strategy
+
+- Use `pytest` as the test framework. See [`./CODE-STYLE.md`](./CODE-STYLE.md) for style rules (fixtures, parametrize, mocking, skipping, naming).
+
+### Unit Tests
+
+- Tests live in `tests/` mirroring the source structure.
+- Run unit tests: `timeout-dead --sec 60 "pytest tests/ -v --ignore=tests/integration"`.
+
+### Integration Tests
+
+- Place integration tests in `tests/integration/`. Use `@pytest.mark.integration` marker.
+- Run integration tests: `timeout-dead --sec 60 "pytest tests/integration/ -v -m \"integration\""`.
+- Run unit tests only: `timeout-dead --sec 60 "pytest tests/ -v -m \"not integration\""`.
+
+### Coverage
+
+- Aim for high coverage of core business logic. Use `pytest-cov` to measure:
+  ```bash
+  timeout-dead --sec 60 "pytest tests/ --cov=src/timeout_dead --cov-report=term-missing"
+  ```
+
+## Environment & Configuration
+
+- Use `pydantic.BaseModel` or `dataclasses.dataclass` for typed configuration classes. Use `pydantic-settings` to load `.env` into typed models.
+- Load settings from environment variables (`.env`) — never hardcode environment-specific values.
+- `.env.example` is a **committed template** — never use it directly in scripts or at runtime. It exists solely as documentation for developers.
+- `.env` is the **actual runtime file** (git-ignored). Developers copy `.env.example` to `.env` and fill in their local values.
+
+```python
+from pydantic import BaseModel
+
+
+class DatabaseConfig(BaseModel):
+  url: str
+  pool_size: int = 10
+
+# ------------------------------------------------
+
+class AppConfig(BaseModel):
+  db: DatabaseConfig
+  log_level: str = "INFO"
+```