Skip to content

Releases: McNarland-Software-Solutions-Inc/Code-Aggregator-for-Windows

v1.0.1

12 Jun 17:45
Compare
Choose a tag to compare
Fixed unauthorized access issue by changing selections.json path to A…

Code Aggregator

12 Jun 17:26
Compare
Choose a tag to compare

Version 1.0.0 - Initial Release

Overview

This is the initial release of the Code Aggregator application, designed to help users aggregate text files from selected folders into a single text file. This is particularly useful for consolidating code files or other text-based files from a project directory.

Features

  • Folder Selection:

    • Users can select a root folder to aggregate files from.
    • A tree view is provided to include or exclude specific files and folders.
    • All selected folders and files are remembered for future use.
  • File Aggregation:

    • Aggregates all text files from the selected folders and subfolders into a single text file.
    • Ensures that only text files are included in the aggregation.
  • Settings Management:

    • Saves the selected folders and file inclusion settings in a JSON file.
    • Detects new folders and indicates them to the user for inclusion.
  • User Interface:

    • Instructions are provided on the main form to guide the user.
    • Buttons for selecting folders and starting the aggregation process.
    • Progress form to show the progress of the aggregation process.
    • Option to open the generated file after the aggregation is complete.
  • Command Line Support:

    • Supports command line arguments to run the aggregator without the graphical user interface.
    • Options to specify output file, add folders, and run in quiet mode.

Command Line Options

  • ? - Show command line syntax and tips.
  • source_folder - Run the aggregator on this source folder.
  • -o:"New_Output_Folders\New_Output_Filename.ext" - Change the output file for this run only.
  • -oc:"New_Output_Folders\New_Output_Filename.ext" - Change the output file and update the JSON settings.
  • -a:"Folder\Folder_or_File_to_Add[.ext]" - Add this folder or file for this run only.
  • -ac:"Folder\Folder_or_File_to_Add[.ext]" - Add this folder or file and update the JSON settings.
  • -q - Quiet mode (no output from the program, don't show windows).

Error Codes

  • 0 - Worked perfectly.
  • 1 - Folder not found (when trying to add a new folder).
  • 2 - File not found (when trying to add a new file).
  • 3 - Error outputting to the output file.
  • 4 - Source folder not found.

Usage

  1. Graphical User Interface:

    • Open the application.
    • Click the 'Select Folder' button to choose the root folder for aggregation.
    • Use the checkboxes in the tree view to include or exclude specific files and folders.
    • Click 'Start Operation' to begin the aggregation process.
    • After completion, choose whether to open the generated file.
  2. Command Line Interface:

    • Run the application from the command line with the appropriate arguments as described above.

Known Issues

  • Initial scanning of large directories may take some time.
  • Antivirus software may flag the executable. Consider signing the code with a recognized certificate.

Summary

This version marks the beginning of the Code Aggregator project. Future updates will include performance improvements, additional features, and enhanced user experience based on user feedback.