Struct Config 

pub struct Config {
    pub bird_root: PathBuf,
    pub client_id: String,
    pub hot_days: u32,
    pub inline_threshold: usize,
    pub auto_extract: bool,
    pub storage_mode: StorageMode,
    pub remotes: Vec<RemoteConfig>,
    pub sync: SyncConfig,
    pub hooks: HooksConfig,
}

BIRD configuration.

Fields

bird_root: PathBuf

Root directory for all BIRD data.

client_id: String

Client identifier for this machine.

hot_days: u32

Days to keep data in hot tier before archiving.

inline_threshold: usize

Threshold in bytes for inline vs blob storage.

auto_extract: bool

Automatically extract events after shq run commands.

storage_mode: StorageMode

Storage mode for writing data.

• parquet: Multi-writer safe, requires compaction (default)
• duckdb: Single-writer, no compaction needed

remotes: Vec<RemoteConfig>

Remote storage configurations.

sync: SyncConfig

Sync configuration for push/pull operations.

hooks: HooksConfig

Shell hook configuration.

Implementations

impl Config

pub fn with_root(bird_root: impl Into<PathBuf>) -> Self

Create a new config with the given BIRD_ROOT.

pub fn with_duckdb_mode(bird_root: impl Into<PathBuf>) -> Self

Create a new config with DuckDB storage mode.

pub fn default_location() -> Result<Self>

Create a config using default BIRD_ROOT resolution.

pub fn load() -> Result<Self>

Load config from BIRD_ROOT/config.toml, or create default.

pub fn load_from(bird_root: &Path) -> Result<Self>

Load config from a specific BIRD_ROOT.

pub fn save(&self) -> Result<()>

Save config to BIRD_ROOT/config.toml.

pub fn db_path(&self) -> PathBuf

Path to the DuckDB database file.

pub fn data_dir(&self) -> PathBuf

Path to the data directory.

pub fn recent_dir(&self) -> PathBuf

Path to the recent (hot) data directory.

pub fn archive_dir(&self) -> PathBuf

Path to the archive (cold) data directory.

pub fn invocations_dir(&self, date: &NaiveDate) -> PathBuf

Path to invocations parquet files for a given date.

pub fn outputs_dir(&self, date: &NaiveDate) -> PathBuf

Path to outputs parquet files for a given date.

pub fn sessions_dir(&self, date: &NaiveDate) -> PathBuf

Path to sessions parquet files for a given date.

pub fn sql_dir(&self) -> PathBuf

Path to the SQL files directory.

pub fn extensions_dir(&self) -> PathBuf

Path to the DuckDB extensions directory.

pub fn blobs_dir(&self) -> PathBuf

Path to the blobs content directory.

pub fn blob_path(&self, hash: &str, cmd_hint: &str) -> PathBuf

Path to a specific blob file by hash and command.

pub fn event_formats_path(&self) -> PathBuf

Path to the event-formats.toml config file (legacy).

pub fn format_hints_path(&self) -> PathBuf

Path to the format-hints.toml config file.

pub fn events_dir(&self, date: &NaiveDate) -> PathBuf

Path to events parquet files for a given date.

pub fn get_remote(&self, name: &str) -> Option<&RemoteConfig>

Get a remote by name.

pub fn add_remote(&mut self, remote: RemoteConfig)

Add a remote configuration.

pub fn remove_remote(&mut self, name: &str) -> bool

Remove a remote by name. Returns true if removed.

pub fn blob_roots(&self) -> Vec<String>

Get all blob roots for multi-location resolution. Returns local blobs dir first, then remote blob URLs.

pub fn auto_attach_remotes(&self) -> Vec<&RemoteConfig>

Get remotes that should be auto-attached.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Config

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.