timeout-dead 0.1.0__tar.gz → 0.1.2__tar.gz

timeout_dead-0.1.2/.vscode/settings.json

@@ -0,0 +1,8 @@
+{
+  "cSpell.words": [
+    "creationflags",
+    "getpgid",
+    "killpg",
+    "pgid"
+  ]
+}

{timeout_dead-0.1.0 → timeout_dead-0.1.2}/AGENTS.md

@@ -37,20 +37,32 @@ If the user asks "what should the commit message be?" — **suggest a message bu
 
 ## Workflow & Verification Commands
 
+### Setup
+
+```bash
+uv tool install timeout-dead
+```
+
+Если уже установлена — убедись что работает:
+
+```bash
+time-d -h
+```
+
 ### 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>"
+time-d --sec 60 "<your command>"
 ```
 
 Long-running daemons must use `nohup ... >/dev/null 2>&1 &` so the wrapper returns immediately.
 
-### Setup
+### Install dependencies
 
 ```bash
-timeout-dead --sec 60 "uv sync"
+time-d --sec 60 "uv sync"
 ```
 
 ### Verify after changes
@@ -58,16 +70,16 @@ timeout-dead --sec 60 "uv sync"
 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"
+time-d --sec 60 "ruff check ."
+time-d --sec 60 "ruff format --check ."
+time-d --sec 60 "pyright ."
+time-d --sec 60 "python -m pytest tests/ -v"
 ```
 
 ### Fix formatting & imports
 
 ```bash
-timeout-dead --sec 60 "ruff check --fix . && ruff format ."
+time-d --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`.
@@ -75,7 +87,7 @@ timeout-dead --sec 60 "ruff check --fix . && ruff format ."
 ### Run a single test
 
 ```bash
-timeout-dead --sec 60 "python -m pytest tests/test_file.py::test_name -v"
+time-d --sec 60 "python -m pytest tests/test_file.py::test_name -v"
 ```
 
 ### Mandatory testing
@@ -170,19 +182,19 @@ class ConflictError(BaseError):
 ### Unit Tests
 
 - Tests live in `tests/` mirroring the source structure.
-- Run unit tests: `timeout-dead --sec 60 "pytest tests/ -v --ignore=tests/integration"`.
+- Run unit tests: `time-d --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\""`.
+- Run integration tests: `time-d --sec 60 "pytest tests/integration/ -v -m \"integration\""`.
+- Run unit tests only: `time-d --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"
+  time-d --sec 60 "pytest tests/ --cov=src/timeout_dead --cov-report=term-missing"
   ```
 
 ## Environment & Configuration

{timeout_dead-0.1.0 → timeout_dead-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: timeout-dead
-Version: 0.1.0
+Version: 0.1.2
 Summary: Lightweight command timeout utility with zero runtime dependencies
 Author-email: Dmitry Krivoruchko <umbrella.leaf.for.work@gmail.com>
 License-Expression: Unlicense
@@ -77,7 +77,7 @@ timeout-dead --no-output "curl -s https://example.com"
 ## Usage
 
 ```
-usage: timeout-dead [-h] [--sec SECONDS] [--signal SIGNAL] [--no-output] COMMAND ...
+usage: timeout-dead [-h] [-v] [--sec SECONDS] [--signal SIGNAL] [--no-output] COMMAND ...
 
 Lightweight command timeout utility.
 
@@ -86,6 +86,7 @@ positional arguments:
 
 options:
   -h, --help            show this help message and exit
+  -v, --version         show version and exit
   --sec SECONDS         timeout in seconds (default: 60)
   --signal SIGNAL       signal to send on timeout (TERM, KILL, HUP, INT)
   --no-output           suppress normal output (stdout, stderr, header, footer)

{timeout_dead-0.1.0 → timeout_dead-0.1.2}/README.md

@@ -51,7 +51,7 @@ timeout-dead --no-output "curl -s https://example.com"
 ## Usage
 
 ```
-usage: timeout-dead [-h] [--sec SECONDS] [--signal SIGNAL] [--no-output] COMMAND ...
+usage: timeout-dead [-h] [-v] [--sec SECONDS] [--signal SIGNAL] [--no-output] COMMAND ...
 
 Lightweight command timeout utility.
 
@@ -60,6 +60,7 @@ positional arguments:
 
 options:
   -h, --help            show this help message and exit
+  -v, --version         show version and exit
   --sec SECONDS         timeout in seconds (default: 60)
   --signal SIGNAL       signal to send on timeout (TERM, KILL, HUP, INT)
   --no-output           suppress normal output (stdout, stderr, header, footer)

{timeout_dead-0.1.0 → timeout_dead-0.1.2}/src/timeout_dead/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.1.0'
-__version_tuple__ = version_tuple = (0, 1, 0)
+__version__ = version = '0.1.2'
+__version_tuple__ = version_tuple = (0, 1, 2)
 
-__commit_id__ = commit_id = 'g568c64836'
+__commit_id__ = commit_id = 'g92736f7f7'

{timeout_dead-0.1.0 → timeout_dead-0.1.2}/src/timeout_dead/cli.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 
-"""Легковесная утилита для запуска команд с таймаутом."""
+"""Lightweight command timeout utility."""
 
 import argparse
 import os
@@ -10,6 +10,8 @@ import subprocess
 import sys
 import threading
 import time
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import version as _get_version
 
 
 # MARK: Constants
@@ -22,7 +24,7 @@ class _Const:
   HEADER_SEPARATOR: str = "-" * 60
 
   MSG_NO_COMMAND: str = "Error: no command specified"
-  MSG_BASH_NOT_FOUND: str = "bash not found in PATH — Git Bash is required"
+  MSG_BASH_NOT_FOUND: str = "bash not found in PATH"
   MSG_TIMEOUT: str = "Timeout exceeded {} seconds"
   MSG_EXEC_ERROR: str = "Execution error: {}"
 
@@ -35,6 +37,17 @@ class _Const:
     "INT": signal.SIGINT,
   }
 
+  @staticmethod
+  def _resolve_version() -> str:
+    try:
+      return _get_version("timeout-dead")
+
+    except PackageNotFoundError:
+      return "unknown"
+
+
+_PROJECT_VERSION: str = _Const._resolve_version()
+
 
 # MARK: Private Helpers
 # ------------------------------------------------
@@ -49,13 +62,13 @@ def _is_windows() -> bool:
 
 def _find_bash() -> str:
   """
-  Ищет bash в PATH.
+  Locate bash executable in PATH.
 
   Returns:
-    str: путь к исполняемому файлу bash
+    str: path to the bash executable
 
   Raises:
-    SystemExit: если bash не найден
+    SystemExit: if bash is not found
   """
 
   bash_path = shutil.which("bash")
@@ -77,7 +90,7 @@ def _terminate_process(
   force: bool = False,
   signal_num: int = signal.SIGTERM,
 ) -> None:
-  """Завершает процесс — мягко (выбранным сигналом) или жёстко."""
+  """Terminate the process — gracefully (chosen signal) or forcefully."""
 
   if process.poll() is not None:
     return
@@ -115,7 +128,7 @@ def _kill_with_timeout(
   timeout: int,
   signal_num: int = signal.SIGTERM,
 ) -> None:
-  """Убивает процесс по таймауту с двухэтапной логикой."""
+  """Kill the process after timeout with two-stage logic."""
 
   if process.poll() is not None:
     return
@@ -140,16 +153,16 @@ def run_command(
   no_output: bool = False,
 ) -> int:
   """
-  Запускает команду с таймаутом через bash.
+  Run a command with timeout via bash.
 
   Args:
-    command_string (str): команда для выполнения
-    timeout (int): таймаут в секундах
-    signal_name (str): имя сигнала для мягкого завершения
-    no_output (bool): подавлять ли обычный вывод
+    command_string (str): command to execute
+    timeout (int): timeout in seconds
+    signal_name (str): signal name for graceful termination
+    no_output (bool): suppress normal output
 
   Returns:
-    int: код возврата процесса (-1 при ошибке запуска)
+    int: process return code (-1 on launch error)
   """
 
   signal_num = _Const.SIGNAL_MAP.get(signal_name, signal.SIGTERM)
@@ -157,7 +170,7 @@ def run_command(
   timer: threading.Timer | None = None
 
   try:
-    creationflags = subprocess.CREATE_NEW_PROCESS_GROUP if _is_windows() else 0
+    creationflags = getattr(subprocess, "CREATE_NEW_PROCESS_GROUP", 0) if _is_windows() else 0
     start_new_session = not _is_windows()
 
     process = subprocess.Popen(
@@ -190,6 +203,7 @@ def run_command(
   except Exception as e:
     if timer:
       timer.cancel()
+
     if process and process.poll() is None:
       try:
         _terminate_process(process, force=True)
@@ -206,13 +220,20 @@ def run_command(
 
 
 def parse_arguments(argv: list[str] | None = None) -> argparse.Namespace:
-  """Разбирает аргументы командной строки."""
+  """Parse command-line arguments."""
 
   parser = argparse.ArgumentParser(
     description="Lightweight command timeout utility.",
     formatter_class=argparse.RawDescriptionHelpFormatter,
   )
 
+  parser.add_argument(
+    "-v",
+    "--version",
+    action="version",
+    version=f"timeout-dead {_PROJECT_VERSION}",
+  )
+
   parser.add_argument(
     "--sec",
     type=int,
@@ -251,7 +272,7 @@ def parse_arguments(argv: list[str] | None = None) -> argparse.Namespace:
 
 
 def print_header(command: str, timeout: int) -> None:
-  """Выводит заголовок выполнения."""
+  """Print execution header."""
 
   print(f"Running: {command}")
   print(f"Timeout: {timeout} seconds")
@@ -262,7 +283,7 @@ def print_header(command: str, timeout: int) -> None:
 
 
 def print_footer(return_code: int) -> None:
-  """Выводит футер выполнения."""
+  """Print execution footer."""
 
   print(_Const.HEADER_SEPARATOR)
   print(f"Exit code: {return_code}")
@@ -272,7 +293,7 @@ def print_footer(return_code: int) -> None:
 
 
 def main(argv: list[str] | None = None) -> None:
-  """Главная точка входа."""
+  """Main entry point."""
 
   args = parse_arguments(argv)
 

{timeout_dead-0.1.0 → timeout_dead-0.1.2}/src/timeout_dead.egg-info/SOURCES.txt

@@ -13,6 +13,7 @@ uv.lock
 .github/workflows/pyright.yml
 .github/workflows/ruff.yml
 .github/workflows/tests.yml
+.vscode/settings.json
 src/timeout_dead/__init__.py
 src/timeout_dead/_version.py
 src/timeout_dead/cli.py

{timeout_dead-0.1.0 → timeout_dead-0.1.2}/tests/conftest.py

@@ -9,7 +9,7 @@ import pytest
 
 @pytest.fixture
 def temp_dir() -> Iterator[Path]:
-  """Временная директория для тестов."""
+  """Temporary directory for tests."""
 
   with tempfile.TemporaryDirectory() as tmp:
     yield Path(tmp)

{timeout_dead-0.1.0 → timeout_dead-0.1.2}/tests/test_cli.py

@@ -1,4 +1,4 @@
-"""Тесты CLI утилиты timeout-dead."""
+"""Tests for timeout-dead CLI utility."""
 
 import os
 import signal
@@ -30,7 +30,7 @@ def _run_cli(
   *args: str,
   timeout: int = 10,
 ) -> subprocess.CompletedProcess[str]:
-  """Запускает timeout-dead как subprocess."""
+  """Run timeout-dead as a subprocess."""
 
   return subprocess.run(
     [sys.executable, "-m", "timeout_dead.cli", *args],
@@ -245,7 +245,7 @@ class TestSignalSelection:
     reason="SIGINT file-based test requires Unix signal handling",
   )
   def test_signal_int_handling(self, tmp_path: Path) -> None:
-    """Python-скрипт ловит SIGINT и записывает номер сигнала в файл."""
+    """Python script catches SIGINT and writes signal number to file."""
 
     marker = tmp_path / "signal.txt"
     script_path = tmp_path / "handler.py"
@@ -395,6 +395,21 @@ class TestIntegration:
     assert "--sec" in result.stdout
     assert "--signal" in result.stdout
     assert "--no-output" in result.stdout
+    assert "--version" in result.stdout
+
+  # ------------------------------------------------
+
+  def test_cli_version_long(self) -> None:
+    result = _run_cli("--version")
+    assert result.returncode == 0
+    assert "timeout-dead" in result.stdout
+
+  # ------------------------------------------------
+
+  def test_cli_version_short(self) -> None:
+    result = _run_cli("-v")
+    assert result.returncode == 0
+    assert "timeout-dead" in result.stdout
 
   # ------------------------------------------------