PSSwagger
0.1.0
PowerShell module with commands for generating the PowerShell Cmdlets using Swagger based specifications.
Minimum PowerShell version
5.1
Installation Options
Owners
Copyright
(c) Microsoft Corporation. All rights reserved.
Package Details
Author(s)
- Microsoft Corporation
Tags
Functions
New-PSSwaggerModule New-PSSwaggerMetadataFile
PSEditions
Dependencies
Release Notes
First preview release of PSSwagger and PSSwaggerUtility modules. While the goal is to support all web APIs, scenarios are focused on Microsoft Azure for this first release.
## Supported Scenarios
* From an Open API v2 specification, generate a PowerShell module using [Azure AutoRest](https://github.com/azure/autorest)
* Generating modules is only supported on PowerShell 5.1
* Customize the generation process with Open API v2 extensions in either the same specification as your web API or a separate file
* Rename automatically generated cmdlets
* Flatten complex parameters without flattening the underlying .NET API
* Generated modules support PowerShell on Windows (PowerShell 4 or greater) or PowerShell Core on Windows, Linux or Mac
* Compile the underlying .NET API before you publish your module or compile it on-the-fly on your end-user's machine
* Debugging symbols for underlying .NET API available
* Currently supported authentication schemes:
* Basic authentication, with or without challenge
* API key based authentication
* No authentication
* Authentication using AzureRM.Profile
## Installation
Open PowerShell and run:
```powershell
Install-Package PSSwagger
```
Or visit our PowerShellGallery.com page: [link here]
## Known Issues
FileList
- PSSwagger.nuspec
- Definitions.psm1
- Generated.Resources.psd1
- GeneratedHelpers.psm1
- Paths.psm1
- PluralToSingularMap.json
- PSCommandVerbMap.ps1
- PSSwagger.cat
- PSSwagger.Constants.ps1
- PSSwagger.psd1
- PSSwagger.psm1
- PSSwagger.Resources.psd1
- PSSwaggerMetadata.psm1
- SwaggerUtils.psm1
- Test-CoreRequirements.ps1
- Test-FullRequirements.ps1
- Trie.ps1
- Utilities.psm1
- ServiceTypes\azure.PSMeta.json
- ServiceTypes\azure_stack.PSMeta.json
Version History
Version | Downloads | Last updated |
---|---|---|
0.3.0 | 8 | 10/10/2017 |
0.2.0 | 10 | 8/8/2017 |
0.1.0 (current version) | 5 | 8/4/2017 |