Struct ResourceSpec 

pub struct ResourceSpec {
    pub resource: ResourceMeta,
    pub crud: CrudMapping,
    pub action: Option<ActionMapping>,
    pub identity: IdentityConfig,
    pub fields: BTreeMap<String, FieldOverride>,
    pub read_mapping: BTreeMap<String, String>,
}

Top-level resource specification loaded from TOML.

Two flavours are supported:

• CRUD (default): kind = "crud" or absent — requires [crud] + [identity] tables. Resolved via crate::resolve_resource.
• Action (RPC-style): kind = "action" — requires [action] table; MUST NOT have [crud]/[identity]. Resolved via crate::resolve_action.

Both crud and identity default to empty placeholders so an action TOML can omit them entirely. Use ResourceSpec::is_action before dispatching to the CRUD resolver — calling resolve_resource on an action spec will fail loudly.

Fields

resource: ResourceMeta

Resource metadata (name, description, category, kind).

crud: CrudMapping

CRUD operation mappings.

Defaults to an empty placeholder so kind = "action" specs (which have no [crud] table) parse cleanly. CRUD callers must verify via ResourceSpec::is_action before reading the empty struct.

action: Option<ActionMapping>

Action mapping for RPC-style endpoints. Required when kind = "action".

identity: IdentityConfig

Identity and import configuration.

Defaults to an empty placeholder so action specs parse without an [identity] table.

fields: BTreeMap<String, FieldOverride>

Per-field overrides (skip, computed, sensitive, etc.).

read_mapping: BTreeMap<String, String>

Mapping from API response JSON paths to field names.

Implementations

impl ResourceSpec

pub fn is_action(&self) -> bool

Whether this spec describes an action (RPC-style) resource.

Action specs MUST have kind = "action" AND a populated [action] table. CRUD specs (kind absent or "crud") return false.

impl ResourceSpec

pub fn load(path: &Path) -> Result<Self, IacForgeError>

Load a resource spec from a TOML file.

Delegates to ConfigLoader::load.

Errors

Returns an error if the file can’t be read or parsed.

pub fn validate(&self, api: &Spec) -> Result<(), IacForgeError>

Validate the resource spec against an OpenAPI spec.

Dispatches on ResourceSpec::is_action:

• CRUD specs validate create/read/delete (+ optional update / read response) schemas and the create endpoint path.
• Action specs validate the action endpoint + request schema (and the optional response schema).

Errors

Returns validation errors if schemas are missing or endpoints don’t exist.

Trait Implementations

impl Clone for ResourceSpec

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ConfigLoader for ResourceSpec

fn load(path: &Path) -> Result<Self, IacForgeError>

Load from a TOML file.

fn from_toml(content: &str) -> Result<Self, IacForgeError>

Parse from a TOML string (useful for tests).

impl Debug for ResourceSpec

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ResourceSpec

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ResourceSpec

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

where __S: Serializer,

Serialize this value into the given Serde serializer.