Misc Tools Info - thepoopooman652/proishs-webtools GitHub Wiki

misc-tools — small utilities and demos

Overview

misc-tools is a collection of short, self-contained PHP utilities intended for local use, quick demonstrations, and ad-hoc tasks. Each script is focused on a single purpose and exposes a simple web interface for interactive use.

File catalog and behavior

  • index.php

    • Role: directory index for the toolset. Enumerates files in the folder and renders clickable links to each tool.
    • Behavior: uses glob to find matching files and excludes the index itself from the listing.

  • calc.php

    • Role: calculator UI with optional graphing mode.
    • Behavior: evaluates arithmetic expressions (server-side parser for numeric expressions) and provides a client-side graphing helper that converts y = ... expressions into Chart.js line plots.

  • image-search.php

    • Role: image search front-end that calls an external search API and shows thumbnails and pagination.
    • Behavior: accepts a query term, sends an HTTP request to the configured image search endpoint, and renders results as a tile grid with thumbnails and links to the full-size image.

  • ip-info.php

    • Role: IP geolocation lookup.
    • Behavior: calls a public IP geolocation API and displays structured output (country, region, city, latitude/longitude) and a raw JSON view.

  • lorem-ipsum.php

    • Role: placeholder text generator.
    • Behavior: generates words, sentences, or paragraphs with configurable counts and formats them for copy-paste.

  • password-gen.php

    • Role: password generator UI.
    • Behavior: generates random passwords server-side with configurable length and character set options; provides a copy-to-clipboard button in the UI.

  • wikipedia-search.php

    • Role: search UI for Wikipedia.
    • Behavior: queries the MediaWiki API for the provided term and displays search results and short snippets.

Usage examples

  1. Start a local server for experimentation:
cd 'C:\Users\Administrator\Documents\GitHub\proish-webtools\misc-tools'
php -S 127.0.0.1:8000 -t .
  1. Open http://127.0.0.1:8000/index.php in a browser and select a tool to run.

Developer notes

  • Each script is designed to be small and self-contained. For production use, factor common logic into shared helpers under lib/ and standardize configuration.
  • Scripts that call external APIs include simple HTTP request logic; adapt the request layer to use a shared HTTP helper for consistent behavior and retry policies.

Changelog

  • 2025-11-06: Consolidated file-by-file descriptions and usage examples for local testing.

This document focuses on the function and usage of each script in misc-tools and provides quick local-run instructions for testing and exploration.