34 KiB
toc
| toc | ||
|---|---|---|
|
Redocly CLI changelog
1.0.0-beta.126 (2023-05-10)
Features
- Added new options for the
joincommand:--decorateand--preprocess.
Fixes
- Fixed a bug with external OAS (x-) attributes containing an array.
- Display an error if the api path refers to a folder.
- Fixed the
pushcommand not recognising API definitions with spaces. - Defined default
allowedValuesin theallruleset for mime-type rules
Changes
- Display an error if apis or rules for the
lintcommand are not provided. - Ceased executing decorators and preprocessors upon the
joincommand. - Sort top-level OAS3 keys in
bundleandjoincommands.
1.0.0-beta.125 (2023-04-06)
Features
- Added the required-min-length-string-type-property rule that requires required properties in the API definition with type
stringto have aminLength.
Fixes
- Fixed an issue with
$refin path parameters during thejoincommand. - This release also includes various internal stability fixes and improvements.
Changes
- Changed the arguments for assertion custom functions. Now as the third parameter, instead of a
locationobject, assertion custom functions include actxobject. See Custom functions.
1.0.0-beta.124 (2023-03-09)
- Fixed an issue with remote file inside the lint ignore file.
1.0.0-beta.123 (2023-01-02)
Fixes
- Fixed an issue with
pushcommand not executing when organization is provided via redocly.yaml
1.0.0-beta.122 (2023-01-26)
Fixes
- Fixed an issue with
pushcommand not working with a validorganizationId.
1.0.0-beta.121 (2023-01-25)
Features
- Added custom output file option to the
joincommand. - Added an option to include webhooks to operation-4xx-response rule.
- Added a new built-in decorator info-override.
- Added support for
/as a separator which puts paths into subdirectories for each path segment with the split command.
Fixes
- Ignored case when inferring file extension from code sample
langproperty.
Changes
- Moved and renamed the
features.openapiandfeatures.mockServerinto thethemeobject with the namesopenapiandmockServer.
Before:
features.openapi: {}
features.mockServer: {}
After:
theme:
openapi: {}
mockServer: {}
1.0.0-beta.120 (2023-01-05)
Fixes
- Fixed an issue where
$refsweren't resolved inside specification extensions.
1.0.0-beta.119 (2023-01-03)
Fixes
- Fixed an issue where the
specrule showed an error forx-logoproperties in the 3.1 OpenAPI definition.
1.0.0-beta.118 (2022-12-29)
Features
- Enabled removing unused components in the config to use within the bundle command.
- Implemented special SpecExtension type
VendorExtension. - Added an error handler for the case when the definition or a plugin does not exist.
- Added
media-type-examples-overridedecorator.
Fixes
- Fixed an issue where the rule spec-components-invalid-map-name is not applied for all examples and adjusted the logic behind the rule in general.
1.0.0-beta.116 (2022-12-7)
Fixes
- Fixed an issue with scalar assertion failing when an object is of invalid type.
Features
- Added Redoc vendor extensions to supported types.
1.0.0-beta.115 (2022-11-29)
Features
- Added support for
anytype in assertions.
Changes
- Renamed the Docker image on Docker Hub.
- Changed assertions errors grouping.
- Removed orphaned git submodule
public_api_docs.
1.0.0-beta.114 (2022-11-18)
Features
- Added a new assertion
notPatternto the custom rules.
1.0.0-beta.113 (2022-11-15)
Changes
- Removed automatically adding the
recommendedconfiguration when there is a config defined without anextendslist.
Fixes
- Fixed an issue with undefined
process.cwdin browser environment. - Fixed an issue with
$anchorsin OpenAPI documents are not properly parsed. - Fixed an issue with the
specrule not reporting onnullablein Schema object that don't have atypesibling. - Added missing OAS2 and OAS3 list types.
- Don't show false media type example errors when a discriminator is used with the
allOfkeyword.
1.0.0-beta.112 (2022-11-01)
Changes
- Changed assertions syntax and renamed to custom rules.
- Removed
info-descriptionrule. - Removed deprecated fields suggestions in Redocly config file.
1.0.0-beta.111 (2022-10-10)
Changes
- Renamed four type names for alignment with the OpenAPI specification.
PathsMaptoPathsResponsesMaptoResponsesEncodingsMaptoEncodingMapSecuritySchemeFlowstoOAuth2Flows
Features
- Added a new option
--keep-url-referencesto thebundlecommand that disables bundling of absolute URL$ref-s.
Fixes
- Improved location of problems produced by
security-definedrule. - Fixed an issue with
response-contains-headerbeing case-sensitive. - Fixed an issue with
path-params-definedrule that was not accounting for params defined on the operation level. - Fixed an issue with
typenot being validated if it is an array. - Fixed an issue with
apisoverrides not picking up some base values from the root config. - Fixed an issue with api not being detected from the
apislist if used as a file name.
1.0.0-beta.110 (2022-09-21)
Features
- Added the
build-docscommand which builds Redoc API docs into a zero-dependency HTML file. - Added the ability to upload other files and folders with the
pushcommand. - Added support for custom assertions as plugins.
Fixes
- Fixed incorrect behavior for the
no-invalid-media-type-examplesrule in combination with theallOfkeyword.
1.0.0-beta.109 (2022-09-08)
Features
- Added rfc7807 problem details rule.
- Improved error messages by adding
referenced frominformation. - Added the
spec-components-invalid-map-namerule for component map names validation. - Added a new lint
--formatoption:summary.
Fixes
- Fixed an issue with multi-line strings in literal mode.
- Fixed an issue with multi-line Markdown with Windows-style new lines.
- Fixed the Header object type to require
contentorschema. - Fixed a error message for
operation-4xx-responserule. - Fixed an issue with
pathsnot being correctly handled by thejoincommand. - Fixed the
operation-security-definedrule to check the security on the root and in each operation.
Changes
- Renamed 'DefinitionRoot', 'ServerVariableMap', 'PathMap', 'CallbackMap', 'MediaTypeMap', 'ExampleMap', 'EncodingMap', 'HeaderMap', and 'LinkMap' definition node types.
- Removed the
styleguideobject from the configuration file. - Renamed the
operation-security-definedrule tosecurity-defined.
1.0.0-beta.108 (2022-08-22)
Changes
- Renamed
no-servers-empty-enumtono-server-variables-empty-enumand fixed incorrect docs ofno-empty-enum-servers.
Features
- Add browser support for
openapi-core. - Allow accessing
configfield in subclasses extendingBaseResolverclass. - Ability to create config (e.g.
redocly.yaml) from string or object.
Fixes
- Fixed docs for
no-server-example.com. - Incorrect schema description dereferenced.
1.0.0-beta.107 (2022-08-16)
Changes
- Add
allowAdditionalPropertiesto built-in rules and markdisallowAdditionalPropertiesas deprecated.
Fixes
- Introduced severity level
offfor assertions.
1.0.0-beta.106 (2022-08-09)
Fixes
- Now errors exit with return code
1.
Changes
- Renamed
lintintostyleguidein Redocly configuration. - Improved naming consistency.
1.0.0-beta.105 (2022-07-27)
Fixes
- Fixed bug with an invalid path to the configuration file causing issues with the ignore file.
1.0.0-beta.104 (2022-07-11)
Fixes
- Fixed incorrect boolean filtering in
filter-outrule. - Fixed bug with tags duplication for the
joincommand. - Other internal stability fixes and improvements.
1.0.0-beta.103 (2022-06-27)
Features
- Added new property
refto assertation object. - Added the
--lint-configoption for thelintcommand. Use it to validate the configuration file with appropriate severity level. - Added new built-in decorators
filter-inandfilter-out.
Fixes
- Resolved an issue with the
--run-idoption for thepushcommand. The--run-idoption renamed to the--batch-id, added the--batch-sizeoption. - Improved types for the configuration file.
1.0.0-beta.102 (2022-06-09)
Features
- The
joincommand supports a new option--without-x-tag-groups. Use it to skip the creation and population ofx-tagGroups. - Added new property
requireAnyto assertation object. - Updated types. Added
showSecuritySchemeTypeanddisableTryItRequestUrlEncodingconfiguration options.
Fixes
- Fixed issue with
additionalItemsarray type.
1.0.0-beta.101 (2022-06-09)
Broken release.
1.0.0-beta.100 (2022-05-27)
Fixes
- Fixed types for
CallbackandNamedCallbacks. - Fixed an issue with the
scalar-property-missing-examplebuilt-in rule that didn't work on examples containing falsy values.
1.0.0-beta.99 (2022-05-25)
Features
- Added three new built-in rules:
response-contains-header,response-contains-property,scalar-property-missing-example. - The
bundlecommand supports a new option--keep-url-references. Use it to prevent Redocly CLI from resolving external URL references during bundling. - Added
addinionalItems,minContainsandmaxContainsarray types.
Fixes
- Resolved an issue with escaping symbols in code sample language names (the
langvalue in thex-codeSamplesspecification extension).
1.0.0-beta.98 (2022-05-18)
Features
- Updated types. Added
hideTryItPanel,schemaDefinitionsTagNameconfiguration options andx-hideTryItPanel,x-tagsOpenAPI specification extensions.
1.0.0-beta.97 (2022-05-10)
Features
- Added the
--publicoption to thepushcommand. With this option, you can upload OpenAPI definitions and make them publicly accessible. - Changed assertions syntax to this pattern:
assert/{assert name}
Fixes
- Fixed an issue with
process.*in core package that caused crashes in client-side builds. - Fixed
preview-docshot reload.
1.0.0-beta.96 (2022-05-06)
Technical release for changing the package name from @redocly/openapi-cli to @redocly/cli.
1.0.0-beta.95 (2022-05-04)
:::warning Product name change
The product name has changed from OpenAPI CLI to Redocly CLI.
You will notice this change reflected in all Redocly product documentation, in the npm package name (more on that in the "Deprecated" section), and later in the official project GitHub repository.
The change also affects the CLI commands. The legacy name openapi will remain supported for a while, but we strongly recommend you use the new name redocly.
(To illustrate, if you previously used openapi lint, now you should use redocly lint).
If you encounter any issues and suspect they may be related to this change, let us know by reporting an issue.
:::
Features
- The
lint.extendssection in the Redocly configuration file supports file paths and URLs as values. This means you can define your own lint rulesets in local or remote files, and list those files in theextendssection. The following example shows how to do it:
extends:
- recommended
- ./path/to/local/lint-ruleset.yaml
- https://url-to-remote/lint-ruleset.yaml
The contents of those referenced files must correspond to the standard format used in the rules object to configure the rules. Here is an example lint-ruleset.yaml file referenced above:
rules:
tags-alphabetical: error
- The
lintcommand supports a new output formatting option calledcodeclimatethat you can use with the--formatargument.
Fixes
- Fixed an issue with resolvable scalar values not working in assertions.
Deprecated
- Deprecated the
@redocly/openapi-clinpm package. From this version forward, use@redocly/cliinstead.
1.0.0-beta.94 (2022-04-12)
Features
- The
lintcommand supports usingunevaluatedPropertiesas boolean in OAS 3.1.x and no longer reports this as an error. - Internal changes.
1.0.0-beta.93 (2022-04-05)
Fixes
- Resolved an issue with the
pushcommand skipping dependencies.
1.0.0-beta.92 (2022-04-04)
Features
- Introduced custom rules - a new, powerful lint feature, which helps you enforce API design standards without coding (named
assertionsat the time of the release). - The
pushcommand supports a new--skip-decoratoroption.
Fixes
- Resolved an issue with
openapi preview-docsfailing during authorization.
1.0.0-beta-91 (2022-03-29)
Features
- Added the
--separatoroption to thesplitcommand. Use it to change the separator character that's used instead of whitespace in file names. The default is_, which means that after splitting, path file names look like this: "user_login.yaml", "user_logout", etc.
Fixes
- Resolved an issue with the
bundlecommand when handling files with multiple dots in the file name.
1.0.0-beta.90 (2022-03-24)
Fixes
- Updated types to support validation of the Redocly configuration file according to the new file structure.
1.0.0-beta.89 (2022-03-21)
Features
- Internal changes of
redocly.yamlconfig structure - add new mock server options toredocly.yamlschema.
Fixes
- Fixed crash when there's an empty
redocly.yamlfile.
1.0.0-beta.88 (2022-03-16)
Features
- Internal changes of
redocly.yamlconfig structure.
Fixes
- Fixed an issue with the
lintcommand highlighting the entire file whenserversare missing in OAS3. Now it highlights only theopenapifield, indicating an incorrect OpenAPI definition. - Fixed an issue with the
lintcommand highlighting all parent values when one of the child fields has an empty value instead of highlighting the field itself.
1.0.0-beta.87 (2022-03-10)
Fixes
- Fixed an issue with
process.envassignment that caused crashes in client-side builds. - Fixed an issue with
no-path-parameterrule reporting false-positives.
1.0.0-beta.86 (2022-03-09)
Features
- Allowed to name the config file either
.redocly.yamlorredocly.yaml.
Fixes
- The
specrule triggers an error when a parameter is missingschemaorcontentfields.
1.0.0-beta.85 (2022-03-02)
- Internal improvements
1.0.0-beta.84 (2022-02-23)
Fixes
- Fixed an issue with the
lintcommand crashing when theservers.urlfield is empty in the OpenAPI definition. - Fixed an issue with the
lintcommand crashing when anenumvalue is invalid.
1.0.0-beta.83 (2022-02-22)
Features
- Added the
webhooksand x-webhooks support to thesplitcommand.
1.0.0-beta.82 (2022-02-15)
Fixes
- Removed support for using OpenAPI CLI behind a proxy server.
1.0.0-beta.81 (2022-02-10)
Features
- Added support for using OpenAPI CLI behind a proxy server.
Fixes
- Fixed an issue with the
lintcommand not reporting errors whensecurityDefinitions.basiccontains the unsupportedadditionalPropertyin OAS2. - Fixed an issue with the
no-invalid-media-type-examplesbuilt-in rule that didn't work on examples containing a$ref. - Fixed an issue with the
lintcommand incorrectly reporting boolean schemas for array items as invalid. - Fixed an issue with
isPathParameterfailing because of an incorrect brace.
1.0.0-beta.80 (2022-01-24)
Fixes
- Fixed an issue with date-time conversion in YAML files.
- Fixed an issue with the
oauth2-redirect.htmlfile being absent when served bypreview-docscommand.
1.0.0-beta.79 (2022-01-10)
Fixes
- Fixed the
remove-x-internaldecorator to remove references to removedx-internalcomponents. - Fixed the
remove-unused-componentsdecorator that strips remotely referenced components.
1.0.0-beta.78 (2022-01-06)
Features
- Added the
remove-x-internalbuilt-in decorator. - Added the
--remove-unused-componentsoption to thebundlecommand.
1.0.0-beta.77 (2022-01-06)
Fixes
- Fixed an issue with backslashes in
$refsto paths with thesplitcommand in a Windows environment.
1.0.0-beta.76 (2021-12-28)
Features
- Exported
mapTypeToComponentfunction.
1.0.0-beta.75 (2021-12-24)
Features
- Added the
--hostoption to thepreview-docsCLI command.
Fixes
- Fixed an issue with continuous deployment to Docker Hub.
1.0.0-beta.74 (2021-12-22)
Fixes
- Fixed an issue with
constnot handled correctly by thelintcommand.
1.0.0-beta.73 (2021-12-16)
Fixes
- Resolved another backward compatibility issue with older versions of portal.
1.0.0-beta.72 (2021-12-16)
Fixes
- Fixed another backward compatibility issue with regions: save old config key to support old portal versions.
1.0.0-beta.71 (2021-12-16)
Fixes
- Fixed a backward compatibility issue with
REDOCLY_DOMAINin the EU region introduced in the previous release.
1.0.0-beta.70 (2021-12-14)
Features
- Added support for the region option with the
login,push, and other commands. - Added two new built-in rules:
Fixes
- Fixed an issue with the built-in
paths-kebab-caserule that disallowed paths with trailing slashes. - Fixed a validation issue with the
exampleproperty when the schema is an array.
1.0.0-beta.69 (2021-11-16)
Features
- Implemented new
--extendsand--metafileoptions for the bundle command.
1.0.0-beta.68 (2021-11-15)
Fixes
- Fixed an issue with hot reloading when running a preview of reference docs with
openapi preview-docs. - Fixed an issue with page refresh when pagination is set to
itemorsection. - Fixed an issue with inlining external schema when components' names match.
- Fixed an issue with fetching hosted schema on Windows when bundling OAS definitions.
- Fixed an issue for
no-server-trailing-slashwhen server url is a root.
1.0.0-beta.67 (2021-11-02)
Features
- Added a new built-in rule: operation-4xx-response.
1.0.0-beta.66 (2021-11-01)
Features
- Added five new built-in rules:
Fixes
- Fixed an issue with OAS 3.1 meta keywords reported as not expected.
- Fixed an issue with incorrect codeframe for
info-license-urlrule. - Fixed an issue with discriminator mapping not supported in
no-invalid-media-type-examples. - Fixed an issue with ignore file generated in windows not working on other systems, and in Redocly Workflows.
1.0.0-beta.65 (2021-10-27)
Features
- Added three built-in decorators -
info-description-override,tag-description-override,operation-description-override- that let you modify your API definitions during the bundling process. Use these decorators in thelintsection of your.redocly.yamlfile to point OpenAPI CLI to Markdown files with custom content. That custom content will replace any existing content in theinfo.descriptionfield, and intags.descriptionandoperation.descriptionfields for specified tag names and operation IDs.
The following examples show how to add the decorators to the .redocly.yaml file:
lint:
decorators:
info-description-override:
filePath: ./my-custom-description.md
lint:
decorators:
tag-description-override:
tagNames:
pet: ./my-custom-description.md
lint:
decorators:
operation-description-override:
operationIds:
updatePet: ./my-custom-description.md
- Improved documentation for the lint command.
Fixes
- Fixed the the
bundlecommand to return a non-zero code when it detects an error when used with the--lintoption.
1.0.0-beta.64 (2021-10-20)
Fixes
-
Fixed an issue with the
--formatoption not working with thebundlecommand. -
Fixed a validation issue with the non-string
openapivalue in API definitions. Thelintcommand now warns if the value is not string instead of crashing.
1.0.0-beta.63 (2021-10-12)
Features
- Upgraded the
js-yamlpackage from v.3 to v.4 with YAML 1.2 support. This resolves issues with parsing timestamps and example strings with leading zeros in YAML.
1.0.0-beta.62 (2021-09-30)
Fixes
- Resolved an issue with the
--max-problemsoption that was not working with thebundlecommand.
1.0.0-beta.61 (2021-09-21)
Features
- Improved validation of values for the following fields in the Schema Object:
multipleOf, maxLength, minLength, maxItems, minItems, maxProperties, minProperties.
1.0.0-beta.60 (2021-09-20)
Fixes
- Fixed an issue with the
joincommand crashing when trying to resolve $ref.
1.0.0-beta.59 (2021-09-15)
Fixes
-
Resolved an issue with the
preview-docscommand not working when runningopenapi-cliin a Docker container. -
Improved the security of local documentation previews by removing query parameters from the request URL.
1.0.0-beta.58 (2021-09-02)
Fixes
- Internal improvements to configuration types.
1.0.0-beta.57 (2021-09-01)
Fixes
- Simplified the login check query to improve performance.
1.0.0-beta.56 (2021-09-01)
Features
-
Added a function for linting the
.redocly.yamlconfiguration file. -
Published the OpenAPI CLI quickstart guide as part of our Google Season of Docs 2021 project.
1.0.0-beta.55 (2021-08-20)
Features
-
Updated and improved the introductory content and installation instructions for OpenAPI CLI as part of our Google Season of Docs 2021 project.
-
Implemented improvements to the internal CD process.
1.0.0-beta.54 (2021-07-19)
- Internal changes.
1.0.0-beta.53 (2021-07-02)
Fixes
-
Resolved an issue with transitive $ref resolution in the JSON schema validator.
-
If the JSON schema validator crashes, OpenAPI CLI will now report the problem in the output instead of crashing itself.
1.0.0-beta.52 (2021-07-01)
Fixes
- The
operation-operationIdrule no longer triggers a warning when one or more operations in thecallbacksobject don't haveoperationIddefined.
1.0.0-beta.51 (2021-06-30)
Features
-
Our official OpenAPI CLI documentation is now open-source! 🥳 You can find the source of all pages published on our website in the
docsfolder of the openapi-cli repository. We invite you to help us improve the documentation and make it more usable for everyone. Please make sure to always follow our Code of conduct in all your contributions. -
Implemented support for OpenAPI 3.1 in
typeExtensionplugins.
Fixes
-
Resolved a crash caused when processing properties with the
nullvalue. -
Resolved a "Maximum call stack size exceeded" issue in the JSON schema validator caused by recursive
oneOf.
1.0.0-beta.50 (2021-06-08)
Fixes
- Implemented improvements to the
openapi-clipackage to reduce the size of the browser bundle.
1.0.0-beta.49 (2021-06-01)
Fixes
-
Removed unused keywords in OpenAPI 3.1.
-
Resolved an issue with the
openapi bundlecommand failing because of the missingjs-yamldependency.
1.0.0-beta.48 (2021-05-25)
Fixes
- Resolved an issue with the plugin ID being prefixed to all rules, preprocessors and decorators multiple times (for example, when using the
preview-docscommand and changing configuration files).
1.0.0-beta.47 (2021-05-21)
Features
- The
bundlecommand now supports an optional--lintparameter.
Fixes
-
Improved the error messages for
kebab-caseand implemented detection ofsnake_caseusage in paths. -
The
joincommand will no longer overwrite an existingx-displayNameof a tag with the tag'snameproperty.
1.0.0-beta.46 (2021-05-17)
Features
- Implemented support for OpenAPI 3.1. You can now lint, validate, and bundle your OAS 3.1 definitions with OpenAPI CLI.
1.0.0-beta.45 (2021-05-09)
Fixes
- Resolved a validation issue for
enumitems with the nullable property. Validation errors are no longer reported whennullable: trueforenumitems that contain anullvalue.
1.0.0-beta.44 (2021-04-12)
Fixes
- The
browserfield inpackage.jsonis now set to simplify usingopenapi-corein browser-based builds.
1.0.0-beta.43 (2021-04-09)
Fixes
- The root API definition document is now parsed in all cases, even if it doesn't report the correct MIME type or doesn't use any of the supported file extensions.
1.0.0-beta.42 (2021-04-06)
Fixes
- Improved
openapi-coreso that it can be used within our other projects including Redoc, Reference docs, and Developer portal.
1.0.0-beta.41 (2021-04-02)
Fixes
- Resolved an issue with the
--dereferencedCLI option not functioning properly.
1.0.0-beta.40 (2021-03-31)
Fixes
- Resolved an issue where transitive $refs that span multiple files would crash the validation in some cases.
1.0.0-beta.39 (2021-03-26)
Fixes
- Resolved a hot-reloading issue with the
preview-docscommand. It will now automatically reload the docs in the browser when you make live changes to an OpenAPI definition.
1.0.0-beta.38 (2021-03-20)
Fixes
- Exported a helper function from
openapi-coreand implemented defaults for some functions to improve integration with the Developer portal.
1.0.0-beta.37 (2021-03-16)
Fixes
- Implemented error handling for failed file uploads when using the
pushcommand. The command now displays success/failure messages in the output.
1.0.0-beta.36 (2021-03-15)
Features
- Source type was changed from
FILEtoCICDto support integration with the new CI/CD source in Workflows.
1.0.0-beta.35 (2021-03-12)
Features
- OpenAPI CLI now has tab completion for global installations. Run
openapi completionfor instructions to set it up in your environment.
1.0.0-beta.34 (2021-03-10)
Features
- OpenAPI CLI now has an official Docker image! You can get it from Docker Hub.
1.0.0-beta.33 (2021-03-10)
Features
- You can now use the
--verboseparameter with thelogincommand to show a detailed error trace (if any). Detailed error output will no longer be displayed by default for this command.
1.0.0-beta.32 (2021-02-25)
Features
-
The "access token" has been renamed to "API key" in the output of relevant OpenAPI CLI commands (
login,push) to make it clearer what information the users must provide. -
For improved security, the API key is now hidden (masked) when the user provides it in the terminal, and it's not logged in the user's history.
1.0.0-beta.31 (2021-01-25)
Features
- The
bundlemethod is now able to acceptDocumentdirectly in openapi-core.
1.0.0-beta.30 (2021-01-25)
Features
- OpenAPI CLI now automatically resolves all $refs by default, even in places where they are not allowed by the specification ("incorrect $refs"). This functionality can be disabled for examples by setting
doNotResolveExamplestotrueinredocly.yaml.
1.0.0-beta.29 (2021-01-13)
Fixes
- Fixed an issue with incorrect base directory when resolving transitive
$refs.
1.0.0-beta.28 (2021-01-09)
Fixes
- Resolved an issue with nested filepaths that caused the
pushcommand to upload files to the wrong path when used on Windows systems.
1.0.0-beta.27 (2021-01-06)
Features
- A new command called
pushis now supported by OpenAPI CLI. With this command, you can upload your API definitions and associated files, and set up your own CI pipeline for updating API definitions without granting Redocly Workflows access to your repositories.
Fixes
- Resolved an issue that prevented using the
.(dot) symbol in version names with thepushcommand.
1.0.0-beta.25 (2020-11-27)
Fixes
-
Resolved an issue with
assert-node-versionusing the wrong path. -
OpenAPI CLI will now bundle the API definition before gathering stats.
1.0.0-beta.23 (2020-11-24)
Fixes
-
Resolved issues with tag logic and tag display names for the
joincommand. -
Refactored CLI command handlers.
1.0.0-beta.22 (2020-11-16)
Features
- A new command called
joinis now available in OpenAPI CLI. Use it to combine two or more API definition files into one. The resulting file optionally helps distinguish the origin of OpenAPI objects and properties by appending custom prefixes to them. Note that this command is considered experimental; meaning, it's still a work in progress.
1.0.0-beta.19 (2020-11-13)
Features
- The previously single OpenAPI CLI package has been split into two:
openapi-cliandopenapi-core.
1.0.0-beta.18 (2020-10-19)
Features
- OpenAPI CLI now supports the
splitcommand, which you can use to create a multi-file structure out of an API definition file by extracting referenced parts into standalone, separate files. The command doesn't support OAS 2.
Fixes
- Resolved an issue with counting operation tags in the
statscommand.
1.0.0-beta-16 (2020-09-28)
Features
- A new command called
statshas been implemented. It provides statistics about the structure of one or more API definition files, and lets you choose the format in which the statistics will be presented.
Fixes
- Resolved an issue with the
globlibrary by installing the missing package.
1.0.0-beta-15 (2020-09-25)
Fixes
-
Resolved an issue with the extended regex path which was missing the dot symbol.
-
Added support for non-compatible globbing shells.
1.0.0-beta-14 (2020-09-14)
Fixes
- Added the missing label definition for
x-codeSamplesand enabledx-codeSamplesfor OAS 2.
1.0.0-beta-13 (2020-09-13)
Fixes
-
Fixed the required field name for
openIdConnectUrl. -
Resolved an issue with detecting duplicated plugin IDs, and added a warning that plugin IDs must be unique.
-
Adedd
enginesandengineStricttopackage.json. -
Implemented better handling and error messages for invalid severity values.
1.0.0-beta-12 (2020-09-08)
Fixes
- Previously, OpenAPI CLI tried to use
/instead of\for file path splitting on Windows machines. The issue has been resolved by implementing platform-specific separator usage.
1.0.0-beta-11 (2020-09-03)
Fixes
- Resolved an issue with missing support for external plugins in the bundled version.
1.0.0-beta.10 (2020-08-31)
Fixes
-
Fixed a crash that happened when attempting to resolve back-references.
-
The version number of OpenAPI CLI is now printed in the JSON output.
1.0.0-beta.9 (2020-08-20)
Features
-
The
--formatoption now supports JSON as one of the output formats you can choose when using OpenAPI CLI commands. -
Bundling and uploading are now part of the build process.
-
Warnings and errors are now displayed as separate counts in JSON output.
-
All parts of a pointer are now used to generate unique component names when needed.
-
Added support for linting
x-webhooks, which is a forward-compatibility vendor extension forwebhooksfrom OpenAPI 3.1.
Fixes
-
Removed an extra blank line that was printed when no rules were ignored.
-
Resolved an issue with missing types for
OasDecoratorandOas3Decorator. -
Resolved a tag syntax error when deploying to Workflows.
-
Relative paths are now used for JSON output.
1.0.0-beta.8 (2020-07-30)
Fixes
- Added mime-type handling for remote docs.
1.0.0-beta-7 (2020-07-26)
Fixes
-
Fixed the callbacks type definition.
-
Fixed invalid component names for some components.
-
Resolved an issue with bundling local references.
-
Resolved a minor issue where the help message displayed references to the
registry:logincommand instead of thelogincommand.
1.0.0-beta.5 (2020-07-21)
Fixes
-
Fixed invalid unescape and
decodeURIComponent. -
Updated the
extendsparameter logic to allow configuration overrides. -
Improved handling logic and error message when the input file is not an OpenAPI document.
1.0.0-beta.4 (2020-07-14)
Fixes
-
Resolved an issue with detecting output file extension without an entrypoint.
-
Resolved an issue with the
preview-docscommand failing to automatically select the first definition from theapiDefinitionssection of the configuration file when used without arguments. -
Fixed an issue with relative paths for entrypoints from external configuration files.
1.0.0-beta.3 (2020-07-10)
Fixes
-
The
default.hbsfile is now copied to the build directory. -
Resolved an issue with the preview functionality failing to access
watcher.
1.0.0-beta.2 (2020-07-09)
Fixes
-
Resolved an issue with the
no-path-trailing-slashrule showing errors for the wrong location and path. -
Fixed a transitive resolve issue.
1.0.0-beta.1 (2020-07-09)
First beta release!