orionis.introspection.ReflectionModule

THE ORIONIS API

Build with clarity.

Explore the building blocks of an async-first Python framework. Every module, class, and method — connected, searchable, and ready to build with.

Explore modules View classes

class documentation

class ReflectionModule(IReflectionModule): (source)

Constructor: ReflectionModule(module)

View In Hierarchy

Undocumented

Method	`__contains__`	Check if the cache contains the specified key.
Method	`__delitem__`	Remove an item from the memory cache by key.
Method	`__getitem__`	Retrieve a cached value by key.
Method	`__init__`	Initialize the ReflectionModule by importing the specified module.
Method	`__setitem__`	Store a value in the cache with the specified key.
Method	`clearCache`	Clear all cached reflection data.
Method	`getClass`	Retrieve a class object by its name from the module.
Method	`getClasses`	Return a dictionary of classes defined in the module.
Method	`getConstant`	Retrieve a constant value by name from the module.
Method	`getConstants`	Retrieve constants defined in the module.
Method	`getFile`	Return the file path of the module.
Method	`getFunctions`	Return a dictionary of functions defined in the module.
Method	`getImports`	Retrieve imported modules from the module.
Method	`getModule`	Return the imported module object.
Method	`getPrivateAsyncFunctions`	Return private asynchronous functions defined in the module.
Method	`getPrivateClasses`	Return a dictionary of private classes defined in the module.
Method	`getPrivateConstants`	Retrieve private constants defined in the module.
Method	`getPrivateFunctions`	Return private functions defined in the module.
Method	`getPrivateSyncFunctions`	Return private synchronous functions defined in the module.
Method	`getProtectedAsyncFunctions`	Return protected asynchronous functions defined in the module.
Method	`getProtectedClasses`	Return a dictionary of protected classes defined in the module.
Method	`getProtectedConstants`	Return protected constants defined in the module.
Method	`getProtectedFunctions`	Return a dictionary of protected functions defined in the module.
Method	`getProtectedSyncFunctions`	Return protected synchronous functions defined in the module.
Method	`getPublicAsyncFunctions`	Return a dictionary of public asynchronous functions in the module.
Method	`getPublicClasses`	Return a dictionary of public classes defined in the module.
Method	`getPublicConstants`	Retrieve public constants defined in the module.
Method	`getPublicFunctions`	Return a dictionary of public functions defined in the module.
Method	`getPublicSyncFunctions`	Return a dictionary of public synchronous functions in the module.
Method	`getSourceCode`	Retrieve the source code of the module.
Method	`hasClass`	Check if a class with the specified name exists in the module.
Method	`removeClass`	Remove a class from the module.
Method	`setClass`	Set a class in the module.
Instance Variable	`__memory_cache`	Undocumented
Instance Variable	`__module`	Undocumented

def __contains__(self, key: str) -> bool: (source) ¶

Check if the cache contains the specified key.

Parameters
key:`str`	The key to check for existence in the cache.

Returns
`bool`	True if the key exists in the cache, False otherwise.

def __delitem__(self, key: str): (source) ¶

Remove an item from the memory cache by key.

Parameters
key:`str`	The key to remove from the cache.

Returns
`None`	This method does not return a value.

def __getitem__(self, key: str) -> object | None: (source) ¶

Retrieve a cached value by key.

Parameters
key:`str`	The key to look up in the cache.

Returns
`object or None`	The cached value if found, otherwise None.

def __init__(self, module: str): (source) ¶

Initialize the ReflectionModule by importing the specified module.

Parameters
module:`str`	Name of the module to import and reflect upon.

Returns
`None`	This method does not return a value.

Raises
`TypeError`	If `module` is not a non-empty string or cannot be imported.

def __setitem__(self, key: str, value: object): (source) ¶

Store a value in the cache with the specified key.

Parameters
key:`str`	The key under which to store the value.
value:`object`	The value to store in the cache.

Returns
`None`	This method does not return a value.

def clearCache(self): (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.clearCache

Clear all cached reflection data.

Removes all cached entries stored in the reflection instance. Forces fresh computation on subsequent method calls.

Parameters
None

Returns
`None`	This method does not return a value.

def getClass(self, class_name: str) -> type | None: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getClass

Retrieve a class object by its name from the module.

Parameters
class_name:`str`	Name of the class to retrieve.

Returns
`type or None`	The class object if found, otherwise None.

def getClasses(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getClasses

Return a dictionary of classes defined in the module.

Parameters
None

Returns
`dict`	Dictionary with class names as keys and class objects as values.

def getConstant(self, constant_name: str) -> object | None: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getConstant

Retrieve a constant value by name from the module.

Parameters
constant_name:`str`	Name of the constant to retrieve.

Returns
`object or None`	Value of the constant if found, otherwise None.

def getConstants(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getConstants

Retrieve constants defined in the module.

Parameters
None

Returns
`dict`	Dictionary with constant names as keys and their values as values.

def getFile(self) -> str: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getFile

Return the file path of the module.

Returns
`str`	The absolute file path of the module.

def getFunctions(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getFunctions

Return a dictionary of functions defined in the module.

Parameters
None

Returns
`dict`	Dictionary with function names as keys and function objects as values.

def getImports(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getImports

Retrieve imported modules from the module.

Returns
`dict`	Dictionary mapping import names to module objects.

def getModule(self) -> object: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getModule

Return the imported module object.

Returns
`object`	The imported module object.

def getPrivateAsyncFunctions(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getPrivateAsyncFunctions

Return private asynchronous functions defined in the module.

Returns
`dict`	Dictionary with function names as keys and function objects as values.

def getPrivateClasses(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getPrivateClasses

Return a dictionary of private classes defined in the module.

Parameters
None

Returns
`dict`	Dictionary with class names as keys and class objects as values.

def getPrivateConstants(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getPrivateConstants

Retrieve private constants defined in the module.

Parameters
None

Returns
`dict`	Dictionary with constant names as keys and their values as values.

def getPrivateFunctions(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getPrivateFunctions

Return private functions defined in the module.

Parameters
None

Returns
`dict`	Dictionary mapping function names to function objects.

def getPrivateSyncFunctions(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getPrivateSyncFunctions

Return private synchronous functions defined in the module.

Parameters
None

Returns
`dict`	Dictionary with function names as keys and function objects as values.

def getProtectedAsyncFunctions(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getProtectedAsyncFunctions

Return protected asynchronous functions defined in the module.

Parameters
None

Returns
`dict`	Dictionary mapping function names to function objects.

def getProtectedClasses(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getProtectedClasses

Return a dictionary of protected classes defined in the module.

Parameters
None

Returns
`dict`	Dictionary with class names as keys and class objects as values.

def getProtectedConstants(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getProtectedConstants

Return protected constants defined in the module.

Parameters
None

Returns
`dict`	Dictionary with constant names as keys and their values as values.

def getProtectedFunctions(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getProtectedFunctions

Return a dictionary of protected functions defined in the module.

Parameters
None

Returns
`dict`	Dictionary mapping protected function names to function objects.

def getProtectedSyncFunctions(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getProtectedSyncFunctions

Return protected synchronous functions defined in the module.

Parameters
None

Returns
`dict`	Dictionary mapping function names to function objects.

def getPublicAsyncFunctions(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getPublicAsyncFunctions

Return a dictionary of public asynchronous functions in the module.

Parameters
None

Returns
`dict`	Dictionary mapping function names to function objects.

def getPublicClasses(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getPublicClasses

Return a dictionary of public classes defined in the module.

Parameters
None

Returns
`dict`	Dictionary with class names as keys and class objects as values.

def getPublicConstants(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getPublicConstants

Retrieve public constants defined in the module.

Parameters
None

Returns
`dict`	Dictionary with constant names as keys and their values as values.

def getPublicFunctions(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getPublicFunctions

Return a dictionary of public functions defined in the module.

Parameters
None

Returns
`dict`	Dictionary mapping function names to function objects.

def getPublicSyncFunctions(self) -> dict: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getPublicSyncFunctions

Return a dictionary of public synchronous functions in the module.

Parameters
None

Returns
`dict`	Dictionary mapping function names to function objects.

def getSourceCode(self) -> str: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.getSourceCode

Retrieve the source code of the module.

Returns
`str`	The source code of the module as a string.

Raises
`ValueError`	If the source code cannot be read from the module file.

def hasClass(self, class_name: str) -> bool: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.hasClass

Check if a class with the specified name exists in the module.

Parameters
class_name:`str`	Name of the class to check.

Returns
`bool`	True if the class exists in the module, otherwise False.

def removeClass(self, class_name: str) -> bool: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.removeClass

Remove a class from the module.

Parameters
class_name:`str`	Name of the class to remove.

Returns
`bool`	True if the class was removed successfully.

Raises
`ValueError`	If `class_name` is not a valid identifier or if the class does not exist.

def setClass(self, class_name: str, cls: type) -> bool: (source) ¶

overrides orionis.introspection.modules.contracts.reflection.IReflectionModule.setClass

Set a class in the module.

Parameters
class_name:`str`	Name of the class to set.
cls:`type`	Class object to set.

Returns
`bool`	True if the class was set successfully.

Raises
`ValueError`	If `cls` is not a class type, if `class_name` is not a valid identifier, or if `class_name` is a reserved keyword.

__memory_cache: dict = (source) ¶

Undocumented

__module = (source) ¶

Undocumented