Overview

This release brings a few important changes worth calling out:

1. Freedesktop conventions are now followed, meaning the location of configuration and cache files is now operating-system dependent. Files are automatically moved over when running the new Restish release. The new restish api edit command makes it easy to edit your API configuration, which will now be located:

   • Mac: ~/Library/Application Support/restish/apis.json
   • Linux: ~/.config/restish/apis.json
   • Windows: %AppData%\restish\apis.json

   More docs here: https://rest.sh/#/configuration

2. If no OpenAPI server locations match, the default operation base path is now the path component of the base configuration value. This can be overridden via the operation_base parameter. See docs at https://rest.sh/#/configuration?id=operation-base-path

3. Local and remote references are now supported in OpenAPI, including relative refs with the base set to the location of the OpenAPI file. Restish can now officially load the DigitalOcean API spec.

What's Changed

• Various documentation fixes by @waldyrious in #173
• fix: bulk version inconsistency bug by @danielgtaylor in #181
• fix: use configured base as base path if no servers present by @danielgtaylor in #185
• docs: use capitalized forms of HTTP verbs by @waldyrious in #182
• chore(deps): bump golang.org/x/image from 0.1.0 to 0.5.0 by @dependabot in #175
• fix api show doc and add api configure command by @lalmeras in #184
• chore(deps): bump golang.org/x/net from 0.2.0 to 0.7.0 by @dependabot in #176
• fix: mermaid import which broke going ESM only by @danielgtaylor in #186
• fix: upgrade shorthand to fix nested field selection bug by @danielgtaylor in #187
• Correct occurrences of "Setup" that should say "Set up" instead by @waldyrious in #193
• docs: Improve API configuration documentation by @waldyrious in #192
• docs: link directly to section on registering APIs by @waldyrious in #191
• Clarify docs links in README by @waldyrious in #190
• Update openapi.go by @metadatadriven in #198
• feat: add gron greppable output format by @danielgtaylor in #196
• Adhere to freedesktop conventions (instead of ~/.restish) fixes #98 by @danielgtaylor in #200
• Adhere to freedesktop conventions (instead of ~/.restish) fixes #98 by @mterron in #177
• finished last bit of the gron outputter implementation by @traviscampbell in #206
• Expand installation instructions; add Nixpkgs option by @waldyrious in #204
• feat: API edit command; apis.json schema by @danielgtaylor in #208
• feat: operations base path config option by @danielgtaylor in #209
• feat: deflate support by @danielgtaylor in #210
• feat: document args/options schemas, fixes #157 by @danielgtaylor in #212
• fix: generate operation ID if not present, fixes #201 by @danielgtaylor in #213
• Support remote references in openapi by @danielgtaylor (really @zak905) in #211

New Contributors

• @dependabot made their first contribution in #175
• @lalmeras made their first contribution in #184
• @metadatadriven made their first contribution in #198
• @mterron made their first contribution in #177
• @traviscampbell made their first contribution in #206

Full Changelog: v0.17.0...v0.18.0