Skip to main content

Stail

CLI Tool to run and tail a step function synchronously and persist event logs for the state machine execution on disk.

Screenshot (Sample screenshot of terminal output)

Use cases:

  • Running and monitoring step function execution directly from terminal or Jupyter notebook.
  • In case of error, identifying the failed task and cause of error.
  • Debugging by reading events log file and all the metadata about the failed task (for example input and output).

Installation:

pip install stail

Usage

Run

Starts a step function execution synchronously, tails the event history to the console and create a log file with all the events for the execution.

Log file is stored at stail_logs/[execution name (UUID)].log

stail run --arn [state machine arn] --input [input]

Options:

--arn State machine ARN

--input Input JSON to the state machine

Example:
stail run --arn arn:aws:states:<region>:<account_number>:stateMachine:<name> --input "{\"param\":\"hello\"}"

Version

Displays the version.

stail version

Author: Iman Kamyabi

Feedback: contact@imankamyabi.com

Release files for stail 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for stail 0.2.2
File Size Uploaded
stail-0.2.2.tar.gz 4.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for stail 0.2.2
File Interpreter ABI Platform
stail-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size:9.6 kB

Release files / stail-0.2.2.tar.gz

Download URL stail-0.2.2.tar.gz
Size 4.4 kB
Tags Source
SHA-256 checksum
How to use checksums
6cd2ffcf101ec8d531e4b708285f3ee54b767be73bdd43f27dc41f7b039ed09a
BLAKE2b-256 checksum
How to use checksums
a2cffec05742dda979ed70f546eccaa71ffd1cd2f6e06e24eb2694d1942e212a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.0.0 CPython/3.7.3 Darwin/18.7.0

Release files / stail-0.2.2-py3-none-any.whl

Download URL stail-0.2.2-py3-none-any.whl
Size 5.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5fdb74088f5ba8045a8f47338e39b97ae6aa018e09ed2fe743a38c04e26282d0
BLAKE2b-256 checksum
How to use checksums
8e6b82d155f357acd51201745dc35c5592cfee3e56496675d19f8012f82a61e1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.0.0 CPython/3.7.3 Darwin/18.7.0

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 release files

0.2.1

2 release files

0.1.10

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page