Repository navigation
3.0.0 - 2025-02-15
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,--headersand--no-bodyhave been removed in favor of a single--verboseflag
- The flags
- 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
jqorgrep - By default, commands are executed via
sh(orcmdon Windows), but this is configured via thecommands.shellfield
- Now you can access any CLI tools you want for transforming response bodies, such as
- 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 historysubcommand. Currently it has two operations:slumber history listlists all stored requests for a recipeslumber history getprints a specific request/response
- Add
--outputflag toslumber requestto control where the response body is written to - Support MIME type mapping for
pagerconfig 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
eandzkeys are already bound to those actions, but it should make them more discoverable
- These don't provide any new functionality, as the
- Add keybind (
vby 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
- Add "Edit" and "Reset" actions to menus on the recipe pane
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/-fCLI argument- If a directory is given, the standard rules for detecting a collection file will be applied from that directory
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 | shInstall 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/slumberDownload 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 |