# Python Replayer Adapter for Temporal
A Python adapter for debugging and replaying Temporal workflows with breakpoint support.
## Features
- **Workflow Debugging**: Comprehensive interceptors for debugging workflow execution
- **Breakpoint Support**: Set breakpoints for standalone mode or integrate with IDE debugger
- **Dual Modes**: Support for both standalone (JSON file) and IDE-integrated replay modes
- **Activity Debugging**: Interceptors for activity execution debugging
## Installation
```bash
# Install in development mode
pip install -e .
# Or install with development dependencies
pip install -e .[dev]
```
## Quick Start
### Standalone Mode
```python
from replayer_adapter_python import *
# Configure replay
set_replay_mode(ReplayMode.STANDALONE)
set_breakpoints([5, 15, 30])
# Replay workflow
opts = ReplayOptions(history_file_path="workflow_history.json")
replay(opts, YourWorkflowClass)
```
### IDE Integration Mode
```python
from replayer_adapter_python import *
# Set IDE mode (connects via WFDBG_HISTORY_PORT env var)
set_replay_mode(ReplayMode.IDE)
# Replay with IDE debugger
opts = ReplayOptions()
replay(opts, YourWorkflowClass)
```
## API Reference
### Core Functions
- `set_replay_mode(mode)`: Set replay mode (`ReplayMode.STANDALONE` or `ReplayMode.IDE`)
- `set_breakpoints(event_ids)`: Set breakpoints for standalone mode
- `replay(opts, workflow_class)`: Main replay function
### Classes
- `ReplayOptions`: Configuration for replay settings
- `RunnerWorkerInterceptor`: Main interceptor for workflow debugging
## Environment Variables
- `WFDBG_HISTORY_PORT`: Port for IDE debugger communication (default: 54578)
## Dependencies
- `temporalio>=1.15.0`
- `requests>=2.32.0`
Raw data
{
"_id": null,
"home_page": null,
"name": "temporal-replayer-adapter-python",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "temporal, workflow, debugging, replay, interceptor",
"author": null,
"author_email": "Duy Phuong Nguyen <knowledge.phuongnguyen@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/1e/b5/044124ed936f7ac6c30d38fdb4890ad37edd9bac475784e7216b7a04ae59/temporal_replayer_adapter_python-0.0.2.tar.gz",
"platform": null,
"description": "# Python Replayer Adapter for Temporal\n\nA Python adapter for debugging and replaying Temporal workflows with breakpoint support.\n\n## Features\n\n- **Workflow Debugging**: Comprehensive interceptors for debugging workflow execution\n- **Breakpoint Support**: Set breakpoints for standalone mode or integrate with IDE debugger\n- **Dual Modes**: Support for both standalone (JSON file) and IDE-integrated replay modes\n- **Activity Debugging**: Interceptors for activity execution debugging\n\n## Installation\n\n```bash\n# Install in development mode\npip install -e .\n\n# Or install with development dependencies\npip install -e .[dev]\n```\n\n## Quick Start\n\n### Standalone Mode\n\n```python\nfrom replayer_adapter_python import *\n\n# Configure replay\nset_replay_mode(ReplayMode.STANDALONE)\nset_breakpoints([5, 15, 30])\n\n# Replay workflow\nopts = ReplayOptions(history_file_path=\"workflow_history.json\")\nreplay(opts, YourWorkflowClass)\n```\n\n### IDE Integration Mode\n\n```python\nfrom replayer_adapter_python import *\n\n# Set IDE mode (connects via WFDBG_HISTORY_PORT env var)\nset_replay_mode(ReplayMode.IDE)\n\n# Replay with IDE debugger\nopts = ReplayOptions()\nreplay(opts, YourWorkflowClass)\n```\n\n## API Reference\n\n### Core Functions\n\n- `set_replay_mode(mode)`: Set replay mode (`ReplayMode.STANDALONE` or `ReplayMode.IDE`)\n- `set_breakpoints(event_ids)`: Set breakpoints for standalone mode\n- `replay(opts, workflow_class)`: Main replay function\n\n### Classes\n\n- `ReplayOptions`: Configuration for replay settings\n- `RunnerWorkerInterceptor`: Main interceptor for workflow debugging\n\n## Environment Variables\n\n- `WFDBG_HISTORY_PORT`: Port for IDE debugger communication (default: 54578)\n\n## Dependencies\n\n- `temporalio>=1.15.0`\n- `requests>=2.32.0` \n",
"bugtrack_url": null,
"license": null,
"summary": "Python Replayer Adapter for Temporal workflows with debugging capabilities",
"version": "0.0.2",
"project_urls": {
"Documentation": "https://github.com/phuongdnguyen/temporal-workflow-debugger/blob/main/replayer-adapter-python/README.md",
"Homepage": "https://github.com/phuongdnguyen/temporal-workflow-debugger",
"Issues": "https://github.com/phuongdnguyen/temporal-workflow-debugger/issues",
"Repository": "https://github.com/phuongdnguyen/temporal-workflow-debugger"
},
"split_keywords": [
"temporal",
" workflow",
" debugging",
" replay",
" interceptor"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cb3ba7ee7e26c68942f813d92c880b7916ba8d67bbe8b14da45f9a7521b9998d",
"md5": "090c3d923f75205a67636e013a0d2261",
"sha256": "ad4477d015689dce0e90c5f9ef90586a7f9c50f1b48e9b536488aff79792266f"
},
"downloads": -1,
"filename": "temporal_replayer_adapter_python-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "090c3d923f75205a67636e013a0d2261",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 10523,
"upload_time": "2025-08-15T10:23:58",
"upload_time_iso_8601": "2025-08-15T10:23:58.411503Z",
"url": "https://files.pythonhosted.org/packages/cb/3b/a7ee7e26c68942f813d92c880b7916ba8d67bbe8b14da45f9a7521b9998d/temporal_replayer_adapter_python-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1eb5044124ed936f7ac6c30d38fdb4890ad37edd9bac475784e7216b7a04ae59",
"md5": "6842c6de728ad35e15f732a985809904",
"sha256": "58fba1e7be924f6b75880f5b6b4a25b6dab0d00ab124933370ea597018e9ff24"
},
"downloads": -1,
"filename": "temporal_replayer_adapter_python-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "6842c6de728ad35e15f732a985809904",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 12353,
"upload_time": "2025-08-15T10:23:59",
"upload_time_iso_8601": "2025-08-15T10:23:59.481117Z",
"url": "https://files.pythonhosted.org/packages/1e/b5/044124ed936f7ac6c30d38fdb4890ad37edd9bac475784e7216b7a04ae59/temporal_replayer_adapter_python-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-15 10:23:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "phuongdnguyen",
"github_project": "temporal-workflow-debugger",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "temporal-replayer-adapter-python"
}
JSON
