Struct OmnigraphConfig 

pub struct OmnigraphConfig {
    pub project: ProjectConfig,
    pub graphs: BTreeMap<String, TargetConfig>,
    pub server: ServerDefaults,
    pub auth: AuthDefaults,
    pub cli: CliDefaults,
    pub query: QueryDefaults,
    pub aliases: BTreeMap<String, AliasConfig>,
    pub policy: PolicySettings,
    pub queries: BTreeMap<String, QueryEntry>,
    /* private fields */
}

Fields

project: ProjectConfig

graphs: BTreeMap<String, TargetConfig>

server: ServerDefaults

auth: AuthDefaults

cli: CliDefaults

query: QueryDefaults

aliases: BTreeMap<String, AliasConfig>

policy: PolicySettings

queries: BTreeMap<String, QueryEntry>

Top-level stored-query registry, used in single-graph mode — mirrors how the top-level policy applies to the single graph. In multi-graph mode this is unused; each graph’s graphs.<id>.queries applies instead.

Implementations

impl OmnigraphConfig

pub fn base_dir(&self) -> &Path

pub fn cli_branch(&self) -> &str

pub fn cli_output_format(&self) -> ReadOutputFormat

pub fn table_max_column_width(&self) -> usize

pub fn table_cell_layout(&self) -> TableCellLayout

pub fn cli_graph_name(&self) -> Option<&str>

pub fn server_graph_name(&self) -> Option<&str>

pub fn server_bind(&self) -> &str

pub fn resolve_target_name<'a>( &self, explicit_uri: Option<&str>, explicit_target: Option<&'a str>, default_target: Option<&'a str>, ) -> Option<&'a str>

pub fn graph_bearer_token_env( &self, explicit_uri: Option<&str>, explicit_target: Option<&str>, default_target: Option<&str>, ) -> Option<&str>

pub fn resolve_auth_env_file(&self) -> Option<PathBuf>

pub fn resolve_policy_file(&self) -> Option<PathBuf>

pub fn resolve_target_policy_file(&self, target_name: &str) -> Option<PathBuf>

Resolve the per-graph policy file path for the named target, relative to the config file’s base_dir. Returns None if the target is unknown or no per-graph policy.file is set.

pub fn query_entries(&self) -> &BTreeMap<String, QueryEntry>

The top-level stored-query registry entries (single-graph mode).

pub fn target_query_entries( &self, target_name: &str, ) -> Option<&BTreeMap<String, QueryEntry>>

The per-graph stored-query registry entries for a named target (multi-graph mode). Returns None if the target is unknown.

pub fn query_entries_for( &self, graph: Option<&str>, ) -> &BTreeMap<String, QueryEntry>

The stored-query registry entries that apply for a graph selection — the single definition of “which queries: block governs graph X”, shared by server boot and the CLI so the two can’t drift. A named graph present in graphs: uses its per-graph block; everything else (no selection, or a name that is not a known graph, e.g. a bare URI) falls back to the top-level block (single-graph mode).

pub fn resolve_graph_selection<'a>( &self, graph: Option<&'a str>, ) -> Result<Option<&'a str>>

The single CLI gate that turns a raw graph selection into a validated one — the fallible counterpart to the infallible OmnigraphConfig::query_entries_for. Both queries subcommands route their selection through here so neither can skip a check the other (or server boot) applies:

• a known name passes through, but only after the same coherence check server boot enforces (OmnigraphConfig::ensure_top_level_blocks_honored) — a named graph with a populated top-level block is rejected;
• an unknown name errors with the same message OmnigraphConfig::resolve_target_uri produces, so a command that opens no URI rejects an unknown --target exactly like the URI-resolving commands do;
• an anonymous selection (None, e.g. a bare URI) stays anonymous, resolving to the top-level registry downstream (top-level honored).

pub fn resolve_policy_tooling_graph_selection(&self) -> Result<Option<&str>>

pub fn resolve_policy_file_for(&self, graph: Option<&str>) -> Option<PathBuf>

The policy file that applies for a graph selection — the policy sibling of OmnigraphConfig::query_entries_for, so policy and queries resolve by the same identity rule. A named graph in graphs: uses its per-graph policy.file with no top-level fallback (a named graph with no per-graph policy has no policy — that keeps the boot-time coherence check meaningful); anything else (no selection, or a bare URI) uses the top-level policy.file.

pub fn populated_top_level_blocks(&self) -> Vec<&'static str>

Names of any top-level config blocks (policy.file, queries:) that are populated. Used by the boot-time coherence check: when a named graph is served (single-mode by name, or multi-mode), the top-level blocks are not honored, so a populated one is a configuration error rather than a silent no-op.

pub fn ensure_top_level_blocks_honored( &self, selected: Option<&str>, ) -> Result<()>

A named graph uses its own graphs.<name> block, so a populated top-level block would be silently ignored — a config error. The single definition of that rule, shared by server boot and the CLI selection gate (OmnigraphConfig::resolve_graph_selection) so the two can’t drift. An anonymous selection (None, e.g. a bare URI) legitimately honors the top-level blocks, so it is never rejected here.

pub fn resolve_query_file(&self, value: &str) -> PathBuf

Resolve a stored-query .gq file path (from a registry entry), relative to the config’s base_dir. Mirrors policy-file resolution; the registry loader calls this to turn each entry’s file: value into an absolute path.

pub fn resolve_server_policy_file(&self) -> Option<PathBuf>

Resolve the server-level policy file path (used by management endpoints). Returns None if server.policy.file is not set.

pub fn resolve_uri_value(&self, value: &str) -> String

Resolve a raw config-supplied URI (which may be relative) to its absolute form. URIs containing :// are passed through as-is; relative paths are joined with the config file’s base_dir.

pub fn resolve_policy_tests_file(&self) -> Option<PathBuf>

pub fn alias(&self, name: &str) -> Result<&AliasConfig>

pub fn resolve_target_uri( &self, explicit_uri: Option<String>, explicit_target: Option<&str>, default_target: Option<&str>, ) -> Result<String>

pub fn resolve_query_path(&self, query: &Path) -> Result<PathBuf>

Trait Implementations

impl Clone for OmnigraphConfig

fn clone(&self) -> OmnigraphConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OmnigraphConfig

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

Formats the value using the given formatter.

impl Default for OmnigraphConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for OmnigraphConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for OmnigraphConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.