Http Request Builder

# HTTP Request Builder

## What This Does

A CLI tool to build, test, and save HTTP requests. Send requests with custom headers, authentication, body, and cookies. Save requests as templates for reuse and maintain a history of your HTTP calls.

Key features:
- **Send HTTP requests** with GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS methods
- **Set custom headers** with key-value pairs
- **Add authentication** (Basic Auth, Bearer tokens)
- **Include request body** (JSON, form data, raw text)
- **Manage cookies** for requests
- **Save requests as templates** (JSON files) for reuse
- **Load and execute** saved templates
- **Interactive mode** for building requests step-by-step
- **Command-line mode** for scripting and automation
- **Request history** tracks your recent HTTP calls

## When To Use

- You need to test REST API endpoints quickly from the terminal
- You want to save and reuse complex API requests
- You prefer a CLI tool over GUI applications like Postman
- You need to automate API testing in scripts
- You want to share API request configurations with team members
- You're debugging API issues and need to replay requests

## Usage

Basic commands:

```bash
# Send a GET request
python3 scripts/main.py get https://api.example.com/data

# Send a POST request with JSON body
python3 scripts/main.py post https://api.example.com/api \
  --header "Content-Type: application/json" \
  --body '{"name": "test", "value": 123}'

# Send with Basic authentication
python3 scripts/main.py get https://api.example.com/secure \
  --auth basic --username admin --password secret

# Send with Bearer token
python3 scripts/main.py get https://api.example.com/secure \
  --auth bearer --token "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"

# Save request as template
python3 scripts/main.py post https://api.example.com/api \
  --header "Content-Type: application/json" \
  --body '{"name": "test"}' \
  --save-template my-request

# Load and execute template
python3 scripts/main.py template my-re...

# HTTP Request Builder

A CLI tool to build, test, and save HTTP requests from the terminal. Send requests with custom headers, authentication, body, and cookies. Save requests as templates for reuse.

## Installation

Install via ClawHub:

```bash
clawhub install http-request-builder
```

## Usage

### Basic Commands

```bash
# Send a GET request
python3 scripts/main.py get https://api.example.com/data

# Send a POST request with JSON body
python3 scripts/main.py post https://api.example.com/api \
  --header "Content-Type: application/json" \
  --body '{"name": "test", "value": 123}'

# Send with Basic authentication
python3 scripts/main.py get https://api.example.com/secure \
  --auth basic --username admin --password secret

# Send with Bearer token
python3 scripts/main.py get https://api.example.com/secure \
  --auth bearer --token "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"

# Save request as template
python3 scripts/main.py post https://api.example.com/api \
  --header "Content-Type: application/json" \
  --body '{"name": "test"}' \
  --save-template my-request

# Load and execute template
python3 scripts/main.py template my-request

# View request history
python3 scripts/main.py history
```

### Interactive Mode

```bash
python3 scripts/main.py interactive
```

Interactive mode guides you through:
1. HTTP method selection
2. URL input
3. Headers configuration
4. Authentication setup
5. Request body input
6. Send request and view results

## Features

- Send HTTP requests with GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS methods
- Set custom headers with key-value pairs
- Add authentication (Basic Auth, Bearer tokens)
- Include request body (JSON, form data, raw text)
- Save requests as templates (JSON files) for reuse
- Load and execute saved templates
- Interactive mode for building requests step-by-step
- Request history tracks your recent HTTP calls

## Requirements

- Python 3.x
- `requests` library (installed automatically or via pip)

Install missing depende...