Struct GraphConfig 

pub struct GraphConfig {
    pub node_mappings: HashMap<String, NodeMapping>,
    pub relationship_mappings: HashMap<String, RelationshipMapping>,
    pub default_node_id_field: String,
    pub default_relationship_type_field: String,
}

Configuration for mapping Lance datasets to property graphs

Important: Case-Insensitive Keys

WARNING: node_mappings and relationship_mappings store keys as lowercase for case-insensitive behavior. If you directly insert into these maps, you must normalize keys to lowercase to maintain invariants.

Recommended: Use GraphConfigBuilder instead of direct field access. The builder automatically normalizes keys.

Future API Changes

These fields may become private in a future major version to enforce invariants. Code should migrate to using accessor methods (get_node_mapping(), get_relationship_mapping()) rather than direct field access.

TODO: API Safety

TODO: Make node_mappings and relationship_mappings private to prevent external code from bypassing key normalization. This would require:

1. Adding iterator methods for external access (e.g., iter_node_mappings())
2. Making this a breaking API change in next major version
3. Ensuring all internal code uses accessor methods

Fields

node_mappings: HashMap<String, NodeMapping>

Mapping of node labels to their field configurations

Keys are stored as lowercase for case-insensitive lookups. Use get_node_mapping() for lookups instead of direct access.

TODO: Make this private to enforce key normalization invariants

relationship_mappings: HashMap<String, RelationshipMapping>

Mapping of relationship types to their field configurations

Keys are stored as lowercase for case-insensitive lookups. Use get_relationship_mapping() for lookups instead of direct access.

TODO: Make this private to enforce key normalization invariants

default_node_id_field: String

Default node ID field if not specified in mappings

default_relationship_type_field: String

Default relationship type field if not specified in mappings

Implementations

impl GraphConfig

pub fn builder() -> GraphConfigBuilder

Create a new builder for GraphConfig

pub fn get_node_mapping(&self, label: &str) -> Option<&NodeMapping>

Get node mapping for a given label (case-insensitive)

Looks up the node mapping using case-insensitive comparison. For example, “Person”, “PERSON”, and “person” all refer to the same label.

pub fn get_relationship_mapping( &self, rel_type: &str, ) -> Option<&RelationshipMapping>

Get relationship mapping for a given type (case-insensitive)

Looks up the relationship mapping using case-insensitive comparison. For example, “FOLLOWS”, “follows”, and “Follows” all refer to the same type.

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

Validate the configuration

Checks for:

• Empty ID fields
• Non-normalized keys (must be lowercase)
• Case-insensitive duplicates

Trait Implementations

impl Clone for GraphConfig

fn clone(&self) -> GraphConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GraphConfig

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

Formats the value using the given formatter.

impl Default for GraphConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GraphConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GraphConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.