mirror of
https://github.com/th30d4y/ExecuTrace.git
synced 2026-05-26 19:36:32 +00:00
w4nn4d13
95 lines
3.2 KiB
Markdown
95 lines
3.2 KiB
Markdown
<div align="center">
|
|
|
|
```
|
|
███████╗██╗ ██╗███████╗ ██████╗██╗ ██╗████████╗██████╗ █████╗ ██████╗███████╗
|
|
██╔════╝╚██╗██╔╝██╔════╝██╔════╝██║ ██║╚══██╔══╝██╔══██╗██╔══██╗██╔════╝██╔════╝
|
|
█████╗ ╚███╔╝ █████╗ ██║ ██║ ██║ ██║ ██████╔╝███████║██║ █████╗
|
|
██╔══╝ ██╔██╗ ██╔══╝ ██║ ██║ ██║ ██║ ██╔══██╗██╔══██║██║ ██╔══╝
|
|
███████╗██╔╝ ██╗███████╗╚██████╗╚██████╔╝ ██║ ██║ ██║██║ ██║╚██████╗███████╗
|
|
╚══════╝╚═╝ ╚═╝╚══════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝╚══════╝
|
|
```
|
|
|
|
# ExecuTrace
|
|
|
|
**Record, edit, and replay developer workflows**
|
|
|
|
[](https://opensource.org/licenses/MIT)
|
|
[](https://www.python.org/downloads/)
|
|
[](https://pypi.org/project/exectrace-workflow/#description)
|
|
[](#)
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
## 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
|
|
|
|
## Documentation Website
|
|
|
|
The full open source docs website (retro 70s style) lives in `website/` and can be deployed with GitHub Pages.
|
|
|
|
- Source: `website/index.html`
|
|
- Hall of Fame data: `website/data/contributors.json`
|
|
- Security Hall of Fame data: `website/data/security_hof.json`
|
|
|
|
---
|
|
|
|
## Installation
|
|
|
|
### From PyPI (Global Library)
|
|
```bash
|
|
# Install globally from PyPI
|
|
pip install exectrace-workflow
|
|
|
|
# Verify installation
|
|
exectrace --help
|
|
```
|
|
|
|
### From Source (Development)
|
|
```bash
|
|
git clone https://github.com/Stalin-143/ExecuTrace.git
|
|
cd ExecuTrace
|
|
pip install -e .
|
|
```
|
|
|
|
---
|
|
|
|
## Quick Usage
|
|
|
|
```bash
|
|
# Record
|
|
exectrace record my-workflow
|
|
# ... run your commands ...
|
|
exectrace stop
|
|
|
|
# Replay
|
|
exectrace replay my-workflow --explain
|
|
```
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
MIT License - See [LICENSE](LICENSE) for details.
|
|
|
|
## Security
|
|
|
|
- Policy: [SECURITY.md](SECURITY.md)
|
|
- Advisory process: [SECURITY_ADVISORY.md](SECURITY_ADVISORY.md)
|
|
|