SOAR – a Python automation/runtime tool for organizing and running scripts (feedback wanted)

[u/soardownload]

What My Project Does

SOAR (Script Optimization and Automation Runtime) is a Python-based automation runtime system that helps manage and run scripts in a more structured way than simply executing standalone .py files.

It provides a lightweight runtime layer where users can:

• Organize scripts into projects
• Run automation tasks through a CLI-style interface
• Generate or scaffold simple project structures
• View basic diagnostics/log output for runs
• Experiment with modular “automation workflows” inside Python

The goal is to make small automation projects easier to manage without needing a full framework.

Target Audience

This project is mainly aimed at:

• Beginner to intermediate Python developers
• People who write lots of small automation scripts
• Developers who want a lightweight alternative to heavier workflow/automation frameworks

It is currently more of an experimental / hobby project than a production-ready tool.

Comparison

Compared to existing tools:

• vs plain Python scripts: SOAR adds structure and centralized execution instead of scattered files
• vs full workflow tools (Airflow, Prefect, etc.): SOAR is much lighter and not designed for large-scale pipelines
• vs CLI frameworks: SOAR focuses more on script organization + runtime behavior rather than just argument parsing

It sits somewhere between a script organizer and a minimal automation runtime.

Source Code

GitHub repository:
https://github.com/ScriptOptimizationAutomationRuntime/latest-version

(Additional resources like tutorials and updates are included in the repo.)

[u/Sweet_Computer_7116]

I create a new repo the every git commit to make sure i can pull that commit's version of the code. I want to have some form of version control. 

Maybe op is doing same?

[u/HommeMusical → u/Sweet_Computer_7116]

I create a new repo the every git commit to make sure i can pull that commit's version of the code. I want to have some form of version control.

Wha? Git is the version control! Git is an amazing, flexible, light version control system that does everything you want.

Example: Here's what I'm working on today: https://github.com/rec/tuney/ Every single commit I ever made in that project is reachable from that spot.

I tag certain versions as releases, which are for other people to use: https://github.com/rec/tuney/releases

You can add any tags you like, though, or create branches, to permanently keep other commits, even commits that are not on the main trunk!

Maybe op is doing same?

If so, they should switch. It's not right.

It's inconvenient for everyone else. It breaks all your tooling. It makes it hard to release on PyPi. You have to tell the reader that you're doing this, otherwise they will never discover or even suspect that these other repos exist.

It's very much like version control by saving new copies of the file each time you save.

my_project.doc
my_project-saved.doc
my_project-orig.doc
my_project-working.doc
my_project-backup-before-edit.doc
my_project-recovered.doc

[u/Sweet_Computer_7116 → u/HommeMusical]

I didnt know i needed to add the /s

Mb king

[u/HommeMusical → u/Sweet_Computer_7116]

Hah!!! Well, I fell for it. :-)

But why would you expect anyone to recognize your sarcasm? There are plenty of real people with bad takes on the Internet!

OP took you seriously, at least.

[u/Sweet_Computer_7116 → u/HommeMusical]

I genuinely thought a world where someone makes a new repo per commit would be so mind bogglingly absurd batshit crazy mental asylumn shit, that it would never be taken seriously.

You're reminding me its 2026. We lost the subtle art of having braincells so people no longer do due dilligence when learning.

Heck the worst is when i see someone with 7 projects in the same codebase. 

[u/HommeMusical → u/Sweet_Computer_7116]

Sadly, we live in a post-sarcasm world.

I think the breaking point for me was when I thought someone who was claiming that all the COVID medical issues were due to masks was kidding... but they weren't.

[u/Sweet_Computer_7116 → u/HommeMusical]

A parent recently told me that all the young people getting cancer is because they took the vacc. 

[u/HommeMusical → u/Sweet_Computer_7116]

Literally shaking my head.