Module lazily
Lazily import pygeodesy modules and attributes, based on
lazy_import from Brett Cannon's modutil.
Lazy import is supported only for Python 3.7+ and is enabled by default in PyGeodesy
18.11.10 and newer.
To enable lazy import, set env
variable PYGEODESY_LAZY_IMPORT to 1,
2, 3 or higher prior to import
pygeodesy. To disable lazy import, set
env variable PYGEODESY_LAZY_IMPORT to
0 or an empty string. Use 2 or higher to print
a message for each lazily imported module and attribute, similar to
env variable PYTHONVERBOSE showing imports.
Using 3 or higher also shows the importing file name and
line number.
Notes:
-
Lazy import applies only to top-level modules of
pygeodesy. The lazy import of a top-level
module invariably loads all sub-modules imported by that top-level
module.
-
Lazy import raises a LazyAttributeError or LazyImportError depending on the cause of the
error and such errors can occur late, after all initial imports.
Version:
24.10.15
|
|
LazyAttributeError
Raised if a lazily imported attribute is missing or
invalid.
|
|
|
LazyImportError
Raised if lazy import is not supported, disabled or
failed some other way.
|