restricted 0.1.0

A lightweight Python package for analyzing and securely executing code blocks with AST-based restrictions.

Python Restrictor & Executor

Overview

A sandboxed Python code execution environment with support for ast-based validation, restricted imports and builtins, and multiple execution methods including subprocesses and uv.

---

Installation

pip

pip install restricted

uv

uv add restricted

Usage

from restricted.helpers import execute_restricted

# A block of code pretending to be malicious.
code="""
import os
print(os.getcwd())
"""

print(execute_restricted(code))

# Shell Output
ImportError: 'os' is not allowed

Security Notice

This project is in early development and should not be considered production-ready for high-risk environments.

Contribution

If you want to contribute to this small project, feel free to submit a pull request here.