Posting
lastmod 2024-07-21created 2024-07-211 edits
The modern API client that lives in your terminal.
HTTP API client for the terminal
Features
- TUI application built with Textual
- "Jump mode" navigation : press Ctrl+o and a key overlay appears on screen; press the shown key to jump straight to the widget you want
- Syntax highlighting powered by Tree-sitter
- Environment/variable system with autocompletion support
- Various built-in themes and a configuration system
- Vim key support : many parts of the UI can be navigated with Vim keys
- Built using Textual
Collections
- Requests are stored directly on the file system as simple YAML files (.posting.yaml), making them easy to read and version-control
- You can open a collection (a directory containing requests) with the --collection option
- If no directory is specified, the default collection directory is used
Tab navigation
- Move focus between widgets with Tab and Shift+Tab
- Move within a widget with j/k/up/down
- Can also move between widgets with up/down
Keyboard shortcuts
- Main shortcuts are shown at the bottom of the screen
- Additional shortcuts are listed in a table
Importing OpenAPI specs
- Can convert OpenAPI 3.x specs into collections (experimental feature)
- Import an OpenAPI spec with the command posting import path/to/openapi.yaml
- If no output directory is specified, the default collection directory is used
- Tries to build a file structure in the collection that matches the URL structure of the imported API