#api-testing #asterisk #rapidly #command-line-tool #testing-tools #request #header

app asterisk-cli

A lightweight command-line tool for rapidly testing API endpoints

5 releases (3 stable)

2.0.1 Jan 24, 2025
1.0.0 Dec 4, 2024
0.1.1 Dec 4, 2024
0.1.0 Dec 4, 2024

#509 in Web programming

Download history 349/week @ 2024-12-04 8/week @ 2024-12-11 211/week @ 2025-01-22 27/week @ 2025-01-29 11/week @ 2025-02-05

249 downloads per month

MIT license

18KB
284 lines

Asterisk: Universal API Testing CLI

A lightweight command-line tool for rapidly testing API endpoints with a clean and simple interface.

Installation

cargo install asterisk-cli

Usage

asterisk <endpoint> <method> [options]

Arguments

  • endpoint: Endpoint name or path (e.g., "users" or "api/users")
  • method: HTTP method (GET, POST, PUT, DELETE, PATCH)

Options

  • -b, --body <json>: Request body as JSON string
  • -H, --headers <headers>: Custom headers (format: "key1:value1,key2:value2")
  • -t, --token <token>: Bearer token for authentication
  • -u, --url <url>: Base URL (default: http://localhost:3000)
  • -v, --verbose: Enable detailed output

Examples

# Basic GET request
asterisk users get

# POST with JSON body
asterisk users post -b '{"name":"John","email":"john@example.com"}'

# Authenticated request
asterisk protected get -t "your-token-here"

# Custom headers and base URL
asterisk users get -H "Accept:application/json,API-Key:123" -u "http://api.example.com"

Features

  • 🚀 Simple and intuitive interface
  • 📝 Support for JSON payloads
  • 🔒 Authentication handling
  • ⚡ Request timing information
  • 🎨 Beautiful terminal output

Why Asterisk?

Asterisk is designed to be a straightforward, no-nonsense API testing tool. It focuses on doing one thing well: making HTTP requests with minimal friction. Whether you're testing a local development server or a production API, Asterisk provides a clean and efficient interface for your API testing needs.

Dependencies

~7–23MB
~277K SLoC