Readme
################################# include - Dynamic Module Importer #################################
|docs| |issues| |pypi| |travis| |codecov|
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.
Usage
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:
.. code:: python
import include
conf_module = include.path('/etc/myapp/conf.py')
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.
Installation ############
The most recent stable version of include is available from pypi <https://pypi.python.org>_.
You can install it using pip:
.. code:: bash
pip install include
.. |travis| image:: https://travis-ci.org/maxfischer2781/include.svg?branch=master :target: https://travis-ci.org/maxfischer2781/include :alt: Test Health
.. |pypi| image:: https://img.shields.io/pypi/v/include.svg :target: https://pypi.python.org/pypi/include :alt: PyPI Package
.. |codecov| image:: https://codecov.io/gh/maxfischer2781/include/branch/master/graph/badge.svg :target: https://codecov.io/gh/maxfischer2781/include :alt: Code Coverage
.. |docs| image:: https://readthedocs.org/projects/include/badge/?version=latest :target: http://include.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status
.. |issues| image:: https://img.shields.io/github/issues/maxfischer2781/include.svg :target: https://github.com/maxfischer2781/include/issues :alt: Open Issues
FAQs
Dynamic import from files and other sources
We found that include demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
The Python Software Foundation has secured a 5-year sponsorship from Fastly that supports PSF's activities and events, most notably the security and reliability of the Python Package Index (PyPI).
Security News
LDAPjs, an LDAP Client and Server API for Node.js, was decommissioned after its maintainer received an abusive email from a user, raising concerns about this form of abuse as a potential attack vector.
Security News
CISA launched a new project called Vulnrichment to enrich CVEs with details that help prioritize patching and mitigation efforts, as the NVD backlog of unenriched CVEs awaiting analysis surpasses 10,000.