importspy 0.2.1

ImportSpy ensures structural integrity, runtime compliance, and security for external modules, preventing inconsistencies and enforcing controlled execution.

ImportSpy - Intelligent Import Validation 🛡️

Ensure compliance, prevent unexpected failures, and enforce execution rules dynamically.

• 🔍 Monitor the runtime context before allowing imports.

• ⚡ Eliminate environment inconsistencies before they break production.

• 🛡️ Enforce strict execution policies for imported modules.

What is ImportSpy?

ImportSpy is a powerful runtime validation framework that ensures that external modules only import your code in a compliant execution environment.

Why is this important?

• ✅ Prevents unexpected failures caused by incorrect dependencies.

• ✅ Ensures security by blocking unauthorized imports.

• ✅ Eliminates debugging headaches by validating environments dynamically.

• ✅ Gives you full control over how and where your code is used.

Why Should You Use ImportSpy? 🚀

ImportSpy solves real-world problems for Python developers, software architects, and enterprises that need to enforce execution constraints on external modules.

🔴 Without ImportSpy

• ❌ Modules may break when imported into the wrong Python version.

• ❌ Unexpected OS configurations may introduce silent failures.

• ❌ Dependencies may change, leading to unpredictable execution issues.

• ❌ No protection against external modules misusing your code.

🟢 With ImportSpy

• ✅ Prevent misconfigured environments from executing your code.

• ✅ Block unauthorized imports and enforce runtime policies.

• ✅ Ensure every imported module meets strict execution requirements.

• ✅ Gain full visibility into how your code is being used.

How ImportSpy Works

ImportSpy intercepts module imports and ensures they match predefined execution constraints before allowing execution.

The process is simple:

1. Define execution constraints (e.g., OS, Python version, environment variables).

2. ImportSpy validates runtime conditions dynamically.

3. If the environment is compliant, execution proceeds.

4. If the environment is non-compliant, ImportSpy blocks execution.

Example: Preventing Imports in the Wrong Environment

Imagine you want your module to be imported only in Python 3.10+, on Linux, with a specific environment variable. With ImportSpy, you can enforce this automatically.

from importspy.models import SpyModel, Deployment, Runtime, System, Python
from importspy.constants import Config

class MyModuleSpy(SpyModel):
    deployments = [
        Deployment(
            runtimes=[
                Runtime(
                    arch=Config.ARCH_X86_64,
                    systems=[
                        System(
                            os=Config.OS_LINUX,
                            pythons=[
                                Python(
                                    version="3.10",
                                    interpreter=Config.INTERPRETER_CPYTHON,
                                    modules=[]
                                )
                            ],
                            envs={"CI": True}
                        )
                    ]
                )
            ]
        )
    ]

✅ If the importing module runs in a compliant environment, execution proceeds. ❌ If the execution environment does not meet these conditions, ImportSpy blocks execution.

Who Should Use ImportSpy?

• 🔹 Enterprise teams that need strict environment control.

• 🔹 Developers working with microservices, modular frameworks, or plugin-based architectures.

• 🔹 Security-conscious projects that want to restrict execution contexts.

• 🔹 Python package maintainers who need runtime validation for external users.

If your project relies on external modules, ImportSpy is your safeguard against execution chaos. 🔥

Installation & Quickstart

ImportSpy is available on PyPI:

pip install importspy

Check out the Quickstart Guide for step-by-step instructions.

• 📖 Documentation: ImportSpy Docs

• 🐍 GitHub: ImportSpy Repository

Support & Contribute

ImportSpy is open-source and thrives with your support!

Ways to Help 🚀

• ⭐ Star the project on GitHub → Give it a star!

• 🛠️ Contribute → Open issues, PRs, or improve docs.

• 📣 Share ImportSpy with developers who need execution control.

• 💖 Sponsor ImportSpy to support development → Become a sponsor.

Every contribution helps make ImportSpy better, stronger, and more useful!

License

ImportSpy is released under the MIT License. 📜 Read the full license: LICENSE

🔥 Take control of your imports. Start using ImportSpy today! 🚀