SurfSense/surfsense_backend/app/automations/persistence/models/trigger.py
CREDO23 f0e00bd3ee chore(automation): trim docstrings to intent only
Cut the docstrings and Field(description=...) text across the entire
automations/ tree down to single-line intent statements, matching the
multi_agent_chat conciseness style:

- Module docstrings: one line stating what the file is.
- Class docstrings: deleted when the class name + module docstring
  already cover intent; kept only where they add a constraint or
  rationale not visible in the signature.
- Pydantic Field descriptions: short noun phrases / clauses, not
  full sentences. Reasoning that belonged in the design plan moved
  out of the code.
- Enum values: per-value docstrings replaced with terse inline
  comments where the meaning isn't obvious from the name.

Behaviour is unchanged. The same 33 files, same public surface, same
imports — verified by re-running the 10-point registry smoke test and
the 8-point schema round-trip / constraint suite from commits 9 and
10.

LOC: 1180 → 691 (-42%).
2026-05-26 23:01:22 +02:00

46 lines
1 KiB
Python

"""``automation_triggers`` table — one row per (automation, trigger-instance) pair."""
from __future__ import annotations
from sqlalchemy import (
TIMESTAMP,
Boolean,
Column,
Enum as SQLAlchemyEnum,
ForeignKey,
Integer,
)
from sqlalchemy.dialects.postgresql import JSONB
from app.db import BaseModel, TimestampMixin
from ..enums.trigger_type import TriggerType
class AutomationTrigger(BaseModel, TimestampMixin):
__tablename__ = "automation_triggers"
automation_id = Column(
Integer,
ForeignKey("automations.id", ondelete="CASCADE"),
nullable=False,
index=True,
)
type = Column(
SQLAlchemyEnum(TriggerType, name="automation_trigger_type"),
nullable=False,
index=True,
)
config = Column(JSONB, nullable=False)
enabled = Column(
Boolean,
nullable=False,
default=True,
server_default="true",
index=True,
)
last_fired_at = Column(TIMESTAMP(timezone=True), nullable=True)