- \n
- What is Pester and Why Should I Care?<\/a>
Learn about a new test framework for PowerShell called Pester<\/li>\n- Getting Started with Pester<\/a>
Learn how to get information back from Pester<\/li>\n- Unit Testing PowerShell Code with Pester<\/a>
Use Pester to analyze small pieces of Windows PowerShell code<\/li>\n- Testing Script Modules with Pester<\/a>
Use Pester for testing PowerShell modules<\/li>\n- More Pester Feature and Resources
<\/a>Learn about more Pester resources<\/li>\n<\/ul>\nI hope that this series has convinced you that writing Pester tests for your code can be easy and valuable—even if I had to be fairly brief in my examples of the most essential parts of the module. Today, I want to show you a few of the other features that the module has to offer.<\/p>\n
First, coverage analysis! The term “code coverage” refers to how much of your code is actually tested. Pester can help you keep track of this metric by analyzing your code as it’s being tested, and reporting on any PowerShell statements that were not executed during the test. (This doesn’t necessarily guarantee that your tests are covering all the logic of the “hit” commands, but at least you can be certain that if a particular line of code didn’t execute during your tests, you definitely didn’t test that part.)<\/p>\n
To show that in action, I’ll run the tests from yesterday’s final script module example, using a –TestName<\/b> filter to only run one of the Describe<\/b> blocks:<\/p>\n
![\"Image](\"\/resized-image.ashx\/__size\/550x0\/__key\/communityserver-blogs-components-weblogfiles\/00-00-00-76-18\/60057.1.PNG\" "\\"Image")
<\/a><\/p>\nThe –CodeCoverage<\/b> parameter was passed a path to the file that you wanted to analyze, and the –TestName <\/b>parameter specified which Describe<\/b> block to run. If you use the –PassThru<\/b> switch at the same time, the object will include a CodeCoverage <\/b>property. This property contains detailed information about the analysis, which you can use in your build pipeline if desired.<\/p>\n
![\"Image](\"\/resized-image.ashx\/__size\/550x0\/__key\/communityserver-blogs-components-weblogfiles\/00-00-00-76-18\/2804.2.PNG\" "\\"Image")
<\/a><\/p>\nI snuck in another feature demonstration with the –TestName<\/b> parameter. Another way to run a particular Describe<\/b> block or a group of Describe<\/b> blocks is to use tagging. Each call to Describe<\/b> can optionally include the –Tags<\/b> parameter to assign one or more tags to the block. Invoke-Pester<\/b> can be called with the –Tag<\/b> or –ExcludeTag<\/b> parameters to control executing by tag, rather than by name.<\/p>\n
Another feature available for your convenience is a set of commands named BeforeEach<\/b>, AfterEach<\/b>, BeforeAll<\/b>, and AfterAll<\/b>. These are initialization and cleanup blocks. Pester will guarantee to run them at the begin and end of each It<\/b> block (for the Each<\/b> versions), or at the beginning and end of the Describe<\/b> or Context<\/b> block (for the All<\/b> versions).<\/p>\n
Unlike most PowerShell code, these commands work a bit of magic. You can place them into your code in any order, and they’ll still work, for example:<\/p>\n
![\"Image](\"\/resized-image.ashx\/__size\/550x0\/__key\/communityserver-blogs-components-weblogfiles\/00-00-00-76-18\/2728.3.PNG\" "\\"Image")
<\/a><\/p>\nIf your script needs to create temporary files on the hard disk, Pester provides a means for that with a built-in test drive. This is a folder created under your TEMP directory at the beginning of each Describe<\/b> block. At the end of the Describe<\/b>, the folder is deleted. You can access it via a variable named $TestDrive<\/b>, or with a PSDrive named TestDrive:\\<\/b>. Both options refer to the same path. But don’t take my word for it—prove it with tests!<\/p>\n
![\"Image](\"\/resized-image.ashx\/__size\/550x0\/__key\/communityserver-blogs-components-weblogfiles\/00-00-00-76-18\/2627.4.PNG\" "\\"Image")
<\/a><\/p>\nBy the way, many of the ideas and code for these cool features came from the community! If you have a feature that you think would make your tests more valuable or easier to write, please head to Pester GitHub<\/a> site and open an Issue<\/b> (or, if you’ve already written code, open a Pull Request<\/b>) to strike up a conversation about it!<\/p>\n
Speaking of community contributions, here are some of the neat features we’ve got coming up when version 4.0 of Pester gets released:<\/p>\n
Gherkin<\/b><\/h4>\n
Gherkin is a language for defining software requirements entirely in human-readable form, with no executable code whatsoever. It has a minimal amount of syntax rules, similar to YAML in its structure. The advantage is that non-programmers can easily write and maintain the spec for your code, and the spec can then be parsed and used by developers to directly control your automated tests. <\/p>\n
If you’re interested in the original Gherkin (part of the Cucumber test framework for Ruby), check out Cucumber: Simple, human collaboration<\/a>. The credit for bringing Gherkin support to Pester goes to Joel “Jaykul” Bennett, the man behind PoshCode, PowerShell.slack.com, and many other cool PowerShell community tools.<\/p>\n
Extensible Should operators<\/b><\/h4>\n
Now the operators for the Should<\/b> command are rather difficult to extend, due to how the arguments passed to Should<\/b> are parsed. Everything’s limited to this basic syntax:<\/p>\n
Should [Not] <Operator> [Value]<\/p>\n
There’s no way to add switches or other additional parameters to individual operators.<\/p>\n
In Pester v4, we’ll be generating dynamic parameter sets for each operator on the Should<\/b> command. This will allow the command to be called like this (in the basic case):<\/p>\n
$true | Should –Not –Be $false<\/p>\n
It looks just like the current syntax, with the exception of the dashes on the Not<\/b> and Be<\/b> parameter names. However, this opens up a whole world of options to us for expanding the individual operators. For example, now Should Throw<\/b> only allows you to match the _message_ of the error that was thrown. But with the new enhancements, we could easily add support for something like this:<\/p>\n
scriptBlock | Should –Throw –ExceptionOfType ([MyExceptionType])<\/p>\n
Array comparisons<\/b><\/h4>\n
This is another enhancement to parts of the Should<\/b> command. Now, arrays and the Should<\/b> command have a weird relationship. Arrays piped to the Should<\/b> command pass their elements down the pipeline one at a time (because that’s how PowerShell works). In many cases, the operators behave strangely (again, because that’s how PowerShell’s comparison operators work when used on arrays.) Here’s one example of those oddities:<\/p>\n
![\"Image](\"\/resized-image.ashx\/__size\/550x0\/__key\/communityserver-blogs-components-weblogfiles\/00-00-00-76-18\/28606.5.PNG\" "\\"Image")
<\/a><\/p>\nIn the code we’re preparing for v 4.0, the Should<\/b> command and its operators are smarter about how they handle arrays, which will cause the previous example to fail as you would expect:<\/p>\n
![\"Image](\"\/resized-image.ashx\/__size\/550x0\/__key\/communityserver-blogs-components-weblogfiles\/00-00-00-76-18\/6862.6.PNG\" "\\"Image")
<\/a><\/p>\nBecause this is already going to be a major release (meaning it will include some breaking changes that might require updates to existing Tests.ps1 files), this is a great time to suggest features or fixes to the project. The best way to do that is on the Pester GitHub<\/a> site. We can’t promise that all suggestions will be included, but for v 4.0, we’ll be less reluctant to make types of changes that we might normally put on hold in a minor release (when _not_ breaking existing test code would be important.)<\/p>\n
~Dave<\/p>\n
Thanks for this informative series, Dave!<\/p>\n
I invite you to follow me on Twitter<\/a> and Facebook<\/a>. If you have any questions, send email to me at scripter@microsoft.com<\/a>, or post your questions on the Official Scripting Guys Forum<\/a>. See you tomorrow. Until then, peace.<\/p>\n
Ed Wilson, Microsoft Scripting Guy<\/b><\/p><\/p>\n","protected":false},"excerpt":{"rendered":"
Summary: Dave Wyatt wraps up his week teaching us about Pester with information about more resources. Note This is a five-part series that includes the following posts: What is Pester and Why Should I Care? Learn about a new test framework for PowerShell called Pester Getting Started with Pester Learn how to get information back […]<\/p>\n","protected":false},"author":596,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[501,56,636,45],"class_list":["post-75011","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-dave-wyatt","tag-guest-blogger","tag-pester","tag-windows-powershell"],"acf":[],"blog_post_summary":"
Summary: Dave Wyatt wraps up his week teaching us about Pester with information about more resources. Note This is a five-part series that includes the following posts: What is Pester and Why Should I Care? Learn about a new test framework for PowerShell called Pester Getting Started with Pester Learn how to get information back […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/75011","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/596"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=75011"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/75011\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=75011"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=75011"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=75011"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- Getting Started with Pester<\/a>