herbsjs / aloe

Scenario description and test runner for Herbs

Website

This website is built using Docusaurus 2, a modern static website generator.

Installation

yarn install

Local Development

yarn start

This command starts a local development server and open up a browser window. Most changes are reflected live without having to restart the server.

Build

yarn build

This command generates static content into the build directory and can be served using any static contents hosting service.

Deployment

GIT_USER=<Your GitHub username> USE_SSH=true yarn deploy

If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.

aloe's Issues

Aloe should have the skip feature

Is your feature request related to a problem? Please describe.
One of the most common actions when writing or debugging tests, regardless of the framework used, is being able to ignore some tests.
That is especially true if you practice TDD, or tend to first list the placeholders for the tests you plan to write.

Describe the solution you'd like
The skip() feature should have inside the aloe library as the similar in mocha https://danielkorn.io/post/skipping-tests-in-mochajs/

Aloe should have code coverage

Is your feature request related to a problem? Please describe.
Code coverage is a metric that can help you understand how much of your source is tested. It's a very useful metric that can help you assess the quality of your test suite.

Describe the solution you'd like
Aloe should have the code coverage feature.

Describe alternatives you've considered
Maybe an integration with Istanbul (https://github.com/istanbuljs/nyc) or similar should resolve the problem.

Aloe doesn't work when use case has no authorization method

Describe the bug

I'm testing a usecase with no authorization and got an error because ALOE doesn't validate if the usecase has authorization.

To Reproduce
Steps to reproduce the behavior:

1. Create a usecase without authorization method
2. Create a test scenario without authorization

Expected behavior

Not authorized error.

Screenshots

Additional context

I have created an issue to request a creation of hasAuthorization method to validade if usecase has authorization before run.

Run only one scenario on ALOE test runner

Is your feature request related to a problem? Please describe.

Is not possible to run only one scenario when the test is running.

Describe the solution you'd like

Implement the scenario.only function to run only one scenario.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Additional context

Many test runners like mocha or jest have this function, which is very important to debug tests.

Doc improvements

Is your feature request related to a problem? Please describe.
The aloe documentation should be more extensive, complete and user friendly.

Today the existing documentation encompasses only a few scenarios and needs more detail, especially in real project uses.

Additional context
Benchmark: https://mochajs.org/#getting-started

Documentation

The documentation does not explain how the test function should be exported, nor the herbs spec command that is used to run the tests, nor does it explain whether herbarium is necessary or not to use Aloe.