API Client CLI Tool Example

Complete REST API client CLI demonstrating:

HTTP client sharing via context
Authentication in Before hook
Multiple HTTP methods (GET, POST, PUT, DELETE)
Headers and request configuration
Arguments handling

Usage

# Set environment variables
export API_URL=https://api.example.com
export API_TOKEN=your_token_here

# GET request
api get /users
api get /users/123

# POST request
api post /users '{"name": "John", "email": "john@example.com"}'
api post /posts '{"title": "Hello", "body": "World"}' --content-type application/json

# PUT request
api put /users/123 '{"name": "Jane"}'

# DELETE request
api delete /users/123

# Test authentication
api auth-test

# Custom timeout
api --timeout 60s get /slow-endpoint

# Additional headers
api get /users -H "Accept:application/json" -H "X-Custom:value"

Features Demonstrated

Context Management: Shared HTTPClient and auth across requests
Before Hook: Authenticates and sets up HTTP client
Arguments: Commands accept endpoint and data as arguments
Required Flags: --url and --token are required
Environment Variables: API_URL, API_TOKEN, API_TIMEOUT fallbacks
Duration Flags: --timeout uses time.Duration type
Multiple Values: --header can be specified multiple times
Helper Functions: maskToken() for secure token display

HTTP Client Pattern

type APIContext struct {
    BaseURL    string
    Token      string
    HTTPClient *http.Client
}

// Initialize in Before hook
client := &http.Client{Timeout: timeout}
ctx := &APIContext{...}
c.App.Metadata["ctx"] = ctx

// Use in commands
ctx := c.App.Metadata["ctx"].(*APIContext)
resp, err := ctx.HTTPClient.Get(url)