Ticket #72 (closed defect: fixed)

Opened 2 years ago

Last modified 2 years ago

Execution modes are poorly named

Reported by: scorfield Owned by: scorfield
Type: defect Priority: normal
Milestone: Beta 2 Component: Miscellaneous
Version: 5.0 Severity: normal
Keywords: Cc:

Description

Barney proposed changing them as follows:

development -> development-full-load

development-no-load -> development-circuit-load

development-parse-only -> development-no-load

The development mode would still be supported as a deprecated alias for development-full-load. In strictMode, Fusebox 5 would throw an exception if development mode was specified (and the exception would say it was deprecated in favor of development-full-load).

The documentation would then explain the modes as follows:

development-full-load is useful while you are modifying fusebox.xml a lot, early in the development cycle as it reloads the entire framework on every request - but it is not thread-safe;

development-circuit-load is likely the most common development mode: it is thread-safe but still reloads circuit.xml files whenever they change and always regenerates the parsed/ file - it does not reload the fusebox.xml file (use fusebox.load=true for that);

development-no-load is a useful mode when you are debugging a custom lexicon since it does not reload any of the XML files but still regenerates the parsed/ file.

To be honest, development-no-load is probably not very useful at all because development-circuit-load doesn't reload a circuit.xml file if it hasn't changed and therefore, if you aren't changing circuit files, development-circuit-load and development-no-load (-parse-only) would be exactly the same really...

Attachments

Change History

Changed 2 years ago by scorfield

  • owner changed from sean@corfield.org to scorfield
  • status changed from new to assigned

Here's what I plan to do (and have actually started to implement):

* continue to accept "development" mode but deprecate it (and throw an exception in strict mode)

* add "development-full-load" mode (equivalent to FB4 "development" mode)

* add "development-circuit-load" mode (equivalent to FB5 Beta 1 "development-no-load" mode)

* leave "production" mode untouched

* throw an exception for any other value of mode (to catch errors or legacy FB5 Beta 1 settings)

This will leave just three modes, one of which will have a legacy deprecated alias.

Changed 2 years ago by scorfield

  • status changed from assigned to closed
  • resolution set to fixed

(In [191]) Fixes #72 by removing development-parse-only, renaming development-no-load (to development-circuit-load), adding development-full-load and deprecating development mode.

Note: See TracTickets for help on using tickets.