Libvirt returns the underlying go-libvirt client for direct API access

Close closes the libvirt connection

testAccLibvirtURI returns the libvirt URI to use for acceptance tests. It can be configured via the LIBVIRT_TEST_URI environment variable. Defaults to

LookupDomainByUUID looks up a domain by its UUID string

ReflectStruct analyzes a libvirtxml struct and returns its IR.

SnakeCase converts CamelCase to snake_case while keeping known acronyms intact.

mustSingleNestedAttribute asserts that attr is a schema.SingleNestedAttribute and panics otherwise. Generated schemas are known at compile time, so a

ApplyFieldPolicies mutates the IR with Terraform-specific schema/conversion semantics after structural reflection is complete.

LookupNetworkByUUID looks up a network by its UUID string

NewLibvirtXMLReflector creates a new reflector.

NewSSHCmd creates a new SSHCmd dialer from a libvirt URI.

OctalModePlanModifier returns a plan modifier that handles octal mode normalization.

UnmarshalDomainXML deserializes XML to libvirtxml.Domain

extractPath extracts the path value from a "- path: xyz" line

extractText recursively extracts all text from a node

mustStringAttribute asserts that attr is a schema.StringAttribute and panics otherwise. Generated schemas are known at compile time, so a panic indica

parseUUID converts a UUID string to libvirt.UUID type

readNetwork reads network state from libvirt and populates the model

testAccCheckCloudInitDiskExists verifies that the ISO file exists on disk

waitForDomainState waits for a domain to reach the specified state with a timeout

waitForInterfaceIP polls for IP addresses on a domain's interfaces If mac is specified, waits for that specific interface to get an IP If mac is empty

GeneratePrompt creates a prompt for AI to generate field descriptions It includes the full HTML index for context and enriched field metadata.

Load reads every YAML file from dir and builds a registry.

LookupPoolByUUID looks up a storage pool by its UUID string

MarshalDomainXML serializes a libvirtxml.Domain to XML string

New creates a new provider instance

NewClient creates a new libvirt client from a connection URI

UUIDString converts a libvirt.UUID to a hyphenated string representation

buildCyclePath builds a human-readable cycle path for error messages. e.g., "DomainDiskSource → DomainDiskDataStore → DomainDiskSource"

hashString returns a simple hash of the input string. This is used for generating stable IDs for data sources.

isInAnalysisStack checks if a type name is currently being analyzed (cycle detection).

newGoSSHDialer creates an SSH dialer using the Go SSH library (upstream)

readPoolWithPlan reads pool state from libvirt and populates the model plan parameter is used to preserve user intent (only populate fields user speci

readVolume reads volume state from libvirt and populates the model plan parameter is used to preserve user intent (only populate fields user specified

Apply walks structIR rooted at rootPath (snake_case) adding doc strings when available.

BuildBatches creates batches of all fields

Dial establishes a connection to libvirt and returns a net.Conn.

EntryForPath returns an entry and presence flag for a given path.

Generate generates conversion code for the given structs.

Generate generates model code for the given structs.

Generate generates schema code for the given structs.

Generate generates descriptions for a batch using OpenAI API

GetFullIndex loads and returns the complete documentation index for AI context

LoadState loads generation state from disk

NewConvertGenerator creates a new conversion generator.

NewDialerFromURI creates the appropriate Dialer based on the libvirt URI. It uses upstream go-libvirt dialers for most transports and custom dialers f

NewModelGenerator creates a new model generator.

NewOpenAIClient creates a new OpenAI client

NewSchemaGenerator creates a new schema generator.

OpenURLStream opens a URL for reading and returns the stream with its size. Supports: - https:// URLs - file:// URLs - Plain absolute paths (treated a

ParseHTML extracts documentation sections from an HTML file

ParseYAMLResponse extracts YAML entries from the AI response

Ping verifies the connection is still alive

SaveState saves generation state to disk

Schema defines the schema for the resource

TrailingSlashPlanModifier returns a plan modifier that handles trailing slash normalization.

WriteYAMLEntries appends YAML entries to the appropriate documentation files Skips entries that already exist (deduplication)