Metadata-Version: 2.4
Name: pydynamix
Version: 0.1.0
Summary: Dynamic execution and code manipulation utilities for Python
Author: Kareem Hashash
License: Copyright © 2025 <copyright holders>
        
        Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
        associated documentation files (the “Software”), to deal in the Software without restriction, including
        without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
        LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
        EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
        AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Dynamic: license-file

# pydynamix

> **A powerful dynamic execution and code manipulation library.**

This module provides advanced tools for dynamic code execution, variable management,
and metaprogramming capabilities in Python. It enables secret variable storage,
dynamic execution with result capture, scope manipulation, lambda creation, and
class extension.

Key Features:
    - Secret variable storage and retrieval (`setvar`, `getvar`, `delvar`, `clearvars`)
    - Dynamic code execution with results (`resulted_execution`)
    - Scope context management (`scope_context`)
    - Anonymous function generation (`GreatLambda`)
    - Class extension and composition (`extend`)
    - Module export control (`export`)
    - Custom object construction decorator (`constructor`)

Classes:\n
**ReadOnly**: Contains nested type-only classes for typing purposes.
    - **ExecutionResults**: Represents results from dynamic code execution.
    - **Scoper**: Provides scope attribute access and management.
    - **ScopeContext**: Context manager for scope attribute revelation.
**GreatLambda**: Builder for creating advanced anonymous functions.
**constructor**: Decorator for constructing objects via function definitions.

Functions:
    `setvar`: Store a variable secretly.
    `getvar`: Retrieve a secretly stored variable with optional default.
    `delvar`: Delete a specific secret variable by name.
    `clearvars`: Clear all secret variables.
    `takevar`: Retrieve a secret variable or raise `KeyError` if not found.
    `resulted_execution`: Execute code dynamically and capture execution results.
    `extend`: Extend a class with attributes from another class.
    `scope_context`: Create a context manager for accessing object attributes.
    `export`: Define which variables a module should export.
