Struct BranchContext 

pub struct BranchContext { /* private fields */ }

Branch context for data virtualization.

Determines which branch a request targets. When a branch is active, the gateway applies Copy-on-Write semantics:

• Reads: main rows UNION branch overlay (overlay wins on PK conflict)
• Writes: inserted/updated rows go to _qail_branch_rows overlay
• Deletes: a tombstone marker is added to the overlay

Implementations

impl BranchContext

pub const MAX_NAME_LEN: usize = 64

Maximum branch name length.

pub fn main() -> Self

Create a context targeting the main branch (no overlay).

pub fn branch(name: &str) -> Self

Create a context targeting a named branch.

Panics

Panics if the branch name is invalid. Use try_branch for fallible creation.

pub fn try_branch(name: &str) -> Option<Self>

Try to create a branch context, returning None if the name is invalid.

pub fn parse_header(value: Option<&str>) -> Result<Self, String>

Parse an optional branch header value into a BranchContext.

Rules:

• None, empty string, and main (case-insensitive) map to main.
• Any other value must pass Self::is_valid_name.

pub fn from_header(value: Option<&str>) -> Result<Self, String>

Create from an optional branch name (None = main).

pub fn is_valid_name(name: &str) -> bool

Validate a branch name.

Rules:

• 1 to 64 characters
• Only alphanumeric, hyphens (-), underscores (_), and dots (.)
• Must not start with . or -

pub fn is_main(&self) -> bool

Returns true if this is the main branch.

pub fn has_branch(&self) -> bool

Returns true if this is a named branch (not main).

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

Get the branch name, if any.

Trait Implementations

impl Clone for BranchContext

fn clone(&self) -> BranchContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BranchContext

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

Formats the value using the given formatter.

impl Display for BranchContext

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

Formats the value using the given formatter.

impl Eq for BranchContext

impl PartialEq for BranchContext

fn eq(&self, other: &BranchContext) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for BranchContext