themirageproject/spectapular

⚡️👓🤠🎩🚰 Declarative Tests Runner where Async has a seat in 1st Class

spectapular's Issues

Import Tead Tests

Given how close teadjs and testmatrixtest formats are, it would be nice if the test runner could handle both test types and run them both.

Architectural Fork:

• Detection : Should the system attempt to detect the varried types of tests
• Configuration : Should the user be required to flag the tests in some way.

Explore migration to chokidar

@ref https://github.com/paulmillr/chokidar/blob/master/README.md

Create Reporter Module Interface

Create a reporter Interface

1. Draw out touch points of how that might work
2. Document the requirements for reporter authors
3. Identify beneficial reporters

Reporter Requirements:

Reporter Lifecycle

Authoring & Publishing

1. Create Reporter
2. Submit Reporter to some js software service (npm, github, etc)
3. Optional: Submit install instructions to SpecTapular for increased easy visibility

Installation & Usage

4. Developers install a reporter from a software service
5. Developers can configure spectapular to use the new reporter
6. Developers execute tests

List of Reporters From Other Awesome Projects

• See Ava Reporters
• See Mocha Reporters

exploration tasks:

• Look into license issues created by porting reporters over.
• Rank preferred reporters
• Identify if there are patterns represented by identified reporters than will be a challenge to support

Block Diagram All the Things

I think in Block Diagrams.
Let's assume that others don't hate the option of looking at block diagrams.

Start with:

• Spectapular Architecture
• Reporter Architecture
• Summarizer Architecture

Start By Exploring:

• Good Ways to incorporate block diagrams into source code
• Good Ways to reference the block diagrams
  • Embed in a reference document && ref the document? (Seems like a good start)
  • Embedable/collapseable/expandable diagram to be "imported" into every document?
  • How does versioning a diagram work?
  • How do projects handle syncing the diagram with the source code?
  • What are projects with good diagrams incorporated into the documentation?

Better Handling of TAP

As the name suggests, the project should better handle TAP streams, both in and out.

IN TAP Streams - SpecTapular acts as a reporting service.
OUT TAP Streams - SpecTapular would need a modular reporter interface.