datum

Author(s)

• Gael Colas

Tags

Datum Hiera DSC DesiredStateConfiguration hierarchical ConfigurationData ConfigData

Functions

Clear-DatumRsopCache ConvertTo-Datum Get-DatumRsop Get-DatumRsopCache Get-DatumSourceFile Get-FileProviderData Get-MergeStrategyFromPath Invoke-TestHandlerAction Merge-Datum New-DatumFileProvider New-DatumStructure Resolve-Datum Resolve-DatumPath Test-TestHandlerFilter

Dependencies

• • powershell-yaml

Release Notes

## [0.42.0-preview0006] - 2026-03-08

### Added

- Add configurable `default_json_depth` setting in `Datum.yml` to
 control `ConvertTo-Json` serialization depth (default: `4`)
 ([#136](https://github.com/gaelcolas/datum/issues/136)).
- Add integration tests for deep structure merge and truncation
 warning detection
 ([#136](https://github.com/gaelcolas/datum/issues/136)).
- Added complete documentation system under `docs/` with index and
 seven reference guides:
 - `AboutDatum.md` — module overview, core concepts, and examples.
 - `CmdletReference.md` — full parameter reference for all public
   functions.
 - `DatumYml.md` — `Datum.yml` configuration reference (stores,
   resolution precedence, merge defaults, handlers).
 - `Merging.md` — merge strategies, data types, knockout prefix,
   and per-key configuration.
 - `DatumHandlers.md` — handler system, ProtectedData, InvokeCommand,
   and custom handler authoring.
 - `RSOP.md` — RSOP computation, filtering, source tracking, caching,
   and troubleshooting.
 - `CodeLayers.md` — conceptual guide to layering DSC code with Roles
   and Configurations backed by Datum data.
- Documented `$env:DatumRsopIndentation` environment variable in
 RSOP.md.
- Added AllNodes iteration examples for both flat and nested directory
 layouts in README.md, RSOP.md, and AboutDatum.md.
- Support conditional `ResolutionPrecedence` entries using
 `Datum.InvokeCommand` expressions (`[x= ... =]`). Entries that
 evaluate to `$null` or empty strings are now silently skipped
 instead of causing lookup errors.
- Added knockout support for hashtable array items.

### Changed

- Rewrote README.md with structured sections, table of contents,
 installation guide, merge strategy reference, handler documentation,
 and public function catalogue.
- Remove `SkipReason` from RSOP test cases due to resolved merge logic bug.
- Adjusted integration tests for knockout of hashtable array items.
- Adjusted integration tests for hashtable array merge behauvior 'Sum'.
- Add integration test for conditional `ResolutionPrecedence` entry
 using an InvokeCommand expression that returns a path for some nodes
 and nothing for others.

### Fixed

- Fix `ConvertTo-Json` truncation warnings for deep data structures
 in `Merge-Datum`, `Merge-Hashtable`, and
 `Invoke-TestHandlerAction`
 ([#136](https://github.com/gaelcolas/datum/issues/136)).
- Fixed AllNodes iteration code samples that failed with nested
 directory layouts (e.g. `AllNodes/Dev/DSCFile01.yml`).
- Fixed `-IncludeSource` output examples to show actual right-aligned
 annotations instead of fake `__source` YAML keys.
- Fixed troubleshooting section referencing nonexistent
 `$rsop.SomeKey.__source` pattern.
- Documented `-IncludeSource`/`-RemoveSource` mutual exclusivity in
 RSOP.md and CmdletReference.md.
- Fixed merging of hashtable array items using merge behaviour 'Sum'.