As we start to integrate more and more inputs, it is important that we test actual and real inputs from users to ensure the library behaves as expected. For now, the best way is to add them as BlackBox tests. The BlackBox tests are focused on catching syntax errors and not logical errors, although they can be manually used for this.
The documents being tested can be found under docs, which contain documents for the following input types:
- AsyncAPI 2.0
- AsyncAPI 2.1
- AsyncAPI 2.2
- AsyncAPI 2.3
- JSON Schema draft 4
- JSON Schema draft 6
- JSON Schema draft 7
- Swagger 2.0
- OpenAPI 3.0
Each document is tested across all output languages and output will be written to ./output folder in appropriate sub folders, for easier access.
The tests can either be run by installing all dependencies locally, or running it through docker.
To run the BlackBox tests through Docker, run the command npm run docker:test:blackbox.
If you want to run the BlackBox tests locally, you have to install a couple of dependencies:
- To to run the
JavaBlackBox tests, you need to have JDK installed. - To to run the
TypeScriptBlackBox tests, you need to have TypeScript installed globally -npm install -g typescript. - To to run the
C#BlackBox tests, you need to have C# compiler installed globally. - https://www.mono-project.com/download/stable/ - To to run the
GoBlackBox tests, you need to have GoLang installed - https://golang.org/doc/install
By default, the BlackBox tests are not run with the regular npm run test, but can be run with npm run test:blackbox.