Closed alx9r closed 7 years ago
Imho the code coverage output to jacoco is worth mentioning. The packages Pester ships in should also be smaller because all unnecessary files are deleted from them, how much smaller I did not check :) There will very likely be two more breaking changes that are not in the codebase yet: Contains to FileContentMatch, and the Progress reporting will get disabled by default as it has big performance overhead. What we will use to to enable it again I am not sure yet. You can find those issues in milestone 4, if you want to discuss those changes. (Sorry for the lack of formatting, I am writing this from a phone :) )
Imho the code coverage output to jacoco is worth mentioning.
I omitted this by mistake. I have added it.
The packages Pester ships in should also be smaller because all unnecessary files are deleted from them...
Cool. I did not know about this. I have added this.
There will very likely be two more breaking changes that are not in the codebase yet...
I will add those to the proposed release notes once they are completed.
I am drafting the release notes in our releases.
Added the new Should syntax
Deprecated Should without dashes (without warning message for the moment)
Changed all assertion examples to use the new form of shoulds with dashes
Added breaking changes
The 3.4.6 package is not smaller compared to the 4.0.6 package, but I kept the wording anyway. It is smaller than it would be if all the tests would be kept in 🙂
@nohwnd I don't see 4.0.7 at that URL.
I can see v. 4.0.7
I don't see - it should probably be in part about a nested Describe{}
- information that in that case Tag
can be used only once. I remember discussions with @dlwyatt that only "more external tag usage is handled".
@nohwnd Per github documentation:
...Only users with write access to the repository can view drafts of releases...
I'm pretty sure I don't have write access. I assume @it-praktyk does.
@alx9r you are now part of our team :) well deserved. Please still use PR to sending changes, instead of committing directly.
@it-praktyk added that to the release notes.
@nohwnd The release notes look good to me. 👍
Added the new Should syntax
We need review about_Should and probably the wiki too.
@it-praktyk please review in separate issue.
The related issue #876
Pursuant to discussion in #811 here is a draft of release notes for whatever the first 4.x RTM version will be (
$first4xRTM
). These would be the first dedicated release notes for Pester. This will also be the first RTM version that includes the major changes that occurred between versions 3 and 4. Accordingly, the release notes I am proposing should include all the salient user-observable changes between 3.4.6 and$first4xRTM
. If I missed anything, please tell me.I propose that release notes for each version be kept up-to-date on the github releases page.
I also propose that all other mentions of release notes provide only a link to the github releases page. The other places that might mention such release notes include the following:
Get-Module Pester -ListAvailable | % ReleaseNotes
I think this is better for the following reasons:
Proposed Github Releases Page Content
<content>
There is a [guide for migrating from Pester 3 to Pester 4]() to help you understand how the changes from Pester 3 to Pester 4 might affect your tests.
What's New since 3.4.6:
Describe{}
andContext{}
. Now you can group tests using as manyContexts{}
andDescribe{}
blocks in any order. The use of mocks inDescribe{}
andContext{}
blocks nested deeper than one of each is still unexplored territory, so proceed with an appropriate amount of caution.Invoke-Pester
. No more misreading that all your tests are failed!Invoke-Pester
now includes the name of the script it is currently executing. No more guessing which file a failed test is in!Should
operators. UseAdd-AssertionOperator
to write your own assertions. You could write an operator that allows you to write the working assertion$person | Should beAwesome
.Should
now inspects array contents. For example,1,2,3 | Should be 1,2,4
produces a user-friendly failure message. It even works recursively, so assertions like1,@(2,3) | Should be 1,@(2,4)
work.Invoke-Pester
's-CodeCoverage
and-CodeCoverageOutputFile
parameters to produce code coverage reports that integrate with many CI tools.Deprecated starting with 4.0.0:
New-TestDriveItem
command has been deprecated.-Quiet
parameter of theInvoke-Pester
command has been deprecated. Use-Show None
instead.Removed starting with 4.0.0:
-OutputXml
parameter of theInvoke-Pester
command was deprecated already, now it has been removed. Use-OutputFormat
and-OutputFile
instead.</content>
Proposed Release Notes Content for all Other Places
<content>
Please find the latest release notes for all versions of Pester at https://github.com/pester/Pester/releases
</content>