mirror of
https://github.com/kuhyx/utils.git
synced 2026-11-22 19:32:25 +01:00
main was red on file length, the noqa ban, codespell, test naming and dart coverage; this change touches every one of those jobs. - sickdays: set_enabled is keyword-only; the panel test splits in two with shared probes; the sync wire format moves to DOCS-sync.md. - earned_time: _focus types the project as a Protocol, no noqa; the gate-maturity section moves to DOCS-maturity.md; codespell knows the `checkin` event name. - focus_project: real fixes for every noqa (local-day clocks, typed fakes, logged broad catches, split helpers). The public API that focus-guard calls keeps its signatures; their PLR0913 exemption lives in pyproject with the reason, not in noqa. - crdt-sync: pylint gets nacl/argon2, docstrings, and allows the public E2eLayout.of; _blobs moves to _e2e_blobs.py. - crdt_sync_dart: Argon2Params and the header errors move to e2e_params.dart (re-exported); tests split and reach 100% lines. - sql_drills: test helpers get a leading underscore, as in earned_time. Todo: fda71ed1 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
72 lines
2.7 KiB
Python
72 lines
2.7 KiB
Python
# Copyright (c) 2026 Krzysztof Rudnicki
|
|
"""Credited focus minutes per day: the union of every source's intervals.
|
|
|
|
Contract: union of activity intervals on the local calendar day plus the
|
|
overtime carried in from the day before (:mod:`focus_project.carry`), capped
|
|
at the active project's ``daily_minutes``; overlaps never double count; whole
|
|
minutes (floor). Time not yet lived is never credited: every interval is
|
|
clipped at "now", so an event stamped ahead of the clock (a fast phone clock)
|
|
earns only once the real clock reaches it. An unreadable registry reads as 0
|
|
(logged): fail closed.
|
|
|
|
Unbacked minutes (0.10.0): timer time the anti-cheat gate refused
|
|
(:mod:`focus_project.sources.activity`) and no other source covers, on the
|
|
local day up to "now"; carry and the cap play no part. Shown, never paid.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
from typing import TYPE_CHECKING
|
|
|
|
from focus_project import _api, _clock, carry, sources
|
|
from focus_project._errors import RegistryError
|
|
from focus_project._own import union_seconds
|
|
from focus_project.sources import activity
|
|
|
|
if TYPE_CHECKING:
|
|
from datetime import date
|
|
|
|
_LOG = logging.getLogger(__name__)
|
|
|
|
|
|
def minutes_for(day: date, now: float | None = None) -> int:
|
|
"""Minutes of focus work credited on ``day`` (0 with no project active).
|
|
|
|
``now`` (default: the clock) is the moment after which nothing counts.
|
|
"""
|
|
try:
|
|
project = _api.active(day)
|
|
except (RegistryError, OSError) as exc:
|
|
_LOG.warning("focus_project registry unreadable, 0 minutes: %s", exc)
|
|
return 0
|
|
if project is None:
|
|
return 0
|
|
moment = _clock.now() if now is None else now
|
|
return carry.balance(day, moment).counted(project.daily_on(day))
|
|
|
|
|
|
def unbacked_minutes_for(day: date, now: float | None = None) -> int:
|
|
"""Whole minutes of timer time on ``day`` that the gate did not count.
|
|
|
|
0 with no project, before :data:`~focus_project.sources.activity.BACKING_FROM`,
|
|
or with an unreadable registry (logged).
|
|
"""
|
|
try:
|
|
project = _api.active(day)
|
|
if project is None:
|
|
return 0
|
|
lo, hi = sources.day_bounds(day)
|
|
bounds = (lo, min(hi, _clock.now() if now is None else now))
|
|
unbacked = sources.clip(activity.split_timer(day, project)[1], bounds)
|
|
counted = sources.clip(sources.collect(day, project), bounds)
|
|
except (RegistryError, OSError) as exc:
|
|
_LOG.warning("focus_project registry unreadable, 0 unbacked: %s", exc)
|
|
return 0
|
|
# |unbacked minus counted| = |unbacked union counted| - |counted|.
|
|
gap = union_seconds(unbacked + counted) - union_seconds(counted)
|
|
return int(gap // 60)
|
|
|
|
|
|
__all__ = ["minutes_for", "unbacked_minutes_for", "union_seconds"]
|