Skip to main content

Dynamic import from files and other sources

Project description

Documentation Status Open Issues PyPI Package Test Health Code Coverage

When you just need that code, include does the ugly bits for you. It allows you to run code from files, strings or other sources as if they were regular modules. Code is executed as compliant as possible with the Python ecosystem. The resulting modules and objects can be pickled, copied and sent to other processes. This makes include suitable for testing, configuration, code creation and more.


include provides a simple API that works similar to the __import__ builtin. To import a module from its file path, pass it to the include.path function:

import include
conf_module = include.path('/etc/myapp/')

Once a module has been imported by include, it does not require special handling. You can work with the resulting module and its content without using include explicitly.

note:The include package must be importable by any python process working with a module imported by include.


The most recent stable version of include is available from pypi. You can install it using pip:

pip install include

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for include, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size include-0.2.1-py2.py3-none-any.whl (14.0 kB) File type Wheel Python version 2.7 Upload date Hashes View hashes
Filename, size include-0.2.1.tar.gz (8.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page