swagger-api/swagger-codegen

[PowerShell] Enhancements to PowerShell generator

Open

#5886 opened on Jun 20, 2017

View on GitHub
 (2 comments) (0 reactions) (0 assignees)HTML (12,701 stars) (5,474 forks)batch import
Client: PowerShellEnhancement: Generalhelp wanted

Description

Description

Here are some enhancements for the PowerShell generator:

  • Option to specify ClientPath (which is hard coded to "$ScriptDir....\csharp\SwaggerClient" at the moment"
  • Integration tests using AppVeyor (similar to other API clients, we want to perform testings with the Petstore server (local) to ensure nothing breaks after changes)
  • Review authentication support: HTTP basic, API key, OAuth2
  • Add auto-generated documentation for API endpoints and models
  • Update auto-genreated test files (APIs, models)
  • Review README.md to see if the installation instruction, etc are clear
Swagger-codegen version

Latest master

Suggest a Fix

If anyone wants to work on these enhancements or have other suggestions on making the PowerShell generator better, please reply to let us know.

Contributor guide

Tech stack
java
Domain
backendapidocumentation
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
mostly clear
Prerequisites
familiarity with PowerShellfamiliarity with swagger codegen codebase
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
30
Research direction
The issue lists several enhancements for the PowerShell generator in swagger codegen. Some sub tasks like updating README and auto generated documentation are clearer entry points. The repository is swagger codegen, and the PowerShell generator implementation is likely in modules/swagger codegen/src/main/java/io/swagger/codegen/languages/PowerShellClientCodegen.java. Start by understanding the generator structure and then tackle a small task like reviewing the README or updating test files. Existing comments or maintainers may provide context.