As part of our ongoing improvements to SOLE Gen and SOLE Gen for Data Products, we’ve introduced an opt-in feature designed to give you more control over how procedure and function statements are stored. Previously, all statements were stored directly inside the YAML configuration, but now you have the flexibility to offload longer statements to external files based on your preferences. This keeps your YAML files clean and more manageable, especially for large projects.

Why This Feature is Valuable

The new --inline-statement-limit feature gives you more control and flexibility over how procedure and function statements are stored. By setting a limit, you can keep your YAML files clean and manageable, with longer statements automatically offloaded to external files while shorter ones remain inline. This is especially useful for projects with a mix of short and long procedures.

How to Opt - In

1. Enable External File Storage: Use the -o option to enable external file storage. This ensures that SOLE Gen and SOLE Gen for Data Products will automatically save each procedure and function in its own file, keeping your YAML configuration clean. Without this option, all statements will continue to be stored directly in the YAML, regardless of other settings.

2. Set an Inline Statement Limit: After enabling external storage with -o, use the --inline-statement-limit parameter to define the maximum number of lines a statement can have before it is moved to an external file. For example, if you set --inline-statement-limit 5, any procedure or function longer than 5 lines will be saved externally, while shorter statements will stay inline in the YAML.

3. (Optional) File Naming and Directory Management: If desired, external files can be named using the <procedure_name>.<procedure_type> format (e.g., procedure1.js). You can further organize these files into subdirectories by specifying a path with the --statements-relative-path (-sp) argument.

Keeping the Previous Behavior

To keep the previous behavior (storing all statements directly inside the YAML), users don't need to take any action. The --inline-statement-limit is an opt-in feature, meaning if you don’t use it, the current behavior will be maintained. If you do not set -o or --inline-statement-limit, all statements will continue to be stored inline in the YAML, as before.

This opt-in feature is designed to make your workflow more efficient while keeping the flexibility to tailor SOLE Gen and SOLE Gen for Data Products to your needs. We’re excited to hear how this enhancement improves your experience. Feel free to reach out with feedback or any questions!