generalimport 0.2

Handle all your optional dependencies with a single call!

generalimport

Handle all your optional dependencies with a single call!

Contents

generalimport
├─ Examples
│  ├─ Minimal Example
│  ├─ Tests Showcase
│  ├─ Recommended Installation
│  └─ How It Works
├─ Installation
├─ Information
├─ Attributes
└─ Contributions

Examples

Minimal Example

Call generalimport before importing any optional dependencies.

Here is a minimal example:

from generalimport import generalimport
generalimport("notinstalled")

import notinstalled  # No error

def func():
    notinstalled.missing_func()  # Error occurs here

func()

...MissingOptionalDependency: Optional dependency 'notinstalled' was used but it isn't installed.

Imports fail when they are used, not imported.

This means you don't need to keep checking if the package is installed before importing it. Simply import your optional package and use it like you would any package and let it fail wherever it fails, with a nice error message.

Tests Showcase

The beauty of this package is that the error raised isn't just any exception. It has two base classes: unittest.case.SkipTest and _pytest.outcomes.Skipped (If available).

This means that if a test method uses an uninstalled optional package then that test is automatically skipped. This means no more manual skip decorators for optional dependencies!

from generalimport import generalimport
generalimport("optional_uninstalled_package")

from optional_uninstalled_package import missing_func

from unittest import TestCase

class MyTest(TestCase):
    def test_missing_func(self):
        self.assertEqual(3, missing_func(1, 2))

Ran 1 test in 0.002s

OK (skipped=1)

Skipped: Optional dependency 'optional_uninstalled_package' was used but it isn't installed.

Recommended Installation

I recommend to put this at the top of your main __init__.py file.

from generalimport import generalimport
generalimport("your", "optional", "dependencies")

This is all you need to write to use this package.

You can also write generalimport("*") to make any package importable.

How It Works

• When generalimport is instantiated it creates a new importer for sys.meta_path.
• This importer will return 'fake' modules for specified names.
• The fake module will recursively return itself when asked for an attribute.
• When used in any way (__call__, __add__, __str__ etc) it raises generalimport.MissingOptionalDependency.
• This exception has the 'skip-exceptions' from unittest and pytest as bases, which means that tests will automatically be skipped.

Installation

Command	setuptools
pip install generalimport	Yes

Information

Package	Ver	Latest Release	Python	Platform	Lvl	Todo	Cover
generalimport	0.2	2022-09-09 12:43 CEST	3.8, 3.9, 3.10	Windows, Ubuntu	0	0	99.3 %

Attributes

Module: generalimport
├─ Class: FakeModule
│  └─ Method: error_func
├─ Class: GeneralImporter
│  ├─ Method: add_names (Untested)
│  ├─ Method: disable
│  ├─ Method: enable
│  ├─ Method: find_module
│  ├─ Method: is_enabled
│  ├─ Method: load_module
│  └─ Method: remove_names (Untested)
├─ Class: MissingOptionalDependency
├─ Function: disable_importers
├─ Function: generalimport
├─ Function: get_enabled_importers
├─ Function: get_importer (Untested)
├─ Function: get_installed_packages
├─ Function: get_skip_base_classes (Untested)
├─ Function: import_module
├─ Function: module_is_namespace
└─ Function: package_is_installed

Contributions

Issue-creation and discussion is most welcome!

Pull requests are not wanted, please discuss with me before investing any time.

^{Generated 2022-09-09 12:43 CEST for commit 4d88848.}