Mirrors the decnet.intel layout (base + factory + lazy concrete imports). Defines: - CanaryArtifact / CanaryContext dataclasses + the generator and instrumenter ABCs they share - factory dispatch for generators (git_config/env_file/ssh_key/ aws_creds/honeydoc) and instrumenters (docx/xlsx/pdf/html/image/ plain/passthrough), plus pick_instrumenter_for_mime() for MIME-driven dispatch on operator uploads - persona-aware default placement paths (Linux vs. Windows-shaped) and absolute-path validation that the API will use to validate operator-supplied placement_path values - on-disk blob store: sha256-keyed two-level fan-out, idempotent writes, refcount-aware unlink (the DB row is the source of truth) Also covers prior commits' tests (bus topics, models, repo CRUD) under tests/canary/. 79 tests, all pass.
38 lines
1.0 KiB
Python
38 lines
1.0 KiB
Python
"""Canary tokens — decoy artifacts planted in decky filesystems.
|
|
|
|
Public surface is exported here so callers can ``from decnet.canary
|
|
import CanaryArtifact, get_generator, get_instrumenter`` without
|
|
knowing the submodule layout. Concrete generators / instrumenters
|
|
live under :mod:`decnet.canary.generators` and
|
|
:mod:`decnet.canary.instrumenters` respectively; the factory keeps
|
|
import-time cost down by deferring those imports until first use
|
|
(same pattern as :mod:`decnet.intel.factory`).
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from decnet.canary.base import (
|
|
CanaryArtifact,
|
|
CanaryContext,
|
|
CanaryGenerator,
|
|
CanaryInstrumenter,
|
|
)
|
|
from decnet.canary.factory import (
|
|
KNOWN_GENERATORS,
|
|
KNOWN_INSTRUMENTERS,
|
|
get_generator,
|
|
get_instrumenter,
|
|
pick_instrumenter_for_mime,
|
|
)
|
|
|
|
__all__ = [
|
|
"CanaryArtifact",
|
|
"CanaryContext",
|
|
"CanaryGenerator",
|
|
"CanaryInstrumenter",
|
|
"KNOWN_GENERATORS",
|
|
"KNOWN_INSTRUMENTERS",
|
|
"get_generator",
|
|
"get_instrumenter",
|
|
"pick_instrumenter_for_mime",
|
|
]
|