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

[rust] fix unusable oneOf generation #12566

Closed

Conversation

ctrlaltf24
Copy link
Contributor

When generating the combined oneOf struct ensure the struct can form a valid request.

Reproduction steps:

  • java -jar ./modules/openapi-generator-cli/target/openapi-generator-cli.jar generate -g rust -i ./openapi.yaml
openapi: 3.0.1

info:
  version: "1"
  title: rust one-of fix
paths: {}
components:
  schemas:
    Foo:
      x-one-of-name: Foo
      oneOf:
        - type: object
          required:
            - field_one
          properties:
            field_one:
              type: string
            field_two:
              type: string
        - type: object
          required:
            - field_three
          properties:
            field_three:
              type: number
    Bar:
      type: object
      required:
        - two
      properties:
        one:
          type: string
        two:
          type: string
  • Observe ./src/models/foo.rs

Expected behavior: Able to fill in struct fields in such a way that creates a valid request
Actual behavior: Impossible to fill the struct Foo to make it a valid schema (as BOTH required fields (field_one and field_three) are required to be filled in rust, yet the openapi schema only allows one or the other to be set.

Related issue: #9497

Ideally oneOf would be represented as an enum. Presently the oneOf implementation is unusable (as described by @cortopy), this PR would at least makes it usable, but requires the rust api consumer to know what a valid schema object is (aka which optional types to populate to form a valid response).

PR checklist

  • Read the contribution guidelines.
  • Pull Request title clearly describes the work in the pull request and Pull Request description provides details about how to validate the work. Missing information here may result in delayed response from the community.
  • Run the following to build the project and update samples:
    ./mvnw clean package 
    ./bin/generate-samples.sh
    ./bin/utils/export_docs_generators.sh
    
    Commit all changed files.
    This is important, as CI jobs will verify all generator outputs of your HEAD commit as it would merge with master.
    These must match the expectations made by your contribution.
    You may regenerate an individual generator by passing the relevant config(s) as an argument to the script, for example ./bin/generate-samples.sh bin/configs/java*.
    For Windows users, please run the script in Git BASH.
  • File the PR against the correct branch: master (6.0.1) (patch release), 6.1.x (breaking changes with fallbacks), 7.0.x (breaking changes without fallbacks)
  • If your PR is targeting a particular programming language, @mention the technical committee members, so they are more likely to review the pull request. (cc @frol @farcaller @richardwhiuk @paladinzh )

Generate struct with optional types
@mattoni
Copy link

mattoni commented Nov 8, 2022

It'd be great to get this merged in - currently unable to use my open api spec with rust.

@ctrlaltf24
Copy link
Contributor Author

superseded by #13970

@ctrlaltf24 ctrlaltf24 closed this Nov 9, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants