MM File Utility Files

Brief instruction on MM File Utility: (v0.8)
--------------------------------------------------------------------------
NOTE: It is recommended to back up files before performing operations as operations are not reversible. 

Method 1:
Windows: Start program with start.bat 
(executes in bin directory: java -cp ./ mm.util.MultiFileOperation)

Method 2:
Windows: Single operation, single file processing at command line
example: single_exec.bat in bin directory:
java -cp ./ mm.util.MultiFileOperation _exeone test_attrib.txt test_output.txt replaceText match=abc replace=replaced

--------------------------------------------------------------------------
Program Overview:
(1) Drag and drop input files (or directies) into a java program. Optionally filter files matching some pattern. 

(2) Perform file, string, or text file manipulations on all the selected files. Includes generic field entry to input parameters to each manipulation. 

(3) Output each file according to: overwrite the input file, or write into a new generated file for each file (using several methods). Also can output a single file across all the files. 

(4) Options: recurse/do not recurse subdirectories, output text files with different endline formats (\r\n, \r, \n), output text files with different field delineators (tab, comma). Do not process the first row for certain operations.

(5) Stores recent history of lists of files processed,file output options, and operations exectued. Save/Load the lists/operations to text file. 

--------------------------------------------------------------------------

directories:

bin: class 
src: java source code (developed using Eclispe)
doc: javadoc generated files
testcase: misc text files from testing

--------------------------------------------------------------------------
Usage:

1. FileDrop tab: Add files/directories into the "FileDrop" tab using drag and drop. Select a filter to restrict which files are processed (useful when a directory is dropped into the FileDrop). 

2. Output tab: Select file output. The cumulative single file entry is for operations that output to a single file. The per file name generation is for operations that generate an output file for each file. By default the same output file is used (overwrite can be enabled on Options tab to silence the overwrite messages). Can optinally drag and drop a file for entry into cumulative file.

3. Operation tab: Operations have some primitive grouping (all, file, string, table, utility). The first drop down menu selects a group of operations. The second drop down menu lists operations and parameters. A brief description of the operation is displayed after selection. (After execution, the list of recently executed operations can be saved/loaded to a file.) Parameters for an operation are entered in the table next to corresponding field names. Click "Do Operation" to execute the operation with the entered parameters. Can optinally drag and drop a file for entry into fields.

4. Paste Area tab: Useful for testing operations and running operations without files. Input text into the source text area. Click "Do Operation on Copy Source" to run the current operation on the text in the text area. Output is in the result text area.

5. Options for output. By default, there is a confirmation dialogue when an output file will overwrite an existing file. The confirmation allows various methods of skipping files. Select "Overwrite without confirmation" to silently overwrite existing files. Select "skip all overwrites" to silently disable file overwriting. Select "Expand directories" to also perform operations on sub-directories. When writing an output file, many operations write out line feeds or record delineators. The selected endline/delineators will be used in such a case.

readme-updated 2/4/2010