open-index/open-npm huggingface dataset:
npm package: @openapi-generator-plus/java-cxf-cdi-server-generator
Description: An OpenAPI Generator Plus template for a Java API server using CXF and CDI
Author: Karl von Randow
Latest version: 3.4.4

# Java CXF + CDI Server API generator for OpenAPI Generator Plus

An [OpenAPI Generator Plus](https://github.com/karlvr/openapi-generator-plus) template for a Java API server using CXF and CDI annotations

See [java-jaxrs-server-generator](https://github.com/karlvr/openapi-generator-plus-generators/tree/master/packages/java-jaxrs-server) for documentation.
npm package: @openapi-generator-plus/java-cxf-client-generator
Description: An OpenAPI Generator Plus template for a Java API client using CXF
Author: Karl von Randow
Latest version: 3.2.3

# Java CXF Client API generator for OpenAPI Generator Plus

An [OpenAPI Generator Plus](https://github.com/karlvr/openapi-generator-plus) template for a Java API server using CXF

See [java-jaxrs-client-generator](https://github.com/karlvr/openapi-generator-plus-generators/tree/master/packages/java-jaxrs-client) for documentation.

The Java CXF client API includes interfaces and default implementations to invoke the API. These are created
in the `impl` package.

## Config file

See [java-jaxrs-client-generator](https://github.com/karlvr/openapi-generator-plus-generators/tree/master/packages/java-jaxrs-client) for config file documentation.
npm package: @openapi-generator-plus/java-cxf-spring-server-generator
Description: An OpenAPI Generator Plus template for a Java API server using CXF and Spring annotations
Author: Karl von Randow
Latest version: 3.4.4

# Java CXF + Spring Server API generator for OpenAPI Generator Plus

An [OpenAPI Generator Plus](https://github.com/karlvr/openapi-generator-plus) template for a Java API server using CXF and Spring annotations

See [java-jaxrs-server-generator](https://github.com/karlvr/openapi-generator-plus-generators/tree/master/packages/java-jaxrs-server) for documentation.
npm package: @openapi-generator-plus/java-retrofit-client-generator
Description: An OpenAPI Generator Plus template for a Java API client using Retrofit
Author: Karl von Randow
Latest version: 2.6.14

# Java Retrofit client API generator for OpenAPI Generator Plus

An [OpenAPI Generator Plus](https://github.com/karlvr/openapi-generator-plus) template for a Java API client using Retrofit annotations

See [java-jaxrs-client](https://github.com/karlvr/openapi-generator-plus-generators/tree/master/packages/java-jaxrs-client) for documentation.
npm package: @openapi-generator-plus/plain-documentation-generator
Description: An OpenAPI Generator Plus template for generating plain documentation
Author: Karl von Randow
Latest version: 1.10.4

# Plain API documentation generator for OpenAPI Generator Plus

An [OpenAPI Generator Plus](https://github.com/karlvr/openapi-generator-plus) template for generating API documentation.

## Using

See the [OpenAPI Generator Plus](https://github.com/karlvr/openapi-generator-plus) documentation for how to use
generator templates.

For convenience when editing the API spec, or editing custom templates, you can setup a watch script and an automatically
reloading web browser:

```shell
npm add -D live-server
```

Then add the following `npm` script, adjusting paths to your config file and output folder (`./dist` in this example):

```json
{
	"scripts": {
        "watch": "openapi-generator-plus -c config.yml --clean --watch & live-server --port=9123 ./dist & wait"
    }
}
```

## Config file

The available config file properties are:

### Options

|Property|Type|Description|Default|
|--------|----|-----------|-------|
|`operations`|`Operations`|Configuration for operations|`undefined`|
|`customTemplates`|`string`|The path to a directory containing custom Handlebars templates, relative to the config file. See Customising below.|`undefined`|

### Operations

|Property|Type|Description|Default|
|--------|----|-----------|-------|
|`navStyle`|`"name" \| "full-path"`|The display style in the nav.|`"name"`|
|`exclude`|`string[]`|An array of regex strings to match against operation full-paths to exclude some operations.|`[]`

## Customising

This generator supports a `customTemplates` config file property to specify a directory containing Handlebars templates that will be used to override built-in templates.

Any custom template will have the original template available as a partial named by prefixing the template name with `original`, and then upper-casing the first letter, e.g. `originalBodyParams`.

Some of the templates in the generator are designed to support overriding for custom requirements. Please inspect the templates in the `templates` directory.
npm package: @openapi-generator-plus/swift-client-generator
Description: An OpenAPI Generator Plus template for a Swift API client
Author: Karl von Randow, Tom Carey
Latest version: 1.6.0

# Swift Client Generator

## Development

To use this library in development we use of the `link` command.

Get started by ensuring that your target project is using the same node version so that the global link will be discoverable. We use a `.nvmrc` file in this project to set the version.

First check that this project builds

```
pnpm install
pnpm run build
```

Then to register this directory with the global registry

```
pnpm run link
```

Then in your target project run

```
pnpm link --global @openapi-generator-plus/swift-client-generator
```

## Design principles

* Create structs to represent request parameters where there are more than one, as the order of parameters is irrelevant but may change as the API spec evolves.
* The server will change over time and may add new enum cases or polymorphic subclasses that the client won't know about yet. The client must be able to identify and ignore the new cases, and continue to handle the known cases.
	* Support receiving an _unknown_ enum value.
	* Support receiving unknown polymorphic objects.
npm package: @openapi-generator-plus/typescript-express-example-server-generator
Description: An OpenAPI Generator Plus template for a TypeScript API server using Express to output example responses
Author: Karl von Randow
Latest version: 1.6.7

# TypeScript Express Example Server API generator for OpenAPI Generator Plus

An [OpenAPI Generator Plus](https://github.com/karlvr/openapi-generator-plus) template for a TypeScript API server using Express to serve example responses.

If you've added example responses in your OpenAPI spec then this server will output them in response to API requests. If you've specified
multiple requests it will randomly choose between them.

## Using

See the [OpenAPI Generator Plus](https://github.com/karlvr/openapi-generator-plus) documentation for how to use
generator templates.

Once the generator has been run, the generated package can be run using:

```shell
npm install
npm start
```

It will start an API server running on port 3000.

You may also specify a different port:

```shell
npm start -- -p 9000
```

## Config file

The available config file properties are:

### Project layout

|Property|Type|Description|Default|
|--------|----|-----------|-------|
|`relativeSourceOutputPath`|`string`|The path to output generated source code, relative to the output path.|`./` or `./src` if `npm` is specified.|

### TypeScript

A `tsconfig.json` file will be output if you specify any of the TypeScript config options.

|Property|Type|Description|Default|
|--------|----|-----------|-------|
|`typescript`|`TypeScriptConfig`|Configuration for the `tsconfig.json` file.|`undefined`|

#### `TypeScriptConfig`

|Property|Type|Description|Default|
|--------|----|-----------|-------|
|`target`|`string`|The ECMAScript target version.|`ES5`|

### Packaging

|Property|Type|Description|Default|
|--------|----|-----------|-------|
|`npm`|`NpmConfig`|Configuration for generating an npm `package.json`|`undefined`|

#### `NpmConfig`

|Property|Type|Description|Default|
|--------|----|-----------|-------|
|`name`|`string`|The package name|`typescript-fetch-api`|
|`version`|`string`|The package version|`0.0.1`|
|`repository`|`string`|The URL to the package repository|`undefined`|

### Overrides

|Property|Type|Description|Default|
|--------|----|-----------|-------|
|`customTemplates`|`string`|The path to a directory containing custom Handlebars templates, relative to the config file. See Customising below.|`undefined`|

## Customising

This generator supports a `customTemplates` config file property to specify a directory containing Handlebars templates that will be used to override built-in templates.

Any custom template will have the original template available as a partial named by prefixing the template name with `original`, and then upper-casing the first letter, e.g. `originalModelEnum`.

Some of the templates in the generator are designed to support overriding for custom requirements. Please inspect the templates in the `templates` directory.
npm package: @openapi-generator-plus/typescript-express-passport-server-generator
Description: An OpenAPI Generator+ module for an Express + Passport API server in TypeScript
Author: Karl von Randow
Latest version: 2.13.1

# TypeScript Express Passport Server API generator for OpenAPI Generator Plus

An [OpenAPI Generator Plus](https://github.com/karlvr/openapi-generator-plus) template for a TypeScript API server using [Express](http://expressjs.com) and [Passport](https://www.passportjs.org).

## Using

See the [OpenAPI Generator Plus](https://github.com/karlvr/openapi-generator-plus) documentation for how to use
generator templates.

Once the generator has been run, the generated package can be run using:

```shell
npm install
npm start
```

It will start an API server running on port 3000.

You may also specify a different port:

```shell
npm start -- -p 9000
```

## Config file

The available config file properties are:

### Project layout

|Property|Type|Description|Default|
|--------|----|-----------|-------|
|`relativeSourceOutputPath`|`string`|The path to output generated source code, relative to the output path.|`./` or `./src` if `npm` is specified.|

### TypeScript

A `tsconfig.json` file will be output if you specify any of the TypeScript config options.

|Property|Type|Description|Default|
|--------|----|-----------|-------|
|`typescript`|`TypeScriptConfig`|Configuration for the `tsconfig.json` file.|`undefined`|

#### `TypeScriptConfig`

|Property|Type|Description|Default|
|--------|----|-----------|-------|
|`target`|`string`|The ECMAScript target version.|`ES5`|

### Packaging

|Property|Type|Description|Default|
|--------|----|-----------|-------|
|`npm`|`NpmConfig`|Configuration for generating an npm `package.json`|`undefined`|

#### `NpmConfig`

|Property|Type|Description|Default|
|--------|----|-----------|-------|
|`name`|`string`|The package name|`typescript-fetch-api`|
|`version`|`string`|The package version|`0.0.1`|
|`repository`|`string`|The URL to the package repository|`undefined`|

### Overrides

|Property|Type|Description|Default|
|--------|----|-----------|-------|
|`customTemplates`|`string`|The path to a directory containing custom Handlebars templates, relative to the config file. See Customising below.|`undefined`|

## Customising

This generator supports a `customTemplates` config file property to specify a directory containing Handlebars templates that will be used to override built-in templates.

Any custom template will have the original template available as a partial named by prefixing the template name with `original`, and then upper-casing the first letter, e.g. `originalModelEnum`.

Some of the templates in the generator are designed to support overriding for custom requirements. Please inspect the templates in the `templates` directory.