{"id":6279,"library":"types-aiobotocore-stepfunctions","title":"Type annotations for aiobotocore Step Functions","description":"This package provides type annotations for the `aiobotocore` library's Step Functions (SFN) client. It is part of the `mypy-boto3-builder` project, which automatically generates type stubs for all `aiobotocore` services. The versioning of `types-aiobotocore-stepfunctions` aligns with the corresponding `aiobotocore` version, currently 3.4.0. The project maintains an active release cadence, driven by updates to `aiobotocore` and improvements in the `mypy-boto3-builder` itself, ensuring up-to-date type support.","status":"active","version":"3.4.0","language":"python","source_language":"en","source_url":"https://github.com/youtype/mypy_boto3_builder","tags":["aws","aiobotocore","stepfunctions","typing","stubs","async","mypy","pyright","type-annotations"],"install":[{"cmd":"pip install types-aiobotocore-stepfunctions","lang":"bash","label":"Install standalone"},{"cmd":"pip install 'aiobotocore[stepfunctions]' 'types-aiobotocore[stepfunctions]'","lang":"bash","label":"Install with aiobotocore extras"}],"dependencies":[{"reason":"Provides the underlying asynchronous AWS client for which these are type stubs. The package version aligns with the aiobotocore version it types.","package":"aiobotocore","optional":false},{"reason":"Required Python version.","package":"python","optional":false}],"imports":[{"wrong":"from types_aiobotocore_stepfunctions.client import SFNClient","symbol":"SFNClient","correct":"from types_aiobotocore_stepfunctions import SFNClient"}],"quickstart":{"code":"import asyncio\nimport os\nfrom typing import TYPE_CHECKING\n\nfrom aiobotocore.session import get_session\n\n# These imports are only for type checking and will not be present at runtime\nif TYPE_CHECKING:\n    from types_aiobotocore_stepfunctions.client import SFNClient\n    from types_aiobotocore_stepfunctions.type_defs import StartExecutionOutputTypeDef\n\n\nasync def start_step_function_execution(state_machine_arn: str, execution_name: str, input_data: str):\n    session = get_session()\n    async with session.create_client(\n        \"stepfunctions\",\n        region_name=os.environ.get('AWS_REGION', 'us-east-1'),\n        aws_access_key_id=os.environ.get('AWS_ACCESS_KEY_ID', 'DUMMY_KEY'),\n        aws_secret_access_key=os.environ.get('AWS_SECRET_ACCESS_KEY', 'DUMMY_SECRET'),\n    ) as client:\n        # client is implicitly typed as SFNClient by mypy/pyright after installing types-aiobotocore-stepfunctions\n        if TYPE_CHECKING:\n            client: SFNClient\n\n        print(f\"Starting execution '{execution_name}' for state machine '{state_machine_arn}'\")\n        response: StartExecutionOutputTypeDef = await client.start_execution(\n            stateMachineArn=state_machine_arn,\n            name=execution_name,\n            input=input_data,\n        )\n        print(f\"Execution ARN: {response['executionArn']}\")\n        print(f\"Start Date: {response['startDate']}\")\n\n\nif __name__ == \"__main__\":\n    # Replace with your actual State Machine ARN and desired execution details\n    STATE_MACHINE_ARN = os.environ.get('STATE_MACHINE_ARN', 'arn:aws:states:us-east-1:123456789012:stateMachine:MyStateMachine')\n    EXECUTION_NAME = os.environ.get('EXECUTION_NAME', 'my-test-execution-123')\n    INPUT_DATA = os.environ.get('INPUT_DATA', '{\"key\": \"value\"}')\n\n    asyncio.run(start_step_function_execution(STATE_MACHINE_ARN, EXECUTION_NAME, INPUT_DATA))\n","lang":"python","description":"This quickstart demonstrates how to use `aiobotocore` with `types-aiobotocore-stepfunctions` to start a Step Functions execution. The `SFNClient` type annotation, enclosed in a `TYPE_CHECKING` block, provides rich type hints and autocomplete for the Step Functions client methods and their parameters and return types. Ensure you have `aiobotocore` also installed."},"warnings":[{"fix":"Upgrade your Python environment to 3.9 or newer.","message":"Python 3.8 is no longer supported. Packages generated by `mypy-boto3-builder` (including `types-aiobotocore-stepfunctions`) now require Python >=3.9.","severity":"breaking","affected_versions":">=3.4.0 (generated by mypy-boto3-builder 8.12.0 and later)"},{"fix":"Ensure your type checker (e.g., mypy, pyright) and build environment are up-to-date and correctly configured for PEP 561 stub packages. Typically, this is handled automatically by modern tooling.","message":"The `mypy-boto3-builder`, which generates these types, migrated to PEP 561 compliant packages. While this is a standard improvement, it might affect custom build pipelines or type checker configurations that relied on older stub distribution methods.","severity":"breaking","affected_versions":">=3.4.0 (generated by mypy-boto3-builder 8.12.0 and later)"},{"fix":"Review your explicit `TypeDef` imports and update names according to the latest generated types. Refer to the specific service's documentation or use IDE autocomplete for correct names.","message":"Generated `TypeDef` names were shortened and conflicting names disambiguated in `mypy-boto3-builder` 8.9.0. If you explicitly imported specific `TypeDef` classes from previous versions of `types-aiobotocore-*` packages, their names might have changed (e.g., `CreateDistributionRequestRequestTypeDef` became `CreateDistributionRequestTypeDef`).","severity":"breaking","affected_versions":"<=3.3.0"},{"fix":"Consider `pip install types-aiobotocore-lite-stepfunctions` or use an external type checker with PyCharm.","message":"PyCharm users might experience slow performance and high CPU usage due to PyCharm's type checker with `Literal` overloads. It is recommended to either disable PyCharm's type checker and use `mypy` or `pyright`, or install `types-aiobotocore-lite` instead for a more RAM-friendly experience.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"search_vec":"'3.4.0':54 'activ':59 'aiobotocor':4,14,38,45,51,66,84 'align':47 'annot':2,11,93 'async':88 'automat':32 'aw':83 'boto3':28,73 'builder':29,74 'cadenc':61 'client':20 'correspond':50 'current':53 'date':80 'driven':62 'ensur':76 'function':6,18 'generat':33 'improv':68 'librari':15 'maintain':57 'mypi':27,72,89 'mypy-boto3-builder':26,71 'packag':8 'part':23 'project':30,56 'provid':9 'pyright':90 'releas':60 'servic':39 'sfn':19 'step':5,17 'stepfunct':46,85 'stub':35,87 'support':82 'type':1,10,34,44,81,86,92 'type-annot':91 'types-aiobotocore-stepfunct':43 'up-to-d':77 'updat':64 'version':41,52","created_at":"2026-04-14T18:49:43.294481+00:00","updated_at":"2026-04-16T23:28:56.219991+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\n  File \"/tmp/tmp9poo92fq/venv/lib/python3.12/site-packages/types_aiobotocore_stepfunctions/__init__.py\", line 36, in <module>\n    from .client import SFNClient\n  File \"/tmp/tmp9poo92fq/venv/lib/python3.12/site-packages/types_a"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"3.7.0","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/youtype/mypy_boto3_builder","docs":"https://youtype.github.io/types_aiobotocore_docs/types_aiobotocore_stepfunctions/","changelog":null,"pypi":"https://pypi.org/project/types-aiobotocore-stepfunctions/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["type-stubs","aws"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}