tui-postman 1.0.0

A terminal-based (TUI) alternative to Postman

🚀 Termina (TUI Postman)

A blazing-fast, local-first Terminal User Interface (TUI) alternative to Postman and Insomnia. Built entirely in Python using the textual framework and httpx, it allows you to construct and execute HTTP requests without ever leaving your terminal.

✨ Features

• Local-First & Fast: No accounts, no cloud syncing, no electron-app bloat.
• Global CLI: Installs directly as a terminal command (TUI_postman).
• Syntax Highlighting: Automatically pretty-prints and highlights JSON responses.
• Async Execution: The UI remains perfectly smooth and responsive while waiting for network requests to complete.
• Keyboard Friendly: Use Tab to navigate inputs, Ctrl+Q to quit safely, or just click the UI elements with your mouse!

---

🛠️ Installation

1. Clone or Download this directory.
2. Create a Virtual Environment (Highly Recommended):

   python -m venv venv
   

3. Activate the Virtual Environment:
   • Windows (PowerShell): .\venv\Scripts\Activate.ps1
   • Mac/Linux: source venv/bin/activate
4. Install the Package Locally: Run the following command from the root folder (where pyproject.toml is located) to install all dependencies and register the CLI command:

   pip install -e .
   

---

💻 Usage

Once installed, you can launch the application from anywhere by simply typing:

TUI_postman

Making a Request:

1. Method: Select your HTTP method (GET, POST, PUT, DELETE, PATCH) from the dropdown.
2. URL: Enter your target endpoint (e.g., https://jsonplaceholder.typicode.com/todos/1).
3. Headers: (Optional) Add custom headers in valid JSON format in the Headers tab.
4. Body: (Optional) If sending a POST/PUT request, add your JSON payload in the Body tab.
5. Send: Click the green Send button.

The response pane on the right will instantly display the Status Code, Response Time, and the formatted output from the server.

Exiting:

Click the Quit button at the top, or press Ctrl+Q to close the application cleanly.

---

📦 Tech Stack

• Textual: The core TUI framework for building the user interface.
• httpx: The asynchronous HTTP client.
• Pygments: Handles the syntax highlighting for JSON payloads.