signal-bot/pyproject.toml
Krzysztof kuhy Rudnicki 405541be9b
Some checks are pending
CI / check (push) Waiting to run
CI / web (push) Waiting to run
release: 0.2.6 «Stephanus I» — dodano !analityka
One row per command attempt, not two aggregates written only on success.

command_uses holds last-use only and daily_uses counts successes; both are
rate-limiter state and both are written by store.record_use, which the
dispatcher calls only when a handler returns cleanly. A gate refusal and a
crash returned before it, so a command that failed every time looked exactly
like one nobody ran, and nothing knew which command a counted message was.

command_events now takes every attempt with its outcome, its duration and
the item it served; upstream_calls takes every outbound request made while
serving one. The two writes stay separate on purpose -- recording a refusal
as a use is what slid the cooldown window forward every time somebody was
told to wait -- and test_dispatcher_outcomes asserts last_used does not move.

Backfilled from journald joined against message_events, with daily_uses
filling the residual so the two sources cannot double-count. Two things were
wrong on the first attempt and both were found by measuring rather than by
reasoning: the window has to be symmetric, because sent_at_ms comes from the
sender's phone and the journal stamp from this host (194 of 299 lines landed
*before* their own message, by up to 3.2 s); and matching has to be a global
closest-pair assignment, because per-row greedy cannot separate two commands
seconds apart. Together those took the dropped rows from 137 to zero, and
recovered 418 invocations back to 29 August.

Also: !analityka in the group, twelve Polish lines, naming at most three
people and only ones whose display name has been seen; an Analytics tab with
Nivo charts; and continuous latency measurement, which answers the open
question in DOCS-latency.md -- a text send is 235 ms and an image send about
2.2 s, so the upload really is where the time goes.

EPHEMERAL_TABLES was doing two unrelated jobs and is now two tuples: what a
schema bump rebuilds, and what leaving a group clears. daily_uses left the
first (it is a backfill source now) and stayed in the second, and
_drop_reshaped took over the repair a bump used to do for it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T4QTp3h5Q3MvfrwGV8xqPf
2026-08-31 23:19:51 +02:00

155 lines
4.9 KiB
TOML

[project]
name = "signal-bot"
version = "0.2.6"
description = "A Signal group bot: image commands and daily message tallies."
readme = "README.md"
license = "MIT"
license-files = ["LICENSE"]
requires-python = ">=3.14"
# Exact pins, newest stable, per the dependency-freshness rule. A caret range
# is "newest-compatible" by definition and gives the freshness gate nothing to
# compare against.
dependencies = [
"fastapi==0.141.1",
"httpx==0.28.1",
"python-dotenv==1.2.3",
"PyYAML==6.0.3",
"uvicorn==0.52.4",
"websockets==17.1",
]
[project.optional-dependencies]
dev = [
"mypy==2.3.1",
"pre-commit==4.6.2",
"pytest==9.1.1",
"pytest-asyncio==1.4.0",
"pytest-cov==7.1.0",
"ruff==0.16.5",
"types-PyYAML==6.0.12.20260815",
]
[project.scripts]
signal-bot = "signal_bot.__main__:main"
[build-system]
requires = ["setuptools==84.0.0"]
build-backend = "setuptools.build_meta"
[tool.setuptools]
packages = ["signal_bot", "fake_signal"]
# ============================================================================
# RUFF
# ============================================================================
[tool.ruff]
target-version = "py314"
line-length = 100
[tool.ruff.lint]
select = ["ALL"]
ignore = [
"D203", # conflicts with D211, we use D211
"D213", # conflicts with D212, we use D212
"COM812", # formatter owns trailing commas
"ISC001", # formatter may create implicit string concatenation
]
fixable = ["ALL"]
# Verified empirically, not copied: with this block removed, ruff reports
# exactly these four rules across tests/ and nothing else. SLF001 was in
# the original list and fired zero times, so it is gone.
[tool.ruff.lint.isort]
# venv_bootstrap sets up .venv as a side effect of being imported, so it has
# to be imported before anything that lives in .venv. Left to its own devices
# isort sorts it alphabetically -- after fastapi and httpx -- which silently
# breaks the thing it exists to do. Giving it its own section ahead of the
# standard library makes the formatter enforce the order instead of undoing
# it, which is better than a comment asking people not to reformat.
section-order = [
"future",
"bootstrap",
"standard-library",
"third-party",
"first-party",
"local-folder",
]
[tool.ruff.lint.isort.sections]
bootstrap = ["venv_bootstrap"]
[tool.ruff.lint.per-file-ignores]
# The single subprocess in this repository. S603 flags every subprocess call
# and has no code-level fix -- exiftool is a binary, and the pure-Python EXIF
# libraries handle neither HEIC nor MP4. signal_bot/external.py exists so this
# entry can name exactly one file: any other module that shells out fails the
# gate, which is the point. Do not widen this to a directory.
"signal_bot/external.py" = ["S603"]
# The bootstrap that installs .venv. It cannot route through external.py --
# that module lives inside the package it is installing -- so it is the one
# other place allowed to start a process. Kept to a single small file for
# exactly that reason. kuhy's call, 2026-08-31. Do not widen to a directory.
"tool/venv_bootstrap.py" = ["S603", "S606"]
"tests/**/*.py" = [
"ARG", # fixture and mock params exist for their side effect
"D", # test names are the documentation
"PLR2004", # `assert count == 2` beats a named constant
"S101", # assert IS what tests do
]
[tool.ruff.lint.pylint]
# The test envelope builder takes 7 keyword-only fields, one per envelope
# attribute. Splitting it into a dataclass would only move the count.
max-args = 7
[tool.ruff.lint.pydocstyle]
convention = "google"
[tool.ruff.lint.flake8-quotes]
docstring-quotes = "double"
inline-quotes = "double"
[tool.ruff.lint.flake8-tidy-imports]
ban-relative-imports = "all"
[tool.ruff.format]
quote-style = "double"
docstring-code-format = true
# ============================================================================
# MYPY
# ============================================================================
[tool.mypy]
python_version = "3.14"
strict = true
warn_unreachable = true
disallow_any_explicit = false
# ============================================================================
# PYTEST / COVERAGE
# ============================================================================
[tool.pytest.ini_options]
testpaths = ["tests"]
asyncio_mode = "auto"
asyncio_default_fixture_loop_scope = "function"
addopts = [
"--cov=signal_bot",
"--cov=fake_signal",
"--cov-branch",
"--cov-report=term-missing",
"--cov-fail-under=100",
"--strict-markers",
]
[tool.coverage.run]
branch = true
# No omits. Every line of both packages is covered by tests.
[tool.coverage.report]
# No "pragma: no cover" escape hatch: nothing in this repo uses one, and
# leaving the pattern configured is an invitation to hide code from the
# 100% gate later. TYPE_CHECKING bodies are genuinely never executed.
exclude_lines = ["if TYPE_CHECKING:"]
show_missing = true