Skip to content

A collection of lightweight debugging tools for developers, including HTTP monitoring, request dumping, and TCP echo server capabilities. Perfect for local development and troubleshooting.

License

Notifications You must be signed in to change notification settings

hperezrodal/debug-kit

Repository files navigation

DEBUG-KIT

Debug Kit is a collection of simple, standalone tools to help developers troubleshoot HTTP, network, and application issues easily.

Each tool is small, lightweight, and designed to run locally with minimal setup.

Labels

GitHub Release GitHub Issues GitHub Stars Platform License Bash Library

Project Structure

Tools

Tool Description
HTTP Monitor A simple HTTP proxy that prints requests and responses.
Request Dumper A simple HTTP server that dumps incoming requests to both console and log file.
TCP Echo Server A simple TCP server that echoes back any data it receives, with configurable logging and error handling.
Mock API Server A lightweight HTTP server that serves mock responses from a JSON file, perfect for development and testing.
Simple File Server A lightweight, secure file server with upload capabilities, directory listing, and comprehensive logging.

Prerequisites

Required Tools

  • Node.js (v14 or higher)

    • Required for running the HTTP Monitor and TCP Echo Server
    • Download from nodejs.org
  • npm (Node Package Manager)

    • Comes bundled with Node.js
    • Used for installing dependencies
  • netcat (optional)

    • Useful for testing the TCP Echo Server
    • Available on most Unix-like systems
    • On Ubuntu/Debian: sudo apt-get install netcat
    • On macOS: brew install netcat

Getting Started

Each tool lives in its own folder.

To run a tool:

  1. Navigate into the tool's folder.
  2. Install dependencies: npm install
  3. Follow the instructions in its README.md.

Example:

cd http-monitor
npm install
node index.js

Contributing

Contributions are always welcome! Please read the contribution guidelines first.

License

MIT License - See LICENSE file for details


Made with ❤️ by hperezrodal

About

A collection of lightweight debugging tools for developers, including HTTP monitoring, request dumping, and TCP echo server capabilities. Perfect for local development and troubleshooting.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published