Struct PhotonBuilder 

pub struct PhotonBuilder { /* private fields */ }

Builder for constructing Photon runtimes — Integrating the host.

Example

use photon_runtime::Photon;

let _photon = Photon::builder().auto_registry().build()?;

Implementations

impl PhotonBuilder

pub fn storage_port(self, port: Arc<dyn StoragePort>) -> Self

Explicit storage port (defaults to in-process mem tier).

Example

use std::sync::Arc;

use photon_backend::{InProcStoragePort, StoragePort, TransportCrypto};
use photon_runtime::Photon;

let port: Arc<dyn StoragePort> = Arc::new(InProcStoragePort::new(
    TransportCrypto::from_env()?,
));
let _photon = Photon::builder().storage_port(port).auto_registry().build()?;

pub fn backend(self, backend: Arc<dyn PhotonBackend>) -> Self

Pre-built backend instance.

pub fn backend_with_context<F>(self, install: F) -> Self

where F: FnOnce(BackendContext) -> Result<Arc<dyn PhotonBackend>> + Send + 'static,

Build backend from shared BackendContext (typical for custom install fns).

pub fn mem_backend(self) -> Self

Shorthand for Self::backend_with_context.

pub fn ops_log(self, log: impl OpsLog + 'static) -> Self

Install a concrete OpsLog adapter before build.

pub fn ops_log_arc(self, log: Arc<dyn OpsLog>) -> Self

Install a shared OpsLog trait object before build.

pub const fn auto_registry(self) -> Self

Discover #[photon::topic] descriptors via Quark inventory instead of an empty registry.

Required when using #[topic] / #[subscribe] in the same crate graph as the host. Runnable: cargo run -p uf-photon --example embedded_mem --features runtime,mem.

pub fn retention_policy(self, policy: RetentionPolicy) -> Self

Override default retention policy (env fallbacks apply for unset fields).

pub fn retention_hook(self, hook: Arc<dyn RetentionHook>) -> Self

Host hook for extra subscriptions and legal-hold floors.

pub fn build(self) -> Result<Photon>

Assemble the Photon runtime.

Errors

Returns an error if the operation fails.

Trait Implementations

impl Default for PhotonBuilder

fn default() -> PhotonBuilder

Returns the “default value” for a type.