A simple set of utilities to make working with various import patterns easy.
pip install import-wrappers
The original motivation for this library was the repetitive utilities I found myself authoring to hack around supporting optional dependencies in other projects. Optional dependencies are a common pattern where the core of a library does not depend on a dependency but some functionality may require it. Most users may never interact with the code that requires the optional dependency but without proper handling will still be required to install them and by extension inherit the overhead of managing dependency versions and conflicts.
Typical import pattern - this fails on import whether or not the dependency is used
from optional_dependency import SomeUnusedClass
def some_function_that_isnt_needed(*args, **kwargs):
return SomeUnusedClass().some_method(*args, **kwargs)Same functionality using import wrappers - only raise an error on USE, not import
from import_wrappers.optional_dependencies import OptionalDependencyWrapper
SomeUnusedClass = OptionalDependencyWrapper('optional_dependency', 'SomeUnusedClass')
def some_function_that_isnt_needed(*args, **kwargs):
return SomeUnusedClass().some_method(*args, **kwargs)