✨ v2.3.0 Add Job, action chaining, and more.

[bmeares]

v2.3.0

• Add the Job class.
  You may now manage jobs with Job:

  import meerschaum as mrsm
  job = Job('syncing-engine', 'sync pipes --loop')
  job.start()

  If you are running on systemd, jobs will be created as user services. Otherwise (e.g. running in Docker) jobs are created as Unix daemons and kept alive by the API server.

  You may choose the executor with -e (--executor-keys). Supported values are local, systemd, and the keys for any API instance. See the jobs documentation for more information.

• Chain actions with +.
  Run multiple commands by joining them with +, similar to && in bash but with better performance (one process).

  $ mrsm show pipes + sync pipes
  

  Adding -d (--daemon) will escape these joiners and run all of the chained commands in the job:

  $ mrsm show pipes + sync pipes --loop -d
  

• Run chained actions as a pipeline with :.
  You can schedule chained actions by adding : to the end of your command:

  mrsm sync pipes -i sql:local + sync pipes : -s 'daily starting 00:00' -d

  Other supported flags are --loop, --min-seconds, and the number of times to run the pipeline (e.g. x2 or 2):

  mrsm sync pipes + verify pipes : --loop --min-seconds 600

  mrsm show pipes + sync pipes : x2

• Add --restart.
  Your job will be automatically restarted if you use any of flags --loop, --schedule, or --restart.

• Execute actions remotely.
  You may execute an action on an API instance by setting the executor to the connector keys. You may run the executor command in the Meercshaum shell (like instance) or pass the flag -e (--executor-keys).

  mrsm sync pipes -e api:main
  

  The output is streamed directly from the API instance (via a websocket).

• Add from_plugin_import().
  You may now easily access attributes from a plugin's submodule with meerschaum.plugins.from_plugin_import().

  from meerschaum.plugins import from_plugin_import
  
  get_defined_pipes = from_plugin_import('compose.utils.pipes', 'get_defined_pipes')

What's Changed

• v2.3.0 by @bmeares in v2.3.0 #164

Full Changelog: v2.2.7...v2.3.0

---

This discussion was created from the release ✨ v2.3.0 Add `Job`, action chaining, and more..