From 736f86bf68d8e115c46ec30263acec3f3e0af2a0 Mon Sep 17 00:00:00 2001
From: Paul Oliver <contact@pauloliver.dev>
Date: Thu, 29 Feb 2024 02:29:14 +0100
Subject: Plugin added to help run simulators in the background.

[#20] The 'fireup.py' plugin can load one, or several, pre-saved
simulations and restart them automatically, each inside its own tmux
session.
---
 bin/plugins/fireup.py | 78 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100755 bin/plugins/fireup.py

diff --git a/bin/plugins/fireup.py b/bin/plugins/fireup.py
new file mode 100755
index 0000000..3e1c750
--- /dev/null
+++ b/bin/plugins/fireup.py
@@ -0,0 +1,78 @@
+#!/usr/bin/env python3
+
+""" FIREUP: Plugin for the SALIS simulator.
+
+File: fireup.py
+Author: Paul Oliver
+Email: paul.t.oliver.design@gmail.com
+
+NOTE: REQUIRES TMUX TO WORK!
+
+Use this script to run one (or several) previously saved simulations in the
+background. Each simulator will run inside a tmux session.
+
+Remember to give this file correct permissions (chmod +x). To use, call it
+followed by an autosave interval (mandatory) and the list of save-files to
+load. Save-file paths are always relative to the './bin/sims/' directory.
+For example:
+
+$ ./bin/plugins/fireup.py -a 0x100000 -f 20.01.sim 20.02.sim 20.03.sim
+
+"""
+
+import argparse
+import os
+import subprocess
+
+
+# Parse CLI arguments with the argparse module. Required arguments are the
+# autosave interval (zero means no autosaving) and a list of previously saved
+# simulation files.
+parser = argparse.ArgumentParser(
+	description="TMUX launcher for pre-saved Salis simulations."
+)
+parser.add_argument(
+	"-f", "--files", required=True, type=str, nargs="+", metavar="FILE",
+	help="File name(s) of simulation(s) to load."
+)
+parser.add_argument(
+	"-a", "--auto", required=True, type=lambda x: int(x, 0), metavar="INT",
+	help="Auto-save interval for the loaded simulation(s)."
+)
+args = parser.parse_args()
+
+
+# Store the path of this script and the main Salis simulation script.
+path = os.path.dirname(__file__)
+salis = os.path.join(path, "../salis.py")
+
+
+# Revise that *all* listed files exist inside the './bin/sims/' directory.
+# Otherwise throw an exception.
+for fname in args.files:
+	abs_path = os.path.join(path, "../sims", fname)
+
+	if not os.path.isfile(abs_path):
+		parser.error("Save file '{}' not found.".format(abs_path))
+
+
+# Also, check that no file names are repeated.
+if len(args.files) != len(set(args.files)):
+	parser.error("Repeated file name detected.")
+
+
+# Everything seems OK! Let's fire up the TMUX sessions, one for every saved
+# file. Tmux sessions will be named similarly to their contained simulations.
+# We can, at any time, re-attach to any running session, or make use of all
+# other tmux commands.
+print("Firing up Salis simulations.")
+
+for fname in args.files:
+	session = "salis-{}".format(fname).replace(".", "-")
+	salis_cmd = "{} load -f {} -a {}".format(salis, fname, args.auto)
+	subprocess.run(["tmux", "new-session", "-d", "-s", session])
+	subprocess.run(["tmux", "send-keys", "-t", session, "{}".format(salis_cmd)])
+	subprocess.run(["tmux", "send-keys", "-t", session, "Enter", "Space"])
+	print("New tmux session '{}' is running '{}' in the background.".format(
+		session, fname
+	))
-- 
cgit v1.2.1