async-lambda-unstable

0.6.12 verified Fri May 01 auth: no python

A Python framework for creating AWS Lambda Async Workflows. Version 0.6.12 targets the unstable development branch, offering experimental features for building asynchronous Lambda functions with step function orchestration. Release cadence is irregular; breaking changes are frequent.

pip install async-lambda-unstable

Common errors

error ModuleNotFoundError: No module named 'async_lambda_unstable' ↓

cause Package not installed or import name misspelled.

fix

Run pip install async-lambda-unstable and ensure import uses underscores: import async_lambda_unstable.

error ImportError: cannot import name 'AsyncLambdaHandler' from 'async_lambda_unstable' ↓

cause Incorrect import path; symbol may have been renamed or moved.

fix

Use from async_lambda_unstable import AsyncLambdaHandler or check the package's __init__.py for exports.

error TypeError: run() got an unexpected keyword argument 'async_mode' ↓

cause Using outdated API after upgrade.

fix

Remove async_mode argument; call handler.run(event) instead.

Warnings

breaking API surface is unstable; major internal refactors occur between minor versions without deprecation. ↓

fix Pin exact version in requirements.txt and review changelog before upgrading.

deprecated The `run()` method signature changed in 0.5.0: removed `async_mode` parameter. ↓

fix Update calls from `handler.run(event, async_mode=True)` to `handler.run(event)`.

gotcha Workflow state machine definitions changed in 0.6.0; old definitions cause silent failures. ↓

fix Rewrite workflows using the new `Step` and `Parallel` classes from `async_lambda_unstable.steps`.

Imports

AsyncLambdaHandler
wrong
```
from async_lambda import AsyncLambdaHandler
```
correct
```
from async_lambda_unstable import AsyncLambdaHandler
```
The module name includes '_unstable' suffix; omitting it leads to ModuleNotFoundError.
Workflow
wrong
```
from async_lambda.workflow import Workflow
```
correct
```
from async_lambda_unstable import Workflow
```
Workflow is a top-level export; using dotted path may fail or import wrong object.

StepFunction

wrong

from async_lambda_unstable.step_function import StepFunction

correct

from async_lambda_unstable import StepFunction

StepFunction is re-exported at package level; submodule import may not exist.

Quickstart

Minimal handler example. Actual workflow definition requires StepFunction and Workflow classes, omitted here for brevity.

from async_lambda_unstable import AsyncLambdaHandler

def handler(event, context):
    handler = AsyncLambdaHandler()
    return handler.run(event)