Cleaner Options declarations! | Webel IT Australia

Please note that at this stage we are only examining use of the Webel '$opt$' help holders conventions in lower-level packages, which rely on "manual" naming conventions; in later slides we'll see how Webel extensions of MTools for OO such as the MOpt class can be used to encapsulate the help holders for the Webel options convention.

Up next

Webel '$arg$' and '$opt$' support via the Doc` package

Notes

[NAMING, OPTION, PATTERN, TIP]{OPTION} Mathematica: Webel: You CAN/MAY use $ in variable names and function names - just not as the first character before a Capital - and it's extremely useful. You won't get sent to Azkaban prison if do you use a $ character!

[NAMING, PATTERN, POLICY]{STRICT} Webel: Mathematica: CONVENTION: Option help holders use a String variable with the prefix '$opt$', a related '$info$opt$' String, a 'def$opt$' default value expression, and optional '$warn$opt$', '$tip$opt$', '$lab$opt$', and 'type$opt$' indicator ...

[POLICY]{STRONG} About the Single Source of Truth (SSOT) and Don't Repeat Yourself (DRY) principles

Snippets (quotes/extracts)

Visit also

The Webel SysML4Mathematica recipe for modelling Wolfram Language code in Systems Modeling Language (SysML) for Model-Based Systems Engineering

Visit also (backlinks)

Related slides (includes other tutorials)

The Webel '$opt$', 'rule$opt$', '$arg$', 'rule$arg$' and supporting '$k$' conventions for "help holders"