# CLI Config Testdata

CLI versions 4-7 (latest) are supported. We employ three suites of tests to verify compatibility with those versions.

| Major  | Version Tested |
| ------ | -------------- |
| v4     | v4.52.0        |
| v5     | v5.6.0         |
| v6     | v6.4.0         |
| v7     | v7.6.5         |
| Latest | -              |

## Auth Tests

Test data from the CLI is gathered for different Auth use cases, both from after the "Zero Config" switch (v6.4.0) and from before (`old`). These configurations are created by running amplify pull in the different Amplify UI [environments](https://github.com/aws-amplify/amplify-ui/tree/main/environments).

These tests ensure that we handle the various changes to login mechanisms and username attributes introduced in the Zero Config changes.

## CLI `generateConfig`

Internally, the CLI uses a function called `generateConfig` to output the Flutter `amplifyconfiguration.dart` file. This is used in [`generate/`](generate/) to generate various configs for the different categories and for the different CLI versions. To regenerate [`cli_generated.dart`](cli_generated.dart):

```sh
$ cd generate
$ yarn && yarn generate
```

These tests ensure compatibility with any major changes to the different category config shapes.

## E2E CLI Tests

The same simple project with a GraphQL API and Cognito Userpool is generated for each CLI version and stored in respective directories (`v4/`, `v5/`, etc). Each of these configurations is tested to ensure that `fromJson`/`toJson` produce symmetric results.

To generate:

1. Run `amplify init` and choose Flutter as the project type. Set the config directory to cwd (`.`).
2. Run `amplify add api` and select the Todo schema with all other defaults.
3. Run `amplify add auth` and select all defaults.
4. Run `amplify push`.
5. Update the `.gitignore` to the following, and add the files to tracking.

```
amplify/
.vscode/
!amplifyconfiguration.dart
```

6. Run `amplify delete` and restore the `amplifyconfiguration.dart` file if deleted.

**Note**: The values in these configs do not represent live services.