How guylescalier/wac works
Project type and purpose
• This is an open-source PowerShell Desired State Configuration (DSC) toolkit.
• It provides modules and helper functions to compare, test, expand and set DSC configurations via YAML files.
• It includes multiple “versions” (v2, v3) of the same core capability, Pester tests for validation, and CI workflow definitions for automated testing.
File structure
• Top-level folders:
– .github/workflows: CI definition (pester-ci.yaml)
– DSC: primary DSC modules and resources
– DSC/v2: version-2 modules, configuration scripts, output logs
– DSC/v3: version-3 configuration scripts and outputs
– DSC/Modules: helper modules (CompareDiff-Helpers, MyResources, Pester-ShouldBeDeep)
– DSC/resources: sample certificates, hosts file, Visual Studio settings, WinMerge config
– drafts: experimental scripts (WaC)
– package.json & PSM-NEXUS.md: packaging/publishing metadata
– README.md, PesterConfig.ps1, comparison_report.md: docs and test settings
• Key patterns:
– “Modules” directory holds reusable code, each module in its own folder with .psm1/.psd1 and tests.
– v2 and v3 directories each have “configuration” scripts that read YAML, expand configurations, then run get/set/test workflows.
– “out” subfolders capture CLI output for each cmdlet.
README for additional insights
• It provides:
– External references on PowerShell module conventions and automatic variables.
– Sample usage of the toolkit’s commands: Get-DscConfigurationState, Test-DscConfigurationState, Compare-DscConfigurationState, Set-DscConfigurationState.
– Prerequisites and installation steps (PSGallery modules, execution policy).