Skip to content

3.0.0 - 2025-02-15

Compare
Choose a tag to compare
@github-actions github-actions released this 17 Feb 23:19

Release Notes

A major release! The main focus of this release is the introduction of shell commands for data querying and export. Previously, you could query response bodies within the TUI only using JSONPath. This limited querying only to JSON responses, and the limited amount of operators supported by JSON. Now, you can use whatever shell commands you want (such as head, grep, and jq) to filter your reponses bodies, right in the TUI! Check out the docs for more examples.

In addition to the querying change, this release includes a handful of breaking changes, none of which are likely to cause issues for existing users.

Breaking

  • Don't store CLI requests in history
  • Simplify display for slumber request
    • The flags --status, --headers and --no-body have been removed in favor of a single --verbose flag
  • Remove DB migration to upgrade from the pre-1.8.0 DB format
    • This only impacts users upgrading to 3.0.0 from versions before 1.8.0. You'll need to upgrade to an intermediate version first. If you install 3.0.0 and try to start it, you'll see an error message explaining how to fix it.
    • See #306 for more info

Added

  • Replace JSONPath querying with general purpose shell commands for querying response bodies. See docs
    • Now you can access any CLI tools you want for transforming response bodies, such as jq or grep
    • By default, commands are executed via sh (or cmd on Windows), but this is configured via the commands.shell field
  • Add keybind (: by default) to run an "export" command with a response body, allowing you to run arbitrary shell commands to save a response body to a file, copy it to the clipboard, etc. See docs
  • Add slumber history subcommand. Currently it has two operations:
    • slumber history list lists all stored requests for a recipe
    • slumber history get prints a specific request/response
  • Add --output flag to slumber request to control where the response body is written to
  • Support MIME type mapping for pager config field, so you can set different pagers based on media type. See docs
  • Several changes related to keybinds and action menus to make the two feel more cohesive
    • Add "Edit" and "Reset" actions to menus on the recipe pane
      • These don't provide any new functionality, as the e and z keys are already bound to those actions, but it should make them more discoverable
    • Add keybind (v by defualt) to open a recipe/request/response body in your pager
      • Previously this was available only through the actions menu
    • "View Body" and "Copy Body" actions for a recipe are now only available within the Body tab of the Recipe pane
      • Previously they were available anywhere in the Recipe List or Recipe panes. With the addition of other actions to the menu it was started to feel cluttered

Changed

  • Denote templates that have been edited during the current session with italics instead of a faint "(edited)" note
  • Header names in recipes are now lowercased in the UI
    • They have always been lowercased when the request is actually sent, so now the UI is just more representative of what will be sent
  • Accept a directory for the --file/-f CLI argument

Fixed

  • Fix certain recipe-related menu actions being enabled when they shouldn't be

Install slumber 3.0.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/LucasPickering/slumber/releases/download/v3.0.0/slumber-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy ByPass -c "irm https://github.com/LucasPickering/slumber/releases/download/v3.0.0/slumber-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install LucasPickering/tap/slumber

Download slumber 3.0.0

File Platform Checksum
slumber-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
slumber-x86_64-apple-darwin.tar.xz Intel macOS checksum
slumber-x86_64-pc-windows-msvc.zip x64 Windows checksum
slumber-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum
slumber-x86_64-unknown-linux-musl.tar.xz x64 MUSL Linux checksum