Skip to content

Lightweight Go HTTP request dumper that captures, echoes, and logs incoming requests—ideal for testing webhooks and debugging APIs

License

Notifications You must be signed in to change notification settings

crgimenes/dumpHTTP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dumpHTTP - HTTP Request Dumper

Go Version License: BSD-2-Clause

A simple and powerful HTTP request debugging tool that captures, displays, logs and echo all incoming HTTP requests. Perfect for testing webhooks, debugging API calls, or inspecting HTTP traffic during development.

Features

• 🔍 Complete Request Capture: Captures full HTTP requests including headers, body, and metadata • 📝 Dual Output: Displays requests in terminal with colored output and saves to file • 📊 Persistent Logging: Saves all requests to a file with timestamps and unique identifiers • ⚡ Lightweight: Minimal dependencies and fast performance

Installation

From Source

git clone https://github.com/crgimenes/dumpHTTP.git
cd dumpHTTP
go build -o dumpHTTP .

Using Go Install

go install crg.eti.br/go/dumpHTTP@latest

Requirements

• Go 1.24 or higher

Quick Start

  1. Start the HTTP dump server:

    ./dumpHTTP
  2. Send a test request:

    curl -X POST http://localhost:8080/test \
         -H "Content-Type: application/json" \
         -d '{"message": "Hello World"}'
  3. View the captured request in your terminal and check the dump.txt file

Usage

Command Line Options

./dumpHTTP [options]
Option Default Description
-listenAddr :8080 Address and port to listen on
-dumpFile dump.txt File to save request dumps

Examples

Listen on a specific port:

./dumpHTTP -listenAddr :9000

Save dumps to a custom file:

./dumpHTTP -dumpFile requests.log

Custom configuration:

./dumpHTTP -listenAddr 0.0.0.0:8080 -dumpFile /var/log/http-dumps.txt

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the BSD 2-Clause License - see the LICENSE file for details.

Author

Created by Cesar Gimenes

About

Lightweight Go HTTP request dumper that captures, echoes, and logs incoming requests—ideal for testing webhooks and debugging APIs

Topics

Resources

License

Stars

Watchers

Forks