install

Cauldron.api.install()[source] [edit on github]

Install the Cauldron modules in the global namespace, so that they will intercept root-level imports.

This method performs a runtime hack to try to make the Cauldron versions of ktl and DFW the ones which are accessed when a python module performs import ktl or import DFW. If either module has already been imported in python, then this function will send a RuntimeWarning to that effect.

Note

It is preferable to use Cauldron-style imports, of the form from Cauldron import ktl, as this will properly ensure that the Cauldron backend is invoked and not the KTL backend.