Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[key vault] improve python readme and add multiapi client generation #9870

Merged
merged 11 commits into from
Jan 11, 2021
70 changes: 36 additions & 34 deletions specification/keyvault/data-plane/readme.python.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,65 +4,67 @@ These settings apply only when `--python` is specified on the command line.
Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.
Use `--python-mode=update` if you already have a setup.py and just want to update the code itself.

``` yaml $(python)
``` yaml
iscai-msft marked this conversation as resolved.
Show resolved Hide resolved
python-mode: create
python:
azure-arm: true
license-header: MICROSOFT_MIT_NO_VERSION
payload-flattening-threshold: 2
package-name: azure-keyvault
clear-output-folder: true
no-namespace-folders: true
azure-arm: true
license-header: MICROSOFT_MIT_NO_VERSION
payload-flattening-threshold: 2
package-name: azure-keyvault
clear-output-folder: true
no-namespace-folders: true
```

### Python multi-api

Generate all API versions currently shipped for this package

```yaml $(python) && $(multiapi)
```yaml $(multiapi)
batch:
- tag: package-7.2-preview
- tag: package-7.1
- tag: package-7.0
- tag: package-2016-10
- tag: package-2016-10
- tag: package-7.0
- tag: package-7.1
- tag: package-7.2-preview
- multiapiscript: true
```

### Tag: package-7.2-preview and python
``` yaml $(multiapiscript)
output-folder: $(python-sdks-folder)/keyvault/azure-keyvault/azure/keyvault/
clear-output-folder: false
perform-load: false
```

### Tag: package-7.2-preview

These settings apply only when `--tag=package-7.2-preview --python` is specified on the command line.
These settings apply only when `--tag=package-7.2-preview` is specified on the command line.

``` yaml $(tag) == 'package-7.2-preview' && $(python)
python:
namespace: azure.keyvault.v7_2
output-folder: $(python-sdks-folder)/keyvault/azure-keyvault/azure/keyvault/v7_2_preview
``` yaml $(tag) == 'package-7.2-preview'
namespace: azure.keyvault.v7_2
output-folder: $(python-sdks-folder)/keyvault/azure-keyvault/azure/keyvault/v7_2_preview
```

### Tag: package-7.1 and python
### Tag: package-7.1

These settings apply only when `--tag=package-7.1 --python` is specified on the command line.
These settings apply only when `--tag=package-7.1` is specified on the command line.

``` yaml $(tag) == 'package-7.1' && $(python)
python:
namespace: azure.keyvault.v7_1
output-folder: $(python-sdks-folder)/keyvault/azure-keyvault/azure/keyvault/v7_1_preview
``` yaml $(tag) == 'package-7.1'
namespace: azure.keyvault.v7_1
output-folder: $(python-sdks-folder)/keyvault/azure-keyvault/azure/keyvault/v7_1
```

### Tag: package-7.0 and python
### Tag: package-7.0

These settings apply only when `--tag=package-7.0 --python` is specified on the command line.
These settings apply only when `--tag=package-7.0` is specified on the command line.

``` yaml $(tag) == 'package-7.0' && $(python)
python:
``` yaml $(tag) == 'package-7.0'
namespace: azure.keyvault.v7_0
output-folder: $(python-sdks-folder)/keyvault/azure-keyvault/azure/keyvault/v7_0
```

### Tag: package-2016-10 and python
### Tag: package-2016-10

These settings apply only when `--tag=package-2016-10 --python` is specified on the command line.
These settings apply only when `--tag=package-2016-10` is specified on the command line.

``` yaml $(tag) == 'package-2016-10' && $(python)
python:
``` yaml $(tag) == 'package-2016-10'
namespace: azure.keyvault.v2016_10_01
output-folder: $(python-sdks-folder)/keyvault/azure-keyvault/azure/keyvault/v2016_10_01
```
```