Builder's Heaven

File Cutter module

Help Version: 3.15 - 23/MAR/2021

• File Cutter Module: <NEWFILEOUT> command
• File Cutter Module: <COPYRESOURCE> command
• File Cutter Module: <UNPACKFILE> command

File Cutter Module: <NEWFILEOUT> command

After the Generate Program Process has terminated, you can click the button "File Cutter" to submit the generated file to file cutting process. The Auto FileCutter checkbox automatically run the module. During this process the file look for specific keywords followed by the path and the file name. Everything contained between this Keyword and the next, or the final end of file, goes under the Keyword file name.

The M.P.S.C. syntax of File Cutter is listed below:

To better undestand this line of M.P.S.C. it will be separated into blocks:

1. Area from byte 1 to Byte 6 is a part of Flags. Ensure that this line will be written when necessary in order to get your file name row. Otherwise different languages will merge with previous file cutting name, obtaining lot of errors.
2. //-<NEWFILEOUT> This is the keyword that identify a File Cutter Line
3. subDirectory1\subDirectory2\ This is optional, in case you want to organize your file in subdirectories.
4. <PRGNAM>.html This is the filename . After filecutting it will assume the name of the program, resulting: program1.html for example. This line open a new file in output and write every rows found from this code to the next file cutter keyword.
5. ----------// This is just a separator used to indentify in a complex M.P.S.C. the file you are writing. It's optional but suggested.

File Cutter rows are useful when your project need to create not just a single program, but a series of file that came all from the same Builder's Heaven decisions. For example if we decide to create an HTML that would need a CSS files and a Javascript files, I will have in M.P.S.C. the following lines:

The result of this file cutting will be an html, a css inside the CSS subdirectory, and a javascript inside the JS subdirectory.

File Cutter is easy to implement and much versatile. It can be used also to create empty subdirectories. Here some examples.

M.P.S.C. Common syntax: create a file inside 2 subdirectories

Common syntax: create a file inside 2 subdirectories defined in Key To Value

Only Subdirectory syntax: note that the slash "\" at the end is required.

Filename with spaces: note that containing apex are required

File Cutter Module: <COPYRESOURCE> command

A second command for File Cutter Module allow you to copy files from the Resource Directory of a Language, to the final directory of your generated program. The purpose of this command is to connect the copy of resource files (i.e. scripts, jpegs, useful data file, project files, etc) with the Flags used inside the code.

TIP: the "Resources" directory can be found inside the Language directory that is in your main Archive directory.

The syntax of File Cutter Copy Resource command is listed below:

Note that syntax and rules are equal to <NEWFILEOUT> tag previously described.

For example if you need to play a copuple of Mp3 from a Builder's Heaven Jquery class, you can archive inside resource directory some example Mp3 and define their copy only when the setup enables sound Flags. Or you can always copy resource files binding them to the language Main Flag.

M.P.S.C. More Examples:

TIP: to keep the copy of resources clear and ordered it's suggested to put them before a <NEWFILEOUT> command. In any case they do not interrupt the filecutter process but just invokes a copy process. The line that contains <COPYRESOURCE> command will then be removed from the code.

M.P.S.C. Tip Example:

File Cutter Module: <UNPACKFILE> command

This command allows to Unpack a compressed file from the RESOURCE directory to the Publish directory. The input file, accordingly to the Unpack Plugin, can be a Zip, 7z, rar, etc. The purpose of unpacking process is to deploy all the files required for an application to run, likes plugin, utilities, or project files, or everything is required from the generated program.

TIP: the "Resources" directory can be found inside the Language directory that is in your main Archive directory.

The syntax of UNPACKFILE command is listed below:

The first command unpack a zip file into the ROOT of your publish directory, during FILECUTTER process. The second command unpack a zip file into the DestinationSubDirectory , created inside your publish directory. All the content of the Compressed file (zip, 7z, rar, etc) are deployed inside the target directory.

For example if you need to play a copuple of Mp3 from a Builder's Heaven Jquery class, you can archive them in a zip file inside RESOURCE directory: "mp3.zip". Then inside the M.P.S.C. insert a command to unpack the zip file into the publish directory.

Example:

Note: The unpack plugin is configured inside the ADDITIONAL OPTIONS, inside Advanced Options, inside USER DATA and FTP Settings.

Advertising