A Python package enabling the development of robust automation scripts that are subdivided into stages.
Project description
staged-script
Python is an ideal language for certain types of infrastructure automation.
Automating what a user does manually often involves walking through a series of
stages. A user may wish to run all the stages in series, or perhaps only a
subset, and depending on how things go, certain stages may need to be retried.
Once the script finishes running, it'd be ideal if it could tell the user
exactly what was run, for the sake of easing replicability. staged-script
aims to ease the development such automation scripts. It's easy to get started
with, but also provides significant power-user functionality for those who need
it.
Installation
To get up and running with staged-script
, simply:
python3 -m pip install staged-script
Usage
Once installed, you can simply
import sys
from typing import List
from staged_script import StagedScript
class MyScript(StagedScript):
@StagedScript.stage("hello", "Greeting the user")
def say_hello(self) -> None:
self.run("echo 'Hello World'", shell=True)
@StagedScript.stage("goodbye", "Bidding farewell")
def say_goodbye(self) -> None:
self.run("echo 'Goodbye World'", shell=True)
def main(self, argv: List[str]) -> None:
self.parse_args(argv)
try:
self.say_hello()
self.say_goodbye()
finally:
self.print_script_execution_summary()
if __name__ == "__main__":
my_script = MyScript({"hello", "goodbye"})
my_script.main(sys.argv[1:])
For more detailed usage and API information, please see our documentation.
Where to Get Help
If you're having trouble with staged-script
, or just want to ask a question,
head on over to our issue board. If a quick search doesn't yield
what you're looking for, feel free to file an issue.
Contributing
If you're interested in contributing to the development of staged-script
,
we'd love to have your help :grinning: Check out our
contributing guidelines for how to get started.
Past contributors include:
License
See LICENSE.md.
Credits
Special thanks to the GMS project for investing in the development of this package. Aspects of this functionality were inspired by the SPiFI Jenkins Pipeline plugin and the ShellLogger Python package.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file staged_script-1.0.2.tar.gz
.
File metadata
- Download URL: staged_script-1.0.2.tar.gz
- Upload date:
- Size: 16.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.0 CPython/3.12.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 15c10d8191ce68af712ebec91ea388a8032e3753b8f189891b640c27868d05f7 |
|
MD5 | a675b362dd36d74019ea9a8fdd4d9f9e |
|
BLAKE2b-256 | 2d3a6dfb408a379b0c66b830520cb48fa3bceae2d483fa3cf7a145a034976676 |
File details
Details for the file staged_script-1.0.2-py3-none-any.whl
.
File metadata
- Download URL: staged_script-1.0.2-py3-none-any.whl
- Upload date:
- Size: 14.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.0 CPython/3.12.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b2530b217da288ce4bbb46930e53361bf2cb7e4ddeb3ba7e90f7116fb3e41f5a |
|
MD5 | be6b1e3f4149fe9a9c68ecb38a8eb595 |
|
BLAKE2b-256 | 8b40c033b2c41dc17e377249d00923df2b89927c493ac55e994825af1d5379fe |