wirthual / openapitools-generator-action

Generate a client library using the OpenAPITools Generator

openapitools-generator-action

Generate a client library from an OpenAPI document using the OpenAPITools Generator

Inputs

generator

The generator you wish to use (i.e. the language you want to generate a client library for). See the official list of supported languages/generators and the openapi-generator repo for more info.

config-file

The path (with respect to the current directory/the workspace) to the config file to be used with openapi-generator. For information on what can be configured, see the page on customization in the repo.

openapi-file

The path (with respect to the current directory/the workspace) to the OpenAPI document (both JSON and YAML are supported). Defaults to "openapi.json" (i.e. a file in the current directory called openapi.json).

openapi-url

The URL to load the OpenAPI document from. If set, openapi-file will be ignored.

generator-tag

The Docker tag of the openapitools/openapi-generator-cli image to use. See the DockerHub repo for available tags.

Outputs

No outputs are returned. The generated client is placed in the current directory. The name of the package (unless configured differently) will be generator-name-client where "generator-name" is (unsurprisingly) the name of the generator used to generate the client.

Example usage

jobs:
  generate-angular-client:
    runs-on: ubuntu-latest
    name: Example
    steps:

      # Checkout your code
      - name: Checkout
        uses: actions/checkout@v2

      # Generate your OpenAPI document (if you don't write it manually)

      # Use the action to generate a client package
      # This uses the default path for the openapi document and thus assumes there is an openapi.json in the current workspace.
      - name: Generate Angular Client
        uses: openapi-generators/openapitools-generator-action@v1
        with:
          generator: typescript-angular
          config-file: angular-generator-config.yml

      # Do something with the generated client (likely publishing it somewhere)
      - name: Do something with the client
        run: |
          cd typescript-angular-client