feat: initial release — traefik, unifi, ups plugins

First-party plugins for Fabled Scryer (https://github.com/bvandeusen/fabledscryer).

traefik: Prometheus metrics scraping, stats history, access log parsing (GeoIP optional)
unifi:   UniFi controller integration — WAN health, devices, clients, DPI, events
ups:     UPS monitoring via NUT (Network UPS Tools), Ansible shutdown automation

Each plugin follows the Fabled Scryer plugin contract:
  setup(app), get_scheduled_tasks(), get_blueprint()

index.yaml lists all three plugins in the catalog format. Populate
checksum_sha256 entries once release zips are published via GitHub Releases.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-22 18:28:43 -04:00
commit ad4fcd1cfd
50 changed files with 4808 additions and 0 deletions
View File
+72
View File
@@ -0,0 +1,72 @@
# plugins/ups/migrations/env.py
"""Alembic env.py for the UPS plugin (standalone dev use).
At app startup, migration_runner.py uses the core env.py with version_locations.
"""
import asyncio
import os
import sys
from pathlib import Path
from logging.config import fileConfig
from sqlalchemy import pool
from sqlalchemy.engine import Connection
from sqlalchemy.ext.asyncio import async_engine_from_config
from alembic import context
sys.path.insert(0, str(Path(__file__).parent.parent.parent.parent))
from fabledscryer.models.base import Base
import fabledscryer.models # noqa: F401
from plugins.ups.models import UpsStatus # noqa: F401
config = context.config
if config.config_file_name is not None:
fileConfig(config.config_file_name)
target_metadata = Base.metadata
def _get_url() -> str:
import yaml
cfg_path = os.environ.get("FABLEDSCRYER_CONFIG", "config.yaml")
try:
with open(cfg_path) as f:
cfg = yaml.safe_load(f) or {}
url = cfg.get("database", {}).get("url", "")
except FileNotFoundError:
url = ""
return os.environ.get("FABLEDSCRYER_DATABASE__URL", url)
def run_migrations_offline() -> None:
context.configure(
url=_get_url(), target_metadata=target_metadata,
literal_binds=True, dialect_opts={"paramstyle": "named"},
)
with context.begin_transaction():
context.run_migrations()
def do_run_migrations(connection: Connection) -> None:
context.configure(connection=connection, target_metadata=target_metadata)
with context.begin_transaction():
context.run_migrations()
async def run_async_migrations() -> None:
cfg = config.get_section(config.config_ini_section, {})
cfg["sqlalchemy.url"] = _get_url()
connectable = async_engine_from_config(cfg, prefix="sqlalchemy.", poolclass=pool.NullPool)
async with connectable.connect() as connection:
await connection.run_sync(do_run_migrations)
await connectable.dispose()
def run_migrations_online() -> None:
asyncio.run(run_async_migrations())
if context.is_offline_mode():
run_migrations_offline()
else:
run_migrations_online()
View File
@@ -0,0 +1,40 @@
"""UPS plugin initial tables
Revision ID: ups_001_initial
Revises: (none — branch off core via depends_on)
Create Date: 2026-03-21
"""
from typing import Sequence, Union
from alembic import op
import sqlalchemy as sa
revision: str = "ups_001_initial"
down_revision: Union[str, None] = None
branch_labels: Union[str, Sequence[str], None] = "ups"
depends_on: Union[str, Sequence[str], None] = ("0004_app_settings",)
def upgrade() -> None:
op.create_table(
"ups_status",
sa.Column("id", sa.String(36), primary_key=True),
sa.Column("scraped_at", sa.DateTime(timezone=True), nullable=False),
sa.Column("raw_status", sa.String(64), nullable=False, server_default=""),
sa.Column("on_battery", sa.Boolean, nullable=False, server_default="false"),
sa.Column("low_battery", sa.Boolean, nullable=False, server_default="false"),
sa.Column("battery_charge_pct", sa.Float, nullable=True),
sa.Column("battery_runtime_secs", sa.Integer, nullable=True),
sa.Column("battery_voltage", sa.Float, nullable=True),
sa.Column("load_pct", sa.Float, nullable=True),
sa.Column("input_voltage", sa.Float, nullable=True),
sa.Column("output_voltage", sa.Float, nullable=True),
sa.Column("temperature", sa.Float, nullable=True),
sa.Column("model", sa.String(128), nullable=True),
sa.Column("manufacturer", sa.String(128), nullable=True),
)
op.create_index("ix_ups_status_scraped", "ups_status", ["scraped_at"])
def downgrade() -> None:
op.drop_index("ix_ups_status_scraped", "ups_status")
op.drop_table("ups_status")