Sampler

0.111.0-preview0008

Sample Module with Pipeline scripts and its Plaster template to create a module following some of the community accepted practices.

Minimum PowerShell version

5.0

This is a prerelease version of Sampler.
There is a newer prerelease version of this module available.
See the version list below for details.

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name Sampler -RequiredVersion 0.111.0-preview0008 -AllowPrerelease

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name Sampler -Version 0.111.0-preview0008 -Prerelease

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

Copyright

(c) Gael Colas. All rights reserved.

Package Details

Author(s)

  • Gael Colas

Tags

Template pipeline plaster DesiredStateConfiguration DSC DSCResourceKit DSCResource Windows MacOS Linux

Functions

Add-Sample Convert-SamplerHashtableToString Get-BuildVersion Get-BuiltModuleVersion Get-ClassBasedResourceName Get-CodeCoverageThreshold Get-MofSchemaName Get-OperatingSystemShortName Get-PesterOutputFileFileName Get-SamplerAbsolutePath Get-SamplerBuiltModuleBase Get-SamplerBuiltModuleManifest Get-SamplerCodeCoverageOutputFile Get-SamplerCodeCoverageOutputFileEncoding Get-SamplerModuleInfo Get-SamplerModuleRootPath Get-SamplerProjectName Get-SamplerSourcePath Merge-JaCoCoReport New-SampleModule New-SamplerJaCoCoDocument Out-SamplerXml Split-ModuleVersion Update-JaCoCoStatistic

Dependencies

Release Notes

## [0.111.0-preview0008] - 2021-05-13

### Added

- Added new public command `New-SamplerJaCoCoDocument`.
- Added new public command `Out-SamplerXml`.
- Added new private function `New-SamplerXmlJaCoCoCounter`.
- Added new build task `Import_Pester` ([issue #223](https://github.com/gaelcolas/Sampler/issues/223)).
- Added new build task `Invoke_Pester_Tests_v5` ([issue #223](https://github.com/gaelcolas/Sampler/issues/223)).
 - Task `Invoke_Pester_Tests_v5` will not run if Pester 4 is used in the pipeline.
- Added unit test for public command `Get-BuildVersion`.

### Changed

- Renamed default branch to `main` ([issue #235](https://github.com/gaelcolas/Sampler/issues/235)).
- Added a public alias `Set-SamplerTaskVariable` that points to the script
 `Set-SamplerTaskVariable.ps1` in the tasks folder. This alias is used to
 dot-source task variables for re-use over multiple build tasks.
- Moved code from build task `Convert_Pester_Coverage` into a public function
 `New-SamplerJaCoCoDocument`.
- It is now possible to specify module's semantic version in the build.yml using
 the key `SemVer`, e.g. `SemVer: '99.0.0-preview1'`. This can be used if the
 preferred method of using GitVersion is not available, and it is not possible
 to set the session environment variable `$env:ModuleVersion`, nor setting the
 variable `$ModuleVersion` in the PowerShell session (parent scope) before
 running the task `build` ([issue #279](https://github.com/gaelcolas/Sampler/issues/279)).
- Templates
 - build.yaml
   - Comment Pester tag exclusion for all templates so that the default is
     to use all QA test.
   - Added comment task `Convert_Pester_Coverage` for the _test_ task.
   - Removed leftovers from key DscTest that was kept when using template
     'SimpleModule'.
   - Updated with entries to support several code coverage scenarios, some
     initially commented.
 - azure-pipelines_dsccommunity.yml
   - Updated with the latest code coverage scenarios, some initially
     commented.
 - azure-pipelines.yml
   - Updated with the latest code coverage merge scenario.
 - codecov_dsccommunity.yml
   - Removed and replaced with codecov.yml.template
 - codecov.yml.template
   - Codecov.yml is now added for several templates and features. Content
     is dependent on the template that is used.
 - Now the template 'dsccommunity' gets a `README.md` file.
- Task `Invoke_Pester_Test` was renamed to `Invoke_Pester_Tests_v4`.
 - Pester 5 support was removed from the task and replaced with `Invoke_Pester_Tests_v5`
 - Task `Invoke_Pester_Tests_v4` will not run if Pester 5 is used in the pipeline.
- Meta build task `Pester_Tests_Stop_On_Fail` was change to run `Import_Pester`,
 `Invoke_Pester_Tests_v4` (previously `Invoke_Pester_Test`), and `Invoke_Pester_Tests_v5`.
 - Task `Invoke_Pester_Tests_v4` will not run if Pester 5 is used in the pipeline.
 - Task `Invoke_Pester_Tests_v5` will not run if Pester 4 is used in the pipeline.
- The task _Convert\_Pester\_Coverage_ was changed to support converting
 Pester 5 code coverage.
- The function `Get-CodeCoverageThreshold` was changed to support Pester 5
 advanced build configuration.
- The function `Get-SamplerCodeCoverageOutputFile` was changed to support Pester 5
 advanced build configuration.

### Fixed

- Renamed task file from `Merge-CodeCoverageFiles.pester.build.ps1` to `JaCoCo.coverage.build.ps1`.
- Move task _Convert_Pester_Coverage_ to task file `JaCoCo.coverage.build.ps1`.
- Resolve-Dependency.ps1: fix MinimumPSDependVersion comparison.
- Resolve-Dependency.ps1: add -Force to all Save-Module.
- `New-SamplerJaCoCoDocument`
 - Fixed counters when a method only had either one hit line or one missed line.
- Now unit tests properly test the function in the built module, not the
 ones that the pipeline dot-sources into session to be able to dogfooding
 itself.
- Fix so that _Convert\_Pester\_Coverage_ correctly replaces build version
 with source folder in JaCoCo file.

FileList

Version History

Version Downloads Last updated
0.118.2-prev... 1,140 8/26/2024
0.118.2-prev... 1,214 7/28/2024
0.118.2-prev... 213 7/24/2024
0.118.1 63,215 7/20/2024
0.118.1-prev... 7 7/18/2024
0.118.1-prev... 5 7/17/2024
0.118.0-prev... 3,696 4/17/2024
0.118.0-prev... 373 4/6/2024
0.118.0-prev... 1,186 2/9/2024
0.118.0-prev... 1,078 1/13/2024
0.118.0-prev... 294 1/7/2024
0.117.1-prev... 5 1/7/2024
0.117.1-prev... 503 12/24/2023
0.117.0 170,405 9/29/2023
0.117.0-prev... 193 9/24/2023
0.117.0-prev... 26 9/21/2023
0.117.0-prev... 1,633 7/1/2023
0.116.6-prev... 5 6/30/2023
0.116.5 84,206 4/19/2023
0.116.5-prev... 165 4/17/2023
0.116.4 3,243 4/6/2023
0.116.4-prev... 6 4/6/2023
0.116.3 1,606 4/1/2023
0.116.3-prev... 5 4/1/2023
0.116.3-prev... 639 3/7/2023
0.116.2 10,682 3/1/2023
0.116.2-prev... 8 3/1/2023
0.116.2-prev... 1,049 1/24/2023
0.116.1 11,936 1/9/2023
0.116.0 26,850 11/8/2022
0.116.0-prev... 14 11/8/2022
0.116.0-prev... 35 11/1/2022
0.116.0-prev... 10 11/1/2022
0.116.0-prev... 11 11/1/2022
0.116.0-prev... 10 11/1/2022
0.116.0-prev... 790 8/3/2022
0.116.0-prev... 12 8/1/2022
0.116.0-prev... 752 7/9/2022
0.115.0 4,713 6/9/2022
0.115.0-prev... 455 5/29/2022
0.115.0-prev... 10 5/28/2022
0.115.0-prev... 131 5/23/2022
0.115.0-prev... 52 5/21/2022
0.115.0-prev... 50 5/20/2022
0.114.1-prev... 22 5/20/2022
0.114.0 1,470 5/13/2022
0.113.0-prev... 11 5/13/2022
0.112.4-prev... 27 5/13/2022
0.112.4-prev... 20 5/13/2022
0.112.3 1,770 3/31/2022
0.112.3-prev... 10 3/31/2022
0.112.2 533 3/20/2022
0.112.2-prev... 11 3/20/2022
0.112.2-prev... 828 2/16/2022
0.112.2-prev... 272 1/26/2022
0.112.1 2,406 1/23/2022
0.112.1-prev... 10 1/23/2022
0.112.1-prev... 10 1/23/2022
0.112.1-prev... 10 1/23/2022
0.112.1-prev... 309 12/1/2021
0.112.1-prev... 142 11/15/2021
0.112.1-prev... 163 10/1/2021
0.112.0 4,291 9/23/2021
0.112.0-prev... 20 9/8/2021
0.112.0-prev... 10 9/8/2021
0.112.0-prev... 13 9/5/2021
0.112.0-prev... 49 8/18/2021
0.111.8 1,312 8/8/2021
0.111.8-prev... 15 8/7/2021
0.111.7 236 7/31/2021
0.111.7-prev... 58 7/30/2021
0.111.7-prev... 73 7/28/2021
0.111.6 678 7/3/2021
0.111.6-prev... 22 7/2/2021
0.111.6-prev... 12 7/1/2021
0.111.5 270 6/25/2021
0.111.5-prev... 11 6/25/2021
0.111.5-prev... 96 6/17/2021
0.111.4 493 6/3/2021
0.111.4-prev... 10 6/3/2021
0.111.3 537 5/21/2021
0.111.3-prev... 10 5/21/2021
0.111.2 30 5/21/2021
0.111.2-prev... 10 5/21/2021
0.111.1 378 5/15/2021
0.111.1-prev... 11 5/15/2021
0.111.1-prev... 11 5/15/2021
0.111.0 196 5/13/2021
0.111.0-prev... (current version) 13 5/13/2021
0.111.0-prev... 12 5/13/2021
0.111.0-prev... 12 5/13/2021
0.111.0-prev... 69 5/7/2021
0.111.0-prev... 11 5/6/2021
0.111.0-prev... 20 5/4/2021
0.111.0-prev... 67 4/20/2021
0.111.0-prev... 63 4/16/2021
0.110.2-prev... 25 4/14/2021
0.110.2-prev... 55 4/13/2021
0.110.1 1,001 4/8/2021
0.110.1-prev... 13 4/8/2021
0.110.0 20 4/8/2021
0.110.0-prev... 11 4/8/2021
0.110.0-prev... 11 4/7/2021
0.110.0-prev... 11 4/7/2021
0.110.0-prev... 11 4/7/2021
0.109.11-pre... 19 3/29/2021
0.109.10 667 3/24/2021
0.109.10-pre... 15 3/22/2021
0.109.9 257 3/20/2021
0.109.9-prev... 11 3/20/2021
0.109.8 25 3/20/2021
0.109.8-prev... 12 3/20/2021
0.109.7 18 3/20/2021
0.109.7-prev... 12 3/20/2021
0.109.6 225 3/18/2021
0.109.6-prev... 15 3/18/2021
0.109.6-prev... 19 3/16/2021
0.109.5 377 3/10/2021
0.109.5-prev... 18 3/10/2021
0.109.5-prev... 20 3/10/2021
0.109.5-prev... 40 3/8/2021
0.109.5-prev... 12 3/7/2021
0.109.4 482 3/6/2021
0.109.4-prev... 13 3/6/2021
0.109.3 877 2/16/2021
0.109.3-prev... 13 2/16/2021
0.109.2 857 1/13/2021
0.109.2-prev... 14 1/13/2021
0.109.2-prev... 13 1/13/2021
0.109.1 321 1/6/2021
0.109.1-prev... 13 1/4/2021
0.109.1-prev... 13 12/29/2020
0.109.0 1,116 11/24/2020
0.109.0-prev... 12 11/24/2020
0.109.0-prev... 19 11/19/2020
0.109.0-prev... 13 11/18/2020
0.109.0-prev... 12 10/13/2020
0.108.0 707 9/14/2020
0.108.0-prev... 11 9/13/2020
0.108.0-prev... 10 9/13/2020
0.107.4-prev... 10 9/12/2020
0.107.4-prev... 10 9/11/2020
0.107.3 211 9/10/2020
0.107.3-prev... 10 9/10/2020
0.107.2 206 9/8/2020
0.107.2-prev... 11 9/8/2020
0.107.1 177 9/8/2020
0.107.1-prev... 11 9/7/2020
0.107.0 168 9/7/2020
0.107.0-prev... 10 9/7/2020
0.107.0-prev... 11 9/7/2020
0.106.1 206 8/30/2020
0.106.1-prev... 11 8/30/2020
0.106.0 187 8/30/2020
0.106.0-prev... 11 8/29/2020
0.106.0-prev... 19 8/21/2020
0.106.0-prev... 32 8/19/2020
0.106.0-prev... 12 8/18/2020
0.106.0-prev... 13 8/8/2020
0.105.7-prev... 16 7/11/2020
0.105.6 1,895 6/1/2020
0.105.6-prev... 11 6/1/2020
0.105.5 276 5/29/2020
0.105.5-prev... 12 5/29/2020
0.105.5-prev... 11 5/29/2020
0.105.4 171 5/29/2020
0.105.4-prev... 11 5/29/2020
0.105.4-prev... 11 5/28/2020
0.105.3 858 5/9/2020
0.105.3-prev... 11 5/9/2020
0.105.2 655 5/1/2020
0.105.2-prev... 11 5/1/2020
0.105.2-prev... 11 5/1/2020
0.105.2-prev... 11 4/24/2020
0.105.2-prev... 11 4/24/2020
0.105.1 477 4/24/2020
0.105.1-prev... 11 4/24/2020
0.105.0 298 4/21/2020
0.105.0-prev... 11 4/21/2020
0.105.0-prev... 11 4/18/2020
0.104.0 3,547 4/18/2020
0.104.0-prev... 11 4/18/2020
0.104.0-prev... 11 4/17/2020
0.103.0 206 4/17/2020
0.103.0-prev... 11 4/17/2020
0.102.1 1,332 2/21/2020
0.102.1-prev... 14 2/18/2020
0.102.1-prev... 13 2/18/2020
0.102.0 272 2/14/2020
0.102.0-prev... 14 2/14/2020
0.102.0-prev... 14 2/12/2020
0.101.0 249 2/10/2020
0.101.0-prev... 13 2/10/2020
0.101.0-prev... 13 2/7/2020
0.101.0-prev... 13 2/7/2020
0.100.0 452 2/1/2020
0.100.0-prev... 13 2/1/2020
0.99.4 388 1/22/2020
0.99.4-previ... 15 1/22/2020
0.99.4-previ... 14 1/22/2020
0.99.4-previ... 13 1/22/2020
0.99.3 180 1/21/2020
0.99.3-previ... 13 1/21/2020
0.99.2 297 1/16/2020
0.99.2-previ... 14 1/16/2020
0.99.1 152 1/16/2020
0.99.1-previ... 13 1/16/2020
0.99.1-previ... 15 1/9/2020
0.99.1-previ... 13 1/7/2020
0.99.1-previ... 13 1/7/2020
0.99.0 682 1/1/2020
0.99.0-previ... 13 1/1/2020
0.99.0-previ... 13 1/1/2020
0.99.0-previ... 13 1/1/2020
0.99.0-previ... 17 12/28/2019
0.99.0-previ... 14 12/28/2019
0.99.0-previ... 13 12/26/2019
0.98.1 513 12/24/2019
0.98.1-previ... 14 12/24/2019
0.98.1-previ... 13 12/23/2019
0.98.0 190 12/22/2019
0.98.0-previ... 14 12/22/2019
0.98.0-previ... 14 12/21/2019
0.97.0 448 12/9/2019
0.97.0-previ... 13 12/9/2019
0.96.1-previ... 14 11/8/2019
0.96.1-previ... 13 11/5/2019
0.96.0 338 11/1/2019
0.96.0-previ... 14 11/1/2019
0.95.2-previ... 14 11/1/2019
0.95.1 189 11/1/2019
0.95.1-previ... 13 11/1/2019
0.95.1-previ... 13 11/1/2019
0.95.0 175 11/1/2019
0.95.0-previ... 13 11/1/2019
0.94.0 178 10/30/2019
0.94.0-previ... 14 10/30/2019
0.94.0-previ... 14 10/30/2019
0.93.3-previ... 13 10/30/2019
0.93.2 174 10/30/2019
0.93.2-previ... 13 10/30/2019
0.93.2-previ... 13 10/30/2019
0.93.2-previ... 12 10/29/2019
0.93.1 181 10/29/2019
0.93.1-previ... 14 10/29/2019
0.93.1-previ... 13 10/29/2019
0.93.0 173 10/29/2019
0.93.0-previ... 13 10/29/2019
0.93.0-previ... 13 10/29/2019
0.93.0-previ... 12 10/23/2019
0.93.0-previ... 12 10/23/2019
0.93.0-previ... 20 10/22/2019
0.93.0-previ... 15 10/20/2019
0.92.2-previ... 13 10/15/2019
0.92.1 201 10/15/2019
0.92.1-previ... 12 10/15/2019
0.92.0 172 10/15/2019
0.92.0-previ... 12 10/14/2019
0.92.0-previ... 13 10/14/2019
0.92.0-previ... 12 10/14/2019
0.92.0-previ... 12 10/14/2019
0.91.7-previ... 12 10/11/2019
0.91.6 175 10/11/2019
0.91.6-previ... 13 10/10/2019
0.91.6-previ... 12 10/10/2019
0.91.6-previ... 12 10/10/2019
0.89.7-previ... 13 10/10/2019
Show less