Skip to content

README.md

Latest commit

 

History

History
48 lines (32 loc) · 2.5 KB

README.md

File metadata and controls

48 lines (32 loc) · 2.5 KB

Python Script Comparator Utility (SCU)

SCU is a standalone utility designed to compare differences between multiple files in a folder, such as Python files or files of other specified extensions. This tool is ideal for tracking changes in sequential versions of files, highlighting additions and removals for easy comparison.

Features

  • Sequential File Comparison: Compares each file in a folder to the previous one, tracking only adjacent changes.
  • Visual Difference Display: Highlights additions in green and removals in red for quick and clear differentiation.
  • Filter Options: Allows users to selectively view only additions, only removals, or both.
  • Log Output and Export: Displays a detailed comparison log with an option to save it as a .txt file.
  • Graphical Interface: User-friendly GUI with easy navigation for selecting folders, filtering results, and saving logs.

Installation

No installation is required! Simply download the zip (if on windows) or tar.gz (if on macOS/Linux) for your version, unpack, and double-click the executable to run the utility. No Python environment is needed to use this tool.

LINUX USERS

You may need to give permissions to make this tool executable: chmod +x /path/to/scu_v0.1.0

Usage

  1. Open the Application: Double-click scu.exe (or whichever executable you choose) to launch the GUI.
  2. Select Folder: Use the folder selection option to choose a directory containing the files you want to compare.
  3. Choose File Extension: Use the dropdown menu to specify the file extension to compare (e.g., .py, .txt, .md).
  4. Set Filtering Options: Select your preference to show additions, removals, or both.
  5. View Differences: SCU will display differences in a new window, color-coded for easy reference.
  6. Save Log: Optionally, click "Save Log" to export the comparison results as a .txt file.

Example Workflow

  1. Launch SCU by double-clicking the executable.
  2. Choose the Folder: Select the folder containing files to compare.
  3. Select Options:
    • File Extension: Choose the file type you want to compare.
    • Filtering: Set whether to show additions, removals, or both.
  4. Save the Comparison Log if needed, for easy reference later.

Troubleshooting

  • No Differences Found: If no differences are detected, make sure the files have sequential changes, as SCU only compares each file to the immediately previous one.

License

This project is licensed under the MIT License.