Dev-Toolbox

A modular and extensible CLI toolbox for developers, built with Rust. This application provides a collection of tools to streamline common development tasks, from analyzing GitHub repositories to inspecting Unicode characters.

Features

• Modular Design: Easily extend the toolbox by adding new tools that implement the Tool trait.
• Cross-Platform: Builds and runs on both Windows and Linux.
• Global Search: Press Ctrl+F at any time to open the tool search palette.
• Mouse and Touchpad Support: Navigate between tabs with a simple click or tap.

Available Tools

Detailed documentation for each tool can be found in the Wiki.

• Org Research: Get insights into a GitHub organization's public repositories, including language statistics and license information.
• Repo Explorer: Explore the contents of a public GitHub repository, view file details, and see a breakdown of the languages used.
• Unicode Inspector: Look up Unicode characters by their code point and view detailed information about them.
• Token Inspector: View information about your GitHub Personal Access Token, including its owner, scopes, and remaining rate limits.
• Encoder/Decoder: Encode or decode strings using Base64, Hex, or URL encoding.
• HTTP Inspector: Perform arbitrary HTTP requests and inspect the response headers and body.
• JWT Decoder: Decode JSON Web Tokens to inspect their header and payload.

Getting Started

Prerequisites

• Rust: Install Rust
• Git: Install Git

Installation and Usage

Option 1: Download Binary (Recommended for Users)

Download the latest pre-built binary for your OS from the Releases page.

Option 2: Build from Source

1. Clone the repository:

   git clone https://github.com/fam007e/dev-toolbox.git
   cd dev-toolbox
   

2. Build and run:

   cargo run --release
   

Configuration

1. Secrets (.env)

The application requires a GitHub Personal Access Token to fetch repository and organization data. Create a .env file containing:

GITHUB_TOKEN=your_github_token

You can place this file in:

• The current working directory where you run the app.
• The OS-specific config directory (see below).

Generate a token here.

2. Application Config (config.toml)

On the first run, the app generates a config.toml in your OS-specific config directory:

• Linux: ~/.config/dev-toolbox/
• Windows: %AppData%\Roaming\dev-toolbox\

You can modify this file to change database paths or API URLs.

Navigation

• Keyboard:
  • Tab: Switch between tool tabs.
  • Ctrl+F: Open global search palette.
  • Ctrl+Q: Quit the application.
  • Ctrl+C: Copy the current status message (bottom left) to the clipboard.
  • Arrow Keys, Enter, etc.: Used for interacting with the currently selected tool.
• Mouse / Touchpad:
  • Click / Tap: Select a tab to switch to that tool.

Project Maintenance

• CI/CD: Automated builds, tests, and linting are performed on every PR via GitHub Actions.
• Standards: We adhere to strict Rust coding standards (Clippy) and have a comprehensive Code of Conduct.
• Security: Our security protocols are detailed in SECURITY.md.
• Contributing: See CONTRIBUTING.md for how to add new tools.

Contact

For support or reporting issues, contact email.