https://github.com/restarian/brace_maybe
:question: Adds functionality to mocha to allow skipping unit tests at run time.
https://github.com/restarian/brace_maybe
mocha override unit-test
Last synced: about 1 month ago
JSON representation
:question: Adds functionality to mocha to allow skipping unit tests at run time.
- Host: GitHub
- URL: https://github.com/restarian/brace_maybe
- Owner: restarian
- Created: 2017-12-17T01:09:53.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-03-01T12:11:27.000Z (about 2 years ago)
- Last Synced: 2025-03-17T14:07:55.691Z (2 months ago)
- Topics: mocha, override, unit-test
- Language: JavaScript
- Homepage:
- Size: 64.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Brace Maybe
### Synopsis
#### Brace Maybe adds the ability to skip unit tests at run-time with the mocha testing framework to only show failed tests which matter.
[](https://ci.appveyor.com/project/restarian/brace-maybe/branch/master) [](https://npmjs.org/package/brace_maybe)
| A part of the [Brace suite](https://github.com/restarian/restarian/blob/master/brace/README.md)| Developed with Windows 10 and Ubuntu 16
| ---- | ----
|  | [](https://github.com/Microsoft/BashOnWindows) |
---
### Brace Maybe help pages
* **Synopsis**
* Specification
* [License information](https://github.com/restarian/brace_maybe/blob/master/docs/specification/license_information.md)
* [Package information](https://github.com/restarian/brace_maybe/blob/master/docs/specification/package_information.md)
---
**Author: Robert Steckroth, _Bust0ut_ [](mailto:[email protected])**
**Licensed under: MIT**
**Bonuses:**
* Finding what test failed is now possible in large unit test files.
**Caveats:**
* Not unit tested (extensive use in many projects however).
Below is an example of how to use Brace maybe in unit tests.
```javascript
var maybe = require("brace_maybe")
var it_will = global
describe("Using stop further progression methodology for dependencies in: "+path.basename(__filename), function() {
// The it property is mutated by brace_maybe to allow for other functionality. It still has the same functionality as the original however.
var it = maybe(it_will)
it_will.stop = !!process.env.DRY_RUN
it_will.quiet = !!process.env.QUIET
it("r_js in the system as a program", function(done) {
it_will.stop = true
expect((function() {try { require("requirejs"); return true; } catch(e) { return e;}})(), "could not find r.js dependency").to.be.true
// This is the only way to proceed with the other tests.
it_will.stop = false
done()
})
describe("Running unit tests", function() {
var requirejs
beforeEach(function() {
remove_cache()
requirejs = require("requirejs")
requirejs.config({baseUrl: path.join(__dirname, "..", "lib"), nodeRequire: require})
})
// This test will never run if the requirejs module is not available above.
it("can load the module", function(done) {
requirejs(["yourModule"], function(mod) {
expect(true).to.be.true
done()
})
})
// All of the built-in mocha it functionality works the same way.
//it.skip("This is a skipped test", function(done) { })
//it.only("This is the only test which will run", function(done) { })
})
})
```