AutoRest SDK Test Generation Tools

Packages

| Name | Changelog | Latest |
| ----------------------------------------------- | ------------------------------- | ------------------------------------------------------------ |
| [@autorest/testmodeler][testmodeler_src] | [Changelog][testmodeler_chg] |  |
| [@autorest/gotest][gotest_src] | [Changelog][gotest_chg] |  |

[testmodeler_src]: packages/autorest.testmodeler
[gotest_src]: packages/autorest.gotest

[testmodeler_chg]: packages/autorest.testmodeler/CHANGELOG.md
[gotest_chg]: packages/autorest.gotest/CHANGELOG.md

Contributing

For instructions on cloning/building/etc, see Development

$3

This project welcomes contributions and suggestions. Most contributions require you to agree to a
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide
a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions
provided by the bot. You will only need to do this once across all repos using our CLA.

$3

This project has adopted the Microsoft Open Source Code of Conduct.
For more information see the Code of Conduct FAQ or
contact opencode@microsoft.com with any additional questions or comments.

Autorest Extension for Test Modeler

Generate \*.md config files in Azure REST API specification:

https://github.com/Azure/azure-rest-api-specs

How to Generate Test Model

``
autorest --version=3.7.3 --use= --output-folder= --testmodeler.export-codemodel --clear-output-folder=false --debug
`

Contribution

The testmodeler use rush managing the projects. So if there is changes on package.json, remember to execute rush update updated.
~~~
> rush update
~~~

Configurations

Below are options can be used for autorest.testmodeler

$3

Generate modeler files in [output-foler]/\_\_debuger for debug purpose.

$3

In generated mock test, send swagger example-id to mock service host in each request. This implicitly ask the mock service host to verify request body by swagger example content. Default true.

$3

In generated mock test, response value will be verified with the example files. Default true.

$3

This is an array parameter can be assigned in autorest readme file.
For instance, examples Extensions_Get and Extensions_Delete will not be used in mock test generation with below configuration.

`
testmodeler:
mock:
disabled-examples:
- Extensions_Get
- Extensions_Delete
`

$3

Set location used in scenario test, for instance:

`
testmodeler:
scenario:
variable-defaults:
location: eastus
`

$3

If there is no 'test-resources' defined in readme file and the readme is located in local file system, testmodeler will search all available api-scenario and try to load them as test scenario.
In this context, option codemodel-restcall-only defined whether testmodeler abandon api-scenarios who contains restcall steps that can't be linked to an operation in codemodel.

The default value of this option is true.

$3

This option switch whether ExampleModel in generated in test model. While default to be true, it can be disabled like below:
`
testmodeler:
use-example-model: false
`

$3

This option switch whether StepArmTemplateModel.armTemplatePayloadString is added into testmodeler. While default to be false, it can be enabled like below:
`
testmodeler:
add-armtemplate-payload-string: true
`

$3

The api-scenarios are loaded from the autorest input-files by default. This option provide a gate to load api-scenario from other remote/branch/commit.
This option are passed through directly to oav scenario loader, refer to https://github.com/Azure/oav/blob/develop/lib/apiScenario/apiScenarioLoader.ts#L60 for more detail of it. A sample for this option:
`
testmodeler:
api-scenario-loader-option:
fileRoot: https://github.com/Azure/azure-rest-api-specs/blob/eb829ed4739fccb03dd2327b7762392e74c80ae4/specification/appplatform/resource-manager
swaggerFilePaths:
- 'Microsoft.AppPlatform/preview/2020-11-01-preview/appplatform.json'
`

$3

The list of api-scenarios want to get loaded into testmodeler. Below is a sample:
`
test-resources:
- test: Microsoft.AppPlatform/preview/2020-11-01-preview/scenarios/Spring.yaml
`

$3

Whether to export codemodel with tags on primitive types, default as false. Demonstrate on the output values:
`
// with primitive types:
isDataAction: !!bool false
count: !!int 64


// with no types:
isDataAction: false
count: 64
`

$3

A list for types need to explicitly tagged when export-explicit-type is true. The default explicitTypes are ['bool', 'int', 'float', 'timestamp']. Test generators can change it like below:

`
testmodeler:
explicit-types:
- bool
- int
- float
`

Autorest Pipeline Configurations

`yaml
clear-output-folder: false

try-require:
- ./readme.test.md
- ./readme.testmodeler.md

version: 3.9.7

use-extension:
"@autorest/modelerfour" : "4.25.0"

pipeline:
test-modeler:
input: modelerfour/identity
output-artifact: source-file-test-modeler
testmodeler/emitter:
input: test-modeler
scope: scope-testmodeler/emitter

scope-testmodeler/emitter:
input-artifact:
- source-file-test-modeler
output-uri-expr: $key

testmodeler:
split-parents-value: true
`

`yaml $(debug)
testmodeler:
export-codemodel: true
``