mostlyright-data 0.9.0__py3-none-any.whl

mostlyright/data_harness/__init__.py

@@ -0,0 +1,158 @@
+"""Local-first question-to-Parquet data harness with a closed lazy public surface."""
+
+from importlib import import_module as _import_module
+from importlib import metadata as _metadata
+from typing import Any as _Any
+
+_LAZY_EXPORTS: dict[str, tuple[str, str]] = {
+    "BackfillCoverageEnvelope": ("recipe", "BackfillCoverageEnvelope"),
+    "BackfillPartitionScope": ("recipe", "BackfillPartitionScope"),
+    "BackfillPolicy": ("recipe", "BackfillPolicy"),
+    "BuildError": ("pipeline", "BuildError"),
+    "BuildResult": ("pipeline", "BuildResult"),
+    "CandidateInspection": ("pipeline", "CandidateInspection"),
+    "CanonicalJSONError": ("canonical", "CanonicalJSONError"),
+    "ContractError": ("contracts", "ContractError"),
+    "TablePlan": ("contracts", "TablePlan"),
+    "FrozenRecipe": ("recipe", "FrozenRecipe"),
+    "LocalQuestion": ("local_contracts", "LocalQuestion"),
+    "LocalRequirements": ("local_contracts", "LocalRequirements"),
+    "OfflineExecutionResult": ("offline", "OfflineExecutionResult"),
+    "OfflineInputs": ("offline", "OfflineInputs"),
+    "OfflinePackageContext": ("pipeline", "OfflinePackageContext"),
+    "OfflineRunError": ("offline", "OfflineRunError"),
+    "OutputGrain": ("local_contracts", "OutputGrain"),
+    "PINNED_CONTRACT_SET": ("studio_boundary", "PINNED_CONTRACT_SET"),
+    "PINNED_CONTRACT_VERSION": ("studio_boundary", "PINNED_CONTRACT_VERSION"),
+    "PINNED_OPENAPI_SOURCE_SHA256": ("studio_boundary", "PINNED_OPENAPI_SOURCE_SHA256"),
+    "RecipeApproval": ("recipe", "RecipeApproval"),
+    "RecipeError": ("recipe", "RecipeError"),
+    "RecipeExecution": ("recipe", "RecipeExecution"),
+    "RecipeNoNewRun": ("recipe", "RecipeNoNewRun"),
+    "RecipeRunResult": ("recipe", "RecipeRunResult"),
+    "RecipeSource": ("recipe", "RecipeSource"),
+    "ResourceLimits": ("pipeline", "ResourceLimits"),
+    "ReviewError": ("review", "ReviewError"),
+    "ReviewResult": ("review", "ReviewResult"),
+    "SourceProposal": ("local_contracts", "SourceProposal"),
+    "StudioBoundaryError": ("studio_boundary", "StudioBoundaryError"),
+    "StudioClientIncompatibleError": ("studio_boundary", "StudioClientIncompatibleError"),
+    "StudioClientUnavailableError": ("studio_boundary", "StudioClientUnavailableError"),
+    "build_candidate": ("pipeline", "build_candidate"),
+    "canonical_json_bytes": ("canonical", "canonical_json_bytes"),
+    "canonical_sha256": ("canonical", "canonical_sha256"),
+    "execute_recipe": ("recipe", "execute_recipe"),
+    "execute_recipe_with_adapters": ("recipe", "execute_recipe_with_adapters"),
+    "init_workspace": ("offline", "init_workspace"),
+    "inspect_candidate": ("pipeline", "inspect_candidate"),
+    "inspect_workspace": ("offline", "inspect_workspace"),
+    "load_offline_inputs": ("offline", "load_offline_inputs"),
+    "parse_backfill_policy": ("recipe", "parse_backfill_policy"),
+    "parse_canonical_json": ("canonical", "parse_canonical_json"),
+    "parse_frozen_recipe": ("recipe", "parse_frozen_recipe"),
+    "parse_json": ("canonical", "parse_json"),
+    "parse_plan": ("contracts", "parse_plan"),
+    "parse_question": ("local_contracts", "parse_question"),
+    "parse_recipe_approval": ("recipe", "parse_recipe_approval"),
+    "parse_recipe_execution": ("recipe", "parse_recipe_execution"),
+    "parse_requirements": ("local_contracts", "parse_requirements"),
+    "parse_source_proposal": ("local_contracts", "parse_source_proposal"),
+    "plan_workspace": ("offline", "plan_workspace"),
+    "resume_workspace": ("offline", "resume_workspace"),
+    "run_workspace": ("offline", "run_workspace"),
+    "status_workspace": ("offline", "status_workspace"),
+    "verify_candidate": ("pipeline", "verify_candidate"),
+    "verify_recipe_candidate": ("recipe", "verify_recipe_candidate"),
+}
+
+
+def package_version() -> str:
+    """Return the installed distribution version or an honest source-tree fallback."""
+
+    try:
+        return _metadata.version("mostlyright-data")
+    except _metadata.PackageNotFoundError:
+        return "uninstalled"
+
+
+__version__ = package_version()
+
+
+def __getattr__(name: str) -> _Any:
+    """Resolve one declared public export on first use and cache its exact object."""
+
+    coordinate = _LAZY_EXPORTS.get(name)
+    if coordinate is None:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+    module_name, attribute_name = coordinate
+    value = getattr(_import_module(f"{__name__}.{module_name}"), attribute_name)
+    globals()[name] = value
+    return value
+
+
+def __dir__() -> list[str]:
+    return sorted(set(globals()) | set(__all__))
+
+
+__all__ = [
+    "PINNED_CONTRACT_SET",
+    "PINNED_CONTRACT_VERSION",
+    "PINNED_OPENAPI_SOURCE_SHA256",
+    "BackfillCoverageEnvelope",
+    "BackfillPartitionScope",
+    "BackfillPolicy",
+    "BuildError",
+    "BuildResult",
+    "CandidateInspection",
+    "CanonicalJSONError",
+    "ContractError",
+    "FrozenRecipe",
+    "LocalQuestion",
+    "LocalRequirements",
+    "OfflineExecutionResult",
+    "OfflineInputs",
+    "OfflinePackageContext",
+    "OfflineRunError",
+    "OutputGrain",
+    "RecipeApproval",
+    "RecipeError",
+    "RecipeExecution",
+    "RecipeNoNewRun",
+    "RecipeRunResult",
+    "RecipeSource",
+    "ResourceLimits",
+    "ReviewError",
+    "ReviewResult",
+    "SourceProposal",
+    "StudioBoundaryError",
+    "StudioClientIncompatibleError",
+    "StudioClientUnavailableError",
+    "TablePlan",
+    "__version__",
+    "build_candidate",
+    "canonical_json_bytes",
+    "canonical_sha256",
+    "execute_recipe",
+    "execute_recipe_with_adapters",
+    "init_workspace",
+    "inspect_candidate",
+    "inspect_workspace",
+    "load_offline_inputs",
+    "package_version",
+    "parse_backfill_policy",
+    "parse_canonical_json",
+    "parse_frozen_recipe",
+    "parse_json",
+    "parse_plan",
+    "parse_question",
+    "parse_recipe_approval",
+    "parse_recipe_execution",
+    "parse_requirements",
+    "parse_source_proposal",
+    "plan_workspace",
+    "resume_workspace",
+    "run_workspace",
+    "status_workspace",
+    "verify_candidate",
+    "verify_recipe_candidate",
+]

mostlyright/data_harness/acquisition/__init__.py

@@ -0,0 +1,55 @@
+"""Safe source-acquisition boundary."""
+
+from mostlyright.data_harness.acquisition.http import (
+    AcquisitionLimiter,
+    PinnedHttpsRetriever,
+    PinnedTransport,
+    RetrievalHop,
+    RetrievalLimits,
+    RetrievedBytes,
+    StdlibPinnedTransport,
+    TransportResponse,
+    seal_content_addressed_snapshot,
+)
+from mostlyright.data_harness.acquisition.parsing import (
+    ParsedTable,
+    ParseLimits,
+    parse_tabular_bytes,
+)
+from mostlyright.data_harness.acquisition.sandbox import (
+    CrawlerSandbox,
+    SandboxResult,
+    sandbox_policy_digest,
+)
+from mostlyright.data_harness.acquisition.url_policy import (
+    AcquisitionSecurityError,
+    EgressPolicy,
+    SystemResolver,
+    ValidatedTarget,
+    require_approved_peer,
+    validate_public_https_url,
+)
+
+__all__ = [
+    "AcquisitionLimiter",
+    "AcquisitionSecurityError",
+    "CrawlerSandbox",
+    "EgressPolicy",
+    "ParseLimits",
+    "ParsedTable",
+    "PinnedHttpsRetriever",
+    "PinnedTransport",
+    "RetrievalHop",
+    "RetrievalLimits",
+    "RetrievedBytes",
+    "SandboxResult",
+    "StdlibPinnedTransport",
+    "SystemResolver",
+    "TransportResponse",
+    "ValidatedTarget",
+    "parse_tabular_bytes",
+    "require_approved_peer",
+    "sandbox_policy_digest",
+    "seal_content_addressed_snapshot",
+    "validate_public_https_url",
+]