refitter

A tool for generating Refit interfaces and contracts from OpenAPI specifications

MIT License

Stars
180
Committers
4

Bot releases are hidden (Show)

refitter - v1.3.0 Latest Release

Published by christianhelle about 1 month ago

What's New

  • Add support for generating multiple files
  • Add support for customizing Contracts namespace and output path
  • System.Text.Json Polymorphic Serialization

What's Changed

New Contributors

Full Changelog: https://github.com/christianhelle/refitter/compare/1.2.0...1.3.0

refitter - v1.2.0

Published by christianhelle 2 months ago

What's New

  • Generate Apizr flavored Refit interfaces
  • Option to wrap multiple query parameters into a single complex one
  • Option to only generate contracts (no Refit interfaces)

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 1.2.0

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema
  • --skip-default-additional-properties CLI tool argument to skip default additional properties
  • --operation-name-generator CLI tool argument to NSwag IOperationNameGenerator implementation to use.
  • --use-observable-response CLI tool argument to return IObservable<T>
  • --use-apizr CLI tool argument to generate Apizr specific Refit interfaces and configuration code
  • --use-dynamic-querystring-parameters CLI tool argument to wrap multiple query parameters into a single complex one
  • --contract-only CLI tool to only generate contracts/models without any Refit interfaces

What's Changed

New Contributors

Full Changelog: https://github.com/christianhelle/refitter/compare/1.1.3...1.2.0

refitter - v1.1.3

Published by christianhelle 3 months ago

What's New

  • Add optional RefitterSettings in generated IoC registration code
  • Introduce --immutable-records CLI tool argument
  • Improve telemetry for --settings-file usage

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 1.1.3

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema
  • --skip-default-additional-properties CLI tool argument to skip default additional properties
  • --operation-name-generator CLI tool argument to NSwag IOperationNameGenerator implementation to use.
  • --use-observable-response CLI tool argument to return IObservable<T>

Contributions

New Contributors

What's Changed

Full Changelog: https://github.com/christianhelle/refitter/compare/1.1.1...1.1.3

refitter - v1.1.1

Published by christianhelle 4 months ago

What's New

  • Add support for Microsoft HTTP Resilience library
  • Add support for generating immutable records

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 1.1.1

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema
  • --skip-default-additional-properties CLI tool argument to skip default additional properties
  • --operation-name-generator CLI tool argument to NSwag IOperationNameGenerator implementation to use.
  • --use-observable-response CLI tool argument to return IObservable<T>

Contributions

New Contributors

Full Changelog: https://github.com/christianhelle/refitter/compare/1.0.1...1.1.1

refitter - v1.0.1

Published by christianhelle 4 months ago

What's New

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 1.0.1

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema
  • --skip-default-additional-properties CLI tool argument to skip default additional properties
  • --operation-name-generator CLI tool argument to NSwag IOperationNameGenerator implementation to use.
  • --use-observable-response CLI tool argument to return IObservable<T>

Contributions

New Contributors

Full Changelog: https://github.com/christianhelle/refitter/compare/0.8.7...1.0.1

refitter - v1.0.0

Published by christianhelle 6 months ago

What's New

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 1.0.0

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema
  • --skip-default-additional-properties CLI tool argument to skip default additional properties
  • --operation-name-generator CLI tool argument to NSwag IOperationNameGenerator implementation to use.
  • --use-observable-response CLI tool argument to return IObservable<T>

Contributions

New Contributors

Full Changelog: https://github.com/christianhelle/refitter/compare/0.8.7...1.0.0

refitter - v0.9.9

Published by christianhelle 8 months ago

What's New

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 0.9.9

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema
  • --skip-default-additional-properties CLI tool argument to skip default additional properties
  • --operation-name-generator CLI tool argument to NSwag IOperationNameGenerator implementation to use.
  • --use-observable-response CLI tool argument to return IObservable<T>

What's Changed

New Contributors

Full Changelog: https://github.com/christianhelle/refitter/compare/0.8.7...0.9.9

refitter - v0.9.8

Published by christianhelle 8 months ago

What's New

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 0.9.8

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema
  • --skip-default-additional-properties CLI tool argument to skip default additional properties
  • --operation-name-generator CLI tool argument to NSwag IOperationNameGenerator implementation to use.
  • --use-observable-response CLI tool argument to return IObservable<T>

What's Changed

New Contributors

Full Changelog: https://github.com/christianhelle/refitter/compare/0.8.7...0.9.8

refitter - v0.9.7

Published by christianhelle 9 months ago

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 0.9.7

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema
  • --skip-default-additional-properties CLI tool argument to skip default additional properties
  • --operation-name-generator CLI tool argument to NSwag IOperationNameGenerator implementation to use.

What's Changed

New Contributors

Full Changelog: https://github.com/christianhelle/refitter/compare/0.8.7...0.9.7

refitter - v0.9.6

Published by christianhelle 9 months ago

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 0.9.6

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema
  • --skip-default-additional-properties CLI tool argument to skip default additional properties
  • --operation-name-generator CLI tool argument to NSwag IOperationNameGenerator implementation to use.

What's Changed

New Contributors

Full Changelog: https://github.com/christianhelle/refitter/compare/0.8.7...0.9.6

refitter - v0.9.5

Published by christianhelle 9 months ago

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 0.9.5

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema
  • --skip-default-additional-properties CLI tool argument to skip default additional properties
  • --operation-name-generator CLI tool argument to NSwag IOperationNameGenerator implementation to use.

What's Changed

New Contributors

Full Changelog: https://github.com/christianhelle/refitter/compare/0.8.7...0.9.5

refitter - v0.9.4

Published by christianhelle 9 months ago

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 0.9.4

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema
  • --skip-default-additional-properties CLI tool argument to skip default additional properties
  • --operation-name-generator CLI tool argument to NSwag IOperationNameGenerator implementation to use.

What's Changed

New Contributors

Full Changelog: https://github.com/christianhelle/refitter/compare/0.8.7...0.9.4

refitter - v0.9.2

Published by christianhelle 9 months ago

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 0.9.2

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema
  • --skip-default-additional-properties CLI tool argument to skip default additional properties
  • --operation-name-generator CLI tool argument to NSwag IOperationNameGenerator implementation to use.

What's Changed

Full Changelog: https://github.com/christianhelle/refitter/compare/0.8.7...0.9.2

refitter - v0.9.0

Published by christianhelle 9 months ago

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 0.9.0

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema
  • --skip-default-additional-properties CLI tool argument to skip default additional properties
  • --operation-name-generator CLI tool argument to NSwag IOperationNameGenerator implementation to use.

What's Changed

Full Changelog: https://github.com/christianhelle/refitter/compare/0.8.7...0.9.0

refitter - v0.8.7

Published by christianhelle 10 months ago

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 0.8.7

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema

What's Changed

Full Changelog: https://github.com/christianhelle/refitter/compare/0.8.5...0.8.7

refitter - v0.8.5

Published by christianhelle 11 months ago

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 0.8.5

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema

What's Changed

Full Changelog: https://github.com/christianhelle/refitter/compare/0.7.5...0.8.5

refitter - v0.8.4

Published by christianhelle 12 months ago

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 0.8.4

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set
  • --trim-unused-schema CLI tool argument to remove unreferenced components schema to keep the generated output to a minimum
  • --keep-schema CLI tool argument to specify a collection of regular expressions to force to keep matching schema. This is used together with --trim-unused-schema

What's Changed

Full Changelog: https://github.com/christianhelle/refitter/compare/0.7.5...0.8.4

refitter - v0.8.3

Published by christianhelle 12 months ago

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 0.8.3

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set

What's Changed

Full Changelog: https://github.com/christianhelle/refitter/compare/0.7.5...0.8.3

refitter - v0.8.2

Published by christianhelle about 1 year ago

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 0.8.2

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template. This can also be used to customize the Execute() method name in the interfaces generated when --multiple-interfaces ByEndpoint is set

What's Changed

Full Changelog: https://github.com/christianhelle/refitter/compare/0.7.5...0.8.2

refitter - v0.8.1

Published by christianhelle about 1 year ago

Installation

This is packaged as a .NET Tool and is published to nuget.org. You can install this specific version of this tool like this:

dotnet tool install --global Refitter --version 0.8.1

Features

  • Generate single file containing Refit interface and contract types from an OpenAPI spec file
  • Supports OpenAPI v2 and v3
  • Supports OpenAPI specifications in JSON and YAML formats
  • Supports OpenAPI specification validation and error/warning/stats reporting
  • Supports generating route, query, header, and body request parameters
  • Generate code at build time using rosyln C# source generator Refitter.SourceGenerator
  • --no-auto-generated-header CLI tool argument to skip prefixing output file with header
  • --interface-only CLI tool argument to skip contract type generation
  • --use-api-response CLI Tool argument to return IApiResponse<T> instead of Task<T>
  • --internal CLI tool argument to generate types with the internal accessibility modifier
  • --cancellation-tokens CLI tool argument to generate the Refit interface with CancellationTokens
  • --no-operation-headers CLI tool argument to skip generating [Header] parameters
  • --no-logging CLI tool argument to disable error logging and feature usage tracking
  • --use-iso-date-format CLI tool argument to explicitly format date query string parameters in ISO standard date format using delimiters (2023-06-15)
  • --multiple-interfaces CLI tool argument to generate a Refit interface for each endpoint. This may be either ByEndpoint or ByTag
  • --settings-file CLI tool argument to use a .refitter format file and override all other arguments
  • --skip-validation CLI tool argument to ignore all validation errors and attempt to generate code anyway
  • --match-path CLI tool argument to only include Paths that match the provided regular expression. May be set multiple times
  • --tag CLI tool argument to only include Endpoints that contain this tag. May be set multiple times and result in OR'ed evaluation
  • --optional-nullable-parameters CLI tool argument to make non-required query parameters to optional parameters in Refit interface
  • --operation-name-template CLI tool argument to append a prefix or suffix to the {operationName} template

What's Changed

Full Changelog: https://github.com/christianhelle/refitter/compare/0.7.5...0.8.1

Badges
Extracted from project README
Build Smoke Tests NuGet Quality Gate Status codecov All Contributors
Related Projects