Universal Text Pre-Processor (utpp)

utpp is a portable, TypeScript-based tool designed to dynamically modify files across any platform (Windows, Linux, MacOS, Docker). It provides the following core capabilities:

• Universal File Support: Works with any file format.
• Branching Logic: Supports if/else logic to include, exclude, or modify specific parts of a file.
• Variable Replacement: Allows the use of placeholders in files that are replaced by variables.
• Custom Scripting: Enables the execution of custom JavaScript code within the process.

Common use cases include dynamically modifying static config files based on user input, replacing placeholders with evaluated JavaScript on startup, conditionally starting supervisor services via docker run arguments, and adjusting compile commands based on system architecture.

utpp is a portable, universal file processing tool (written in TypeScript) that works across Windows, Linux, MacOS, and Docker containers. It allows developers to dynamically modify any file format using the following capabilities:

• Branching: Implement if/else logic to include, exclude, or modify specific parts of a file.
• Variables: Use placeholders within files and replace them with defined variables.
• Scripting: Execute custom JavaScript code during the processing phase.
• Universal Compatibility: Operates on any file format regardless of the extension.

utpp is a portable, TypeScript-based tool designed to dynamically modify files across any platform (Windows, Linux, MacOS, Docker). It provides the following core capabilities:

• Universal File Support: Works with any file format.
• Branching Logic: Supports if/else logic to include, exclude, or modify specific parts of a file.
• Variable Replacement: Allows the use of placeholders within files that are replaced by variables.
• Custom Scripting: Enables the execution of custom JavaScript code during the process.

For every file processed, utpp follows a four-step pipeline:

1. Read file: The file is read from the filesystem into memory.
2. Apply template: Template commands and logic (such as conditional blocks) are evaluated and applied.
3. Apply variables: Key-value pairs provided via CLI arguments are used to replace variables within the template.
4. Write file: The final processed content is written back to the filesystem or sent to standard output based on the CLI arguments used.

Variables are stored globally and can be used inside a template block's Value argument by referencing the variable name. Because they are global, changes to a variable only affect statements declared after the point of modification.

Variables can be declared during CLI execution using key=value pairs or by providing a key alone. Multiple variables are passed as space-separated arguments.