  ███████╗██╗  ██╗███████╗ ██████╗██╗   ██╗████████╗██████╗  █████╗  ██████╗███████╗
  ██╔════╝╚██╗██╔╝██╔════╝██╔════╝██║   ██║╚══██╔══╝██╔══██╗██╔══██╗██╔════╝██╔════╝
  █████╗   ╚███╔╝ █████╗  ██║     ██║   ██║   ██║   ██████╔╝███████║██║     █████╗  
  ██╔══╝   ██╔██╗ ██╔══╝  ██║     ██║   ██║   ██║   ██╔══██╗██╔══██║██║     ██╔══╝  
  ███████╗██╔╝ ██╗███████╗╚██████╗╚██████╔╝   ██║   ██║  ██║██║  ██║╚██████╗███████╗
  ╚══════╝╚═╝  ╚═╝╚══════╝ ╚═════╝ ╚═════╝    ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚══════╝

ExecuTrace

Record, edit, and replay developer workflows

About

ExecuTrace is a Python library and CLI tool that captures developer workflows and replays them reliably.

What it does:

Records terminal commands from shell history
Tracks file system changes (create, modify, delete)
Saves workflows in JSON or XML format
Replays workflows with multiple execution modes

Why use it:

Automate repetitive development tasks
Share procedures with team members
Create reproducible environment setups
Document complex workflows reliably
Ensure consistent deployments

Installation

From PyPI (Global Library)

# Install globally from PyPI
pip install exectrace

# Verify installation
exectrace --help

From Source (Development)

git clone https://github.com/Stalin-143/ExecuTrace.git
cd ExecuTrace
pip install -e .

Publishing to PyPI

To publish ExecuTrace as a Python package to PyPI:

Prerequisites

pip install build twine

Build the Package

python -m build

This creates:

dist/exectrace-1.0.0.tar.gz (source distribution)
dist/exectrace-1.0.0-py3-none-any.whl (wheel)

Upload to PyPI

# Upload to official PyPI (requires PyPI account)
twine upload dist/*

# Or test upload first
twine upload -r testpypi dist/*

PyPI Account Setup

Create account at https://pypi.org/account/register/
Generate API token at https://pypi.org/manage/account/token/
Create ~/.pypirc:

[distutils]
index-servers =
    pypi

[pypi]
repository = https://upload.pypi.org/legacy/
username = __token__
password = pypi_YOUR_TOKEN_HERE

Quick Usage

# Record
exectrace record my-workflow
# ... run your commands ...
exectrace stop

# Replay
exectrace replay my-workflow --explain

License

MIT License - See LICENSE for details.