Config-Model-2.163

Changes for version 2.163 - 2026-06-05

Model declaration changes (backward compatible, except for Config::Model::Itself < 2.031):
- Warp: Change warp property to use "when <test> => apply {element properties}"
- Model: to save typing, element declaration can now be written like: element => [ X => { type => 'leaf', value_type => 'enum', choice => [qw/Av Bv Cv/] }, Y => '*X', # alias to X Z => '*X', ] This kind of factorization was already possible using clunky Perl tricks. Using aliases inspired from YAML should make model more readable for non Perl gurus. To be able to factorize elements, it may be necessary to declare some properties outside of element declaration. So, 'summary', 'description' and 'warp' properties can be declared as class properties like: summary => { 'X' => 'a good summary' 'Y' => '*X', } Likewise, 'level' and 'status' properties can also be declared as class properties with a more suitable structure: level => { important => [qw/X Y/], hidden => 'Z'} status => { deprecated => 'X' } Note that Config::Model::Itself >= 2.031 allows 'cme meta -factorize all' to write models with factorized properties.
Feature:
- add 'cme run translate_legacy' script to help update models.
Doc updates:
- Remove references to 'obsolete' 'experience' and 'permission' properties
- Model and Node: fix doc of 'level' 'status' 'description' and 'summary' properties
Deprecated features:
- Warper: deprecate using array for "follow" arguments
Removed features:
- Model: remove inherit and inherit_after deprecated class properties
Bug fix:
- Dumper: fix crash when dumping a list of warped_node
- Node: trim white spaces in gist
- WarpedNode: better fix of crash during WarpedNode creation
- Model: fix bug in translate_rules_arg
Note:
- This new version breaks Config::Model::Itself < 2.031. Config::Model::Itself 2.031 will be available soon.

Documentation

CONTRIBUTING.md

README.install

Config::Model::Cookbook::CreateModelFromDoc

Create a configuration model from application documentation

Config::Model::Manual::ModelCreationAdvanced

Creating a model with advanced features

Config::Model::Manual::ModelCreationIntroduction

Introduction to model creation with Config::Model

Config::Model::models::Fstab

Configuration class Fstab

Config::Model::models::Fstab::FsLine

Configuration class Fstab::FsLine

Config::Model::models::PopCon

Configuration class PopCon

Modules

Config::Model

a framework to validate, migrate and edit configuration files

Config::Model::Annotation

Read and write configuration annotations

Config::Model::AnyId

Base class for hash or list element

Config::Model::AnyThing

Base class for configuration tree item

Config::Model::Backend::Any

Virtual class for other backends

Config::Model::Backend::CdsFile

Read and write config as a Cds data structure

Config::Model::Backend::Fstab

Read and write config from fstab file

Config::Model::Backend::IniFile

Read and write config as a INI file

Config::Model::Backend::Json

Read and write config as a JSON data structure

Config::Model::Backend::PerlFile

Read and write config as a Perl data structure

Config::Model::Backend::PlainFile

Read and write config as plain file

Config::Model::Backend::ShellVar

Read and write config as a SHELLVAR data structure

Config::Model::BackendMgr

Load configuration node on demand

Config::Model::BackendTrackOrder

Track read order of elements from configuration

Config::Model::CheckList

Handle check list element

Config::Model::Describe

Provide a description of a node element

Config::Model::DumpAsData

Dump configuration content as a perl data structure

Config::Model::Dumper

Serialize data of config tree

Config::Model::Exception

Exception mechanism for configuration model

Config::Model::FuseUI

Fuse virtual file interface for Config::Model

Config::Model::HashId

Handle hash element for configuration model

Config::Model::IdElementReference

Refer to id element(s) and extract keys

Config::Model::Instance

Instance of configuration tree

Config::Model::Iterator

Iterates forward or backward a configuration tree

Config::Model::ListId

Handle list element for configuration model

Config::Model::Lister

List available models and applications

Config::Model::Loader

Load serialized data into config tree

Config::Model::Node

Class for configuration tree node

Config::Model::ObjTreeScanner

Scan config tree and perform call-backs for each element or node

Config::Model::Report

Reports data from config tree

Config::Model::Role::ComputeFunction

compute &index or &element functions

Config::Model::Role::Constants

Provide some constant data.

Config::Model::Role::FileHandler

role to read or write configuration files

Config::Model::Role::Grab

Role to grab data from elsewhere in the tree

Config::Model::Role::HelpAsText

Translate element help from pod to text

Config::Model::Role::NodeLoader

Load Node element in configuration tree

Config::Model::Role::Utils

Provide some utilities

Config::Model::Role::WarpMaster

Config::Model::SearchElement

Search an element in a configuration model

Config::Model::SimpleUI

Simple interface for Config::Model

Config::Model::TermUI

Interactive command line interface for cme

Config::Model::TreeSearcher

Search tree for match in value, description...

Config::Model::TypeConstraints

Mouse type constraints for Config::Model

Config::Model::Utils::GenClassPod

generate pod documentation from configuration models

Config::Model::Value

Strongly typed configuration value

Config::Model::Value::LayeredInclude

Include a sub layer configuration

Config::Model::Value::Update

Retrieve data from several external files

Config::Model::Value::UpdateFromFile

Retrieve data from external file

Config::Model::ValueComputer

Provides configuration value computation

Config::Model::WarpedNode

Node that change config class properties

Config::Model::Warper

Warp tree properties