Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nohwnd/Assert
A set of advanced assertions for Pester to simplify how you write tests.
https://github.com/nohwnd/Assert
assertions comparator general-assertions pester-assertions testcase
Last synced: 3 months ago
JSON representation
A set of advanced assertions for Pester to simplify how you write tests.
- Host: GitHub
- URL: https://github.com/nohwnd/Assert
- Owner: nohwnd
- License: mit
- Created: 2017-01-15T10:13:22.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-06-20T15:38:02.000Z (5 months ago)
- Last Synced: 2024-06-22T04:38:03.530Z (5 months ago)
- Topics: assertions, comparator, general-assertions, pester-assertions, testcase
- Language: PowerShell
- Homepage:
- Size: 805 KB
- Stars: 101
- Watchers: 12
- Forks: 12
- Open Issues: 21
-
Metadata Files:
- Readme: README.MD
- Changelog: CHANGELOG.MD
- Funding: .github/FUNDING.yml
- License: LICENSE.MD
Awesome Lists containing this project
- jimsghstars - nohwnd/Assert - A set of advanced assertions for Pester to simplify how you write tests. (PowerShell)
README
# 📖 This repository moved to Pester.
The assertions from this repository were moved to [Pester](https://github.com/pester/pester) and will be shipped together with Pester 6 and newer. You can still file issues here, but no new features will be added, all new development will be done in Pester repository instead.
----
# Assert
A set of advanced assertions for Pester to simplify how you write tests.
## Features
### Syntax you don't have to learn
Assertions use approved verb `Assert` and one function per assertion so you can leverage all your command discovery skills.
### Specialized assertions
Assertions are split to generic and specialized. Use the generic assertion to the basic stuff and the specialized assertion to get more fancy. No more guessing what `-Exactly` means for the current type. More types coming soon.
### Helpful failure messages
Assertions provide verbose failure messages that describe what the input was, what the output was, and why the assertion failed.
### Custom failure messages
Bored by standard assertion messages, or they simply don't make much sense for your usecase? Don't worry, you can write your own.
### Nicely formatted output
Most objects do not print nicely, so we try hard to fix it for you so you know exactly what the input and output of your tests was. Say no to "Assertion failed because '' was not equal to ''."
### Well tested
The whole suite was written mostly test first, it currently has 417 tests and growing. (Yes that is almost as many tests as Pester has for the whole framework!) A simplified set of independent assertions is used to test the code to make sure everything is working correctly without unwanted dependencies.
[](https://ci.appveyor.com/project/nohwnd/assertions/branch/master)
### Comparing whole objects
_experimental!_
Got two objects and you need to know how exactly they differ? With this experimential feature you can compare whole objects and get detailed report of their differences. Get in touch and help me throw a lot of testcases on this assertion to make it better!
### Chaining assertions
_experimental!_
Assertions pass their input to their output so you can easily chain them. Awesome for quick prototyping or when you are missing a complex assertion. Not recommended for production, because of assertion rullette. Be a hero and suggest a way to chain assertions and fail all of them at the same time.
## Setup
1) Install
Install for the current user by running the following:
```powershell
Install-Module -Scope CurrentUser -Name Assert
```
Or install for all users by running this from and administrator PowerShell commandline:
```powershell
Install-Module -Name Assert
```
2) Import
Import the module in your current powershell session by:
```powershell
Import-Module Assert
```
3) Use it anywhere!
```powershell
"hello" | Assert-NotEqual "world"
```
## Help needed
Best way to help, is to start using this module and report bugs and feature requests. I have big plans, but my tests are still the same, so every new pair of eyes is welcome. :)