pyrit.executor.core

Core executor module.

Functions¶

get_lazy_dir¶

get_lazy_dir(module_globals: dict[str, Any], exports: Mapping[str, LazyExport]) → list[str]

Return package attributes and unresolved public exports.

Returns:

• list[str] — list[str]: Sorted package attribute names.

resolve_lazy_export¶

resolve_lazy_export(name: str, module_name: str, module_globals: dict[str, Any], exports: Mapping[str, LazyExport]) → Any

Resolve and cache one package export.

Returns:

• Any — The resolved public value.

Raises:

• AttributeError — If name is not a declared lazy export.

Strategy¶

Bases: ABC, Generic[StrategyContextT, StrategyResultT]

Abstract base class for strategies with enforced lifecycle management.

Ensures a consistent execution flow: validate -> setup -> execute -> teardown. The teardown phase is guaranteed to run even if exceptions occur.

Subclasses must implement: _validate_context(): Validate context _setup_async(): Initialize resources _perform_async(): Execute the logic _teardown_async(): Clean up resources

Constructor Parameters:

Methods:

execute_async¶

execute_async(kwargs: Any = {}) → StrategyResultT

Execute the strategy asynchronously with the given keyword arguments.

Returns:

• StrategyResultT — The result of the strategy execution.

execute_with_context_async¶

execute_with_context_async(context: StrategyContextT) → StrategyResultT

Execute strategy with complete lifecycle management.

Enforces: validate -> setup -> execute -> teardown.

Returns:

• StrategyResultT — The result of the strategy execution, including outcome and reason.

Raises:

• ValueError — If the context validation fails.

• RuntimeError — If the strategy execution fails.

StrategyContext¶

Bases: ABC

Base class for all strategy contexts.

Methods:

duplicate¶

duplicate() → StrategyContextT

Create a deep copy of the context.

Returns:

• StrategyContextT — A deep copy of the context.

StrategyConverterConfig¶

Configuration for converters used in strategies.

This class defines the converter configurations that transform prompts during the strategy process, both for requests and responses.

Examples:

• Workflows

StrategyEvent¶

Bases: Enum

Enumeration of all strategy lifecycle events.

StrategyEventData¶

Bases: Generic[StrategyContextT, StrategyResultT]

Data passed to event observers.

StrategyEventHandler¶

Bases: ABC, Generic[StrategyContextT, StrategyResultT]

Abstract base class for strategy event handlers.

Methods:

on_event_async¶

on_event_async(event_data: StrategyEventData[StrategyContextT, StrategyResultT]) → None

Handle a strategy event.