You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -47,7 +47,7 @@ Management libraries can be identified by namespaces that start with `azure-mgmt
47
47
## Need help?
48
48
49
49
* For detailed documentation visit our [Azure SDK for Python documentation](https://aka.ms/python-docs)
50
-
* File an issue via [Github Issues](../../issues)
50
+
* File an issue via [Github Issues](https://github.com/Azure/azure-sdk-for-python/issues)
51
51
* Check [previous questions](https://stackoverflow.com/questions/tagged/azure+python) or ask new ones on StackOverflow using `azure` and `python` tags.
Copy file name to clipboardExpand all lines: doc/dev/mgmt/swagger/multi_api/readme.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ This is the AutoRest configuration file for Network.
8
8
9
9
## Getting Started
10
10
11
-
To build the SDK for Network, simply [Install AutoRest](https://aka.ms/autorest/install) and in this folder, run:
11
+
To build the SDK for Network, simply [Install AutoRest](https://github.com/Azure/autorest/blob/master/docs/installing-autorest.md) and in this folder, run:
12
12
13
13
> `autorest`
14
14
@@ -66,4 +66,4 @@ swagger-to-sdk:
66
66
67
67
## Python
68
68
69
-
See configuration in [readme.python.md](./readme.python.md)
69
+
See configuration in [readme.python.md](https://github.com/Azure/azure-sdk-for-python/blob/master/doc/dev/mgmt/swagger/multi_api/readme.python.md)
Copy file name to clipboardExpand all lines: doc/dev/mgmt/swagger/single_api/readme.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ This is the AutoRest configuration file for Cdn.
8
8
9
9
---
10
10
## Getting Started
11
-
To build the SDK for Cdn, simply [Install AutoRest](https://aka.ms/autorest/install) and in this folder, run:
11
+
To build the SDK for Cdn, simply [Install AutoRest](https://github.com/Azure/autorest/blob/master/docs/installing-autorest.md) and in this folder, run:
Copy file name to clipboardExpand all lines: doc/dev/mgmt/swagger_conf.md
+10-10
Original file line number
Diff line number
Diff line change
@@ -18,38 +18,38 @@ Writing the readme is the responsibility of the Python SDK team. There is curren
18
18
- Readme that handles only one API version, and generates packages that handle one API version only
19
19
- Readme that handles several API versions, and generates packages with multiples API and profile supports
20
20
21
-
These templates can be found in the [single_api](./single_api) and the [multi_api](./multi_api) folders.
21
+
These templates can be found in the [single_api](https://github.com/Azure/azure-sdk-for-python/blob/master/doc/dev/mgmt/swagger/single_api) and the [multi_api](https://github.com/Azure/azure-sdk-for-python/blob/master/doc/dev/mgmt/swagger/multi_api) folders.
22
22
23
23
24
24
### Single API readmes
25
25
26
26
This one is the most simple:
27
-
- Copy the [readme.python.md](./single_api/readme.python.md) and replace `servicetoreplace` by your service name
28
-
- Be sure the main [readme.md](./single_api/readme.md) contains a "swagger-to-sdk" section with Python
27
+
- Copy the [readme.python.md](https://github.com/Azure/azure-sdk-for-python/blob/master/doc/dev/mgmt/swagger/single_api/readme.python.md) and replace `servicetoreplace` by your service name
28
+
- Be sure the main [readme.md](https://github.com/Azure/azure-sdk-for-python/blob/master/doc/dev/mgmt/swagger/single_api/readme.md) contains a "swagger-to-sdk" section with Python
29
29
30
30
### Multi API readmes
31
31
32
-
When doing multi-api packages, it means you have shipping several "tags" of the main readme as one package. Autorest is calling this process a "batch" call, and this is the purpose of the "batch" section in [readme.python.md](./multi_api/readme.python.md).
32
+
When doing multi-api packages, it means you have shipping several "tags" of the main readme as one package. Autorest is calling this process a "batch" call, and this is the purpose of the "batch" section in [readme.python.md](https://github.com/Azure/azure-sdk-for-python/blob/master/doc/dev/mgmt/swagger/multi_api/readme.python.md).
33
33
34
34
In order to be sure the correct tags exist, you can use the following script:
This script will analyze the Swaggers available, and suggests on stdout:
40
-
- A list of tags for the main [readme.md](./multi_api/readme.md)
41
-
- A batch declaration for the [readme.python.md](./multi_api/readme.python.md)
40
+
- A list of tags for the main [readme.md](https://github.com/Azure/azure-sdk-for-python/blob/master/doc/dev/mgmt/swagger/multi_api/readme.md)
41
+
- A batch declaration for the [readme.python.md](https://github.com/Azure/azure-sdk-for-python/blob/master/doc/dev/mgmt/swagger/multi_api/readme.python.md)
42
42
43
43
This script is not perfect that it *does* require manual review of the output and not a direct copy/paste.
44
44
45
45
It's important for Python that tags represents only *ONE* unique API version. It's why it's pretty common that Python uses a set of tags that other languages don't use.
46
46
47
47
Once you know the list of tags you need to generate:
48
48
49
-
- Copy the [readme.python.md](./multi_api/readme.python.md) and replace `servicetoreplace` by your service name
50
-
- Update the batch list of [readme.python.md](./multi_api/readme.python.md)
51
-
- Be sure you have one tag section for each batch entry in [readme.python.md](./multi_api/readme.python.md)
52
-
- Be sure the main [readme.md](./multi_api/readme.md) contains a "swagger-to-sdk" section with Python with an `afterscripts` section like the one in the template.
49
+
- Copy the [readme.python.md](https://github.com/Azure/azure-sdk-for-python/blob/master/doc/dev/mgmt/swagger/multi_api/readme.python.md) and replace `servicetoreplace` by your service name
50
+
- Update the batch list of [readme.python.md](https://github.com/Azure/azure-sdk-for-python/blob/master/doc/dev/mgmt/swagger/multi_api/readme.python.md)
51
+
- Be sure you have one tag section for each batch entry in [readme.python.md](https://github.com/Azure/azure-sdk-for-python/blob/master/doc/dev/mgmt/swagger/multi_api/readme.python.md)
52
+
- Be sure the main [readme.md](https://github.com/Azure/azure-sdk-for-python/blob/master/doc/dev/mgmt/swagger/multi_api/readme.md) contains a "swagger-to-sdk" section with Python with an `afterscripts` section like the one in the template.
53
53
54
54
The `afterscripts` will execute a Jinja template to create a client to link together all the batch generated autorest ([example](https://github.com/Azure/azure-sdk-for-python/blob/4a7c67189591b052fe2b5769847ff68f7845386d/sdk/storage/azure-mgmt-storage/azure/mgmt/storage/_storage_management_client.py))
Copy file name to clipboardExpand all lines: doc/dev/mgmt/tests.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -176,7 +176,7 @@ providing several features useful for the SDK tests, for example:
176
176
* Patches for overriding functions and methods that don't work well with tests
177
177
(such as long-running operations)
178
178
179
-
Code in the [`azure-sdk-tools/devtools_testutils`](tools/azure-sdk-tools/devtools_testutils) directory
179
+
Code in the [`azure-sdk-tools/devtools_testutils`](https://github.com/Azure/azure-sdk-for-python/tree/master/tools/azure-sdk-tools/devtools_testutils) directory
180
180
provides concrete implementations of the features provided in `scenario_tests`
Copy file name to clipboardExpand all lines: eng/common/TestResources/New-TestResources.ps1.md
+17
Original file line number
Diff line number
Diff line change
@@ -412,6 +412,23 @@ Accept pipeline input: False
412
412
Accept wildcard characters: False
413
413
```
414
414
415
+
### -OutFile
416
+
save test environment settings into a test-resources.json.env file next to test-resources.json.
417
+
The file is protected via DPAPI. The environment file would be scoped to the current repository directory.
418
+
Note: Supported only on Windows.
419
+
420
+
```yaml
421
+
Type: SwitchParameter
422
+
Parameter Sets: (All)
423
+
Aliases:
424
+
425
+
Required: False
426
+
Position: Named
427
+
Default value: None
428
+
Accept pipeline input: False
429
+
Accept wildcard characters: False
430
+
```
431
+
415
432
### CommonParameters
416
433
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
0 commit comments