OpenAPITools / OpenAPITools/openapi-generator

[NETCORE] Question re: experimental status for HttpClient

Open
#12,942 0 comments 4 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Java
Stars
26.8k
Forks
7.7k
PR merge metrics
PR metrics pending

Description

Description

Currently, the netcore generator provides an experimental HttpClient (see screenshot). This option has been marked as experimental since March 2021 (no judgement). I'm curious about the timeline/process to promote this to a stable.

image

openapi-generator version

6.0.1

OpenAPI declaration file content or url
{
  "packageName": "Package Name",
  "targetFramework": "netstandard2.0",
  "optionalProjectFile": false,
  "optionalAssemblyInfo": false,
  "optionalEmitDefaultValue":  true,
  "library": "httpclient"
}
Command line used for generation
openapi-generator-cli generate -g csharp-netcore -i ../../apigee/openapi-internal-spec.yaml -c openapigenerator.json --global-property=modelTests=false,apiTests=false
Steps to reproduce

N/A

Related issues/PRs

I didn't see anything in the project roadmap related to promoting the HttpClient behavior to stable.

Suggest a fix/enhancement

Provide clarity in README (if possible) on any next steps/road map items to marking this behavior as stable.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the README and roadmap referenced in the issue, then inspect the csharp-netcore generator documentation for the experimental HttpClient option. Done means the documentation clearly states the current stability status and any next steps or criteria for promotion.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp, openapi
Domain
api, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.