User Guide

Epochly User Guide: Context Managers

Use Epochly context managers to optimize code blocks without modifying function signatures.

Context managers for scoped optimization control.

optimize_context()

Apply optimization within a scope.

Signature

with epochly.optimize_context(level=1, monitor_performance=True, **options):
    # optimized code

Parameters

Parameter	Type	Default	Description
`level`	int	1	Enhancement level (0-4)
`monitor_performance`	bool	True	Enable performance monitoring

Example

import epochly
with epochly.optimize_context(level=3):
    result = heavy_computation(data)

monitoring_context()

Collect performance metrics within a scope.

Signature

with epochly.monitoring_context() as metrics:
    # monitored code
print(metrics)

Returns (as context variable)

Key	Type	Description
`duration_ms`	float	Execution time
`cpu_time_ms`	float	CPU time
`memory_mb`	float	Memory used
`wait_time_ms`	float	I/O wait time

Example

import epochly
with epochly.monitoring_context() as metrics:
    result = process_data(large_dataset)
print(f"Duration: {metrics.get('duration_ms')} ms")
print(f"Memory: {metrics.get('memory_mb')} MB")

jit_context()

Apply JIT compilation within a scope.

Signature

with epochly.jit_context():
    # JIT-compiled code

Parameters

This context manager takes no parameters.

Example

import epochly
with epochly.jit_context():
    result = numerical_computation(array)

threading_context()

Apply threading optimization within a scope.

Signature

with epochly.threading_context(max_workers=None):
    # threading-optimized code

Parameters

Parameter	Type	Default	Description
`max_workers`	int	None	Maximum workers

Example

import epochly
with epochly.threading_context(max_workers=16):
    results = [fetch(url) for url in urls]

full_optimize_context()

Apply maximum optimization within a scope.

Signature

with epochly.full_optimize_context():
    # fully optimized code

Parameters

This context manager takes no parameters.

Example

import epochly
with epochly.full_optimize_context():
    result = matrix_computation(large_matrix)

benchmark_context()

Benchmark code within a scope.

Signature

with epochly.benchmark_context(name='benchmark') as results:
    # benchmarked code

Parameters

Parameter	Type	Default	Description
`name`	str	'benchmark'	Benchmark name
`print_results`	bool	True	Print results on exit

Returns (as context variable)

Key	Type	Description
`mean_ms`	float	Mean execution time
`min_ms`	float	Minimum time
`max_ms`	float	Maximum time
`std_ms`	float	Standard deviation

Example

import epochly
with epochly.benchmark_context("matrix_mult") as results:
    output = matrix_multiply(a, b)
print(f"Mean: {results.get('mean_ms'):.2f} ms")

epochly_disabled_context()

Temporarily disable Epochly.

Signature

with epochly.epochly_disabled_context():
    # unoptimized code

Example

import epochly
# Normal optimized execution
result1 = optimized_function(data)
# Temporarily disable for comparison
with epochly.epochly_disabled_context():
    result2 = optimized_function(data)

Nested Context Managers

Context managers can be nested:

import epochly
with epochly.monitoring_context() as outer_metrics:
    with epochly.optimize_context(level=3):
        result = computation(data)
print(f"Total time: {outer_metrics.get('duration_ms')} ms")