mnogootex 0.2.1 → 2.0.0

data/demo/demo.asciicast

@@ -0,0 +1,114 @@
+{"version": 2, "width": 92, "height": 26, "timestamp": 1637333757, "env": {"SHELL": "/bin/zsh", "TERM": "alacritty"}}
+[0.017014, "o", "\u001b[?2004h$ "]
+[0.816219, "o", "m"]
+[0.880306, "o", "n"]
+[1.120106, "o", "o"]
+[1.328005, "o", "g"]
+[1.431937, "o", "o"]
+[1.560266, "o", "o"]
+[1.664007, "o", "t"]
+[1.824229, "o", "e"]
+[2.096341, "o", "x"]
+[2.208064, "o", " "]
+[2.416225, "o", "b"]
+[2.488119, "o", "u"]
+[2.528114, "o", "i"]
+[2.775867, "o", "l"]
+[2.927851, "o", "d"]
+[3.048131, "o", " "]
+[3.18416, "o", "m"]
+[3.30414, "o", "a"]
+[3.360091, "o", "i"]
+[3.463861, "o", "n"]
+[3.664082, "o", "."]
+[3.768087, "o", "t"]
+[3.872092, "o", "e"]
+[4.072065, "o", "x"]
+[4.19206, "o", "\r\n\u001b[?2004l\r"]
+[4.610511, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\r"]
+[4.630807, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\r"]
+[4.652109, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\r"]
+[4.672831, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\r"]
+[4.693597, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\r"]
+[4.71437, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\r"]
+[4.735132, "o", "Runners: \u001b[0;33;49m⣽\u001b[0m\u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\r"]
+[4.755441, "o", "Runners: \u001b[0;33;49m⣻\u001b[0m\u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\r"]
+[4.776142, "o", "Runners: \u001b[0;33;49m⢿\u001b[0m\u001b[0;33;49m⣽\u001b[0m\u001b[0;33;49m⣽\u001b[0m\r"]
+[4.796857, "o", "Runners: \u001b[0;33;49m⡿\u001b[0m\u001b[0;33;49m⣻\u001b[0m\u001b[0;33;49m⣻\u001b[0m\r"]
+[4.817161, "o", "Runners: \u001b[0;33;49m⣟\u001b[0m\u001b[0;33;49m⢿\u001b[0m\u001b[0;33;49m⢿\u001b[0m\r"]
+[4.837458, "o", "Runners: \u001b[0;33;49m⣯\u001b[0m\u001b[0;33;49m⡿\u001b[0m\u001b[0;33;49m⡿\u001b[0m\r"]
+[4.857789, "o", "Runners: \u001b[0;33;49m⣷\u001b[0m\u001b[0;33;49m⣟\u001b[0m\u001b[0;33;49m⣟\u001b[0m\r"]
+[4.878122, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣯\u001b[0m\u001b[0;33;49m⣯\u001b[0m\r"]
+[4.898448, "o", "Runners: \u001b[0;33;49m⣽\u001b[0m\u001b[0;33;49m⣷\u001b[0m\u001b[0;33;49m⣷\u001b[0m\r"]
+[4.918754, "o", "Runners: \u001b[0;33;49m⣻\u001b[0m\u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣾\u001b[0m\r"]
+[4.939493, "o", "Runners: \u001b[0;33;49m⢿\u001b[0m\u001b[0;33;49m⣽\u001b[0m\u001b[0;33;49m⣽\u001b[0m\r"]
+[4.960303, "o", "Runners: \u001b[0;33;49m⡿\u001b[0m\u001b[0;33;49m⣻\u001b[0m\u001b[0;33;49m⣻\u001b[0m\r"]
+[4.980995, "o", "Runners: \u001b[0;33;49m⣟\u001b[0m\u001b[0;33;49m⢿\u001b[0m\u001b[0;33;49m⢿\u001b[0m\r"]
+[5.001721, "o", "Runners: \u001b[0;33;49m⣯\u001b[0m\u001b[0;33;49m⡿\u001b[0m\u001b[0;33;49m⡿\u001b[0m\r"]
+[5.022407, "o", "Runners: \u001b[0;33;49m⣷\u001b[0m\u001b[0;33;49m⣟\u001b[0m\u001b[0;33;49m⣟\u001b[0m\r"]
+[5.042661, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;33;49m⣯\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.062924, "o", "Runners: \u001b[0;33;49m⣽\u001b[0m\u001b[0;33;49m⣷\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.083219, "o", "Runners: \u001b[0;33;49m⣻\u001b[0m\u001b[0;33;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.10347, "o", "Runners: \u001b[0;33;49m⢿\u001b[0m\u001b[0;33;49m⣽\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.123727, "o", "Runners: \u001b[0;33;49m⡿\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.143997, "o", "Runners: \u001b[0;33;49m⣟\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.164261, "o", "Runners: \u001b[0;33;49m⣯\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.18454, "o", "Runners: \u001b[0;33;49m⣷\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.204898, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.225157, "o", "Runners: \u001b[0;33;49m⣽\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.245427, "o", "Runners: \u001b[0;33;49m⣻\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.265709, "o", "Runners: \u001b[0;33;49m⢿\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.285988, "o", "Runners: \u001b[0;33;49m⡿\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.306276, "o", "Runners: \u001b[0;33;49m⣟\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.326587, "o", "Runners: \u001b[0;33;49m⣯\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.346862, "o", "Runners: \u001b[0;33;49m⣷\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.367137, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.387471, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.407789, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.428094, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.448427, "o", "Runners: \u001b[0;33;49m⣽\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.468685, "o", "Runners: \u001b[0;33;49m⣻\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.48902, "o", "Runners: \u001b[0;33;49m⢿\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.509286, "o", "Runners: \u001b[0;33;49m⡿\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.529559, "o", "Runners: \u001b[0;33;49m⣟\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.549834, "o", "Runners: \u001b[0;33;49m⣯\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.570114, "o", "Runners: \u001b[0;33;49m⣷\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.590495, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.610773, "o", "Runners: \u001b[0;33;49m⣽\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.631053, "o", "Runners: \u001b[0;33;49m⣻\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.651328, "o", "Runners: \u001b[0;33;49m⢿\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.671634, "o", "Runners: \u001b[0;33;49m⡿\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.691885, "o", "Runners: \u001b[0;33;49m⣟\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.712144, "o", "Runners: \u001b[0;33;49m⣯\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.732409, "o", "Runners: \u001b[0;33;49m⣷\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.752725, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.77299, "o", "Runners: \u001b[0;33;49m⣽\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.793269, "o", "Runners: \u001b[0;33;49m⣻\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.81354, "o", "Runners: \u001b[0;33;49m⢿\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.833802, "o", "Runners: \u001b[0;33;49m⡿\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.854091, "o", "Runners: \u001b[0;33;49m⣟\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.874667, "o", "Runners: \u001b[0;33;49m⣯\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.894903, "o", "Runners: \u001b[0;33;49m⣷\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.915157, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.935432, "o", "Runners: \u001b[0;33;49m⣽\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.955706, "o", "Runners: \u001b[0;33;49m⣻\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.975985, "o", "Runners: \u001b[0;33;49m⢿\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[5.996281, "o", "Runners: \u001b[0;33;49m⡿\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[6.016565, "o", "Runners: \u001b[0;33;49m⣟\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[6.03685, "o", "Runners: \u001b[0;33;49m⣯\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[6.057124, "o", "Runners: \u001b[0;33;49m⣷\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[6.077406, "o", "Runners: \u001b[0;33;49m⣾\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[6.097789, "o", "Runners: \u001b[0;33;49m⣽\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[6.118073, "o", "Runners: \u001b[0;33;49m⣻\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r"]
+[6.138511, "o", "Runners: \u001b[0;32;49m⣯\u001b[0m\u001b[0;31;49m⣾\u001b[0m\u001b[0;31;49m⢿\u001b[0m\r\r\nOutcome:\r\n"]
+[6.138712, "o", "  \u001b[0;32;49m✔\u001b[0m scrarticle\r\n  \u001b[0;31;49m✘\u001b[0m article\r\n"]
+[6.139693, "o", "    \u001b[0;97;49mLatexmk: This is Latexmk, John Collins, 21 September 2021, version: 4.75.\u001b[0m\r\n    \u001b[0;97;49mThis is pdfTeX, Version 3.141592653-2.6-1.40.23 (TeX Live 2021) (preloaded format=latex)\u001b[0m\r\n    \u001b[0;91;49m! Undefined control sequence.\u001b[0m\r\n    \u001b[0;91;49ml.4   Let's port my \\KOMAScript\u001b[0m\r\n    \u001b[0;91;49m                               \\ article!\u001b[0m\r\n    \u001b[0;97;49mOutput written on main.dvi (1 page, 424 bytes).\u001b[0m\r\n    \u001b[0;91;49mLatexmk: Errors, so I did not complete making targets\u001b[0m\r\n  \u001b[0;31;49m✘\u001b[0m book\r\n"]
+[6.140624, "o", "    \u001b[0;97;49mLatexmk: This is Latexmk, John Collins, 21 September 2021, version: 4.75.\u001b[0m\r\n    \u001b[0;97;49mThis is pdfTeX, Version 3.141592653-2.6-1.40.23 (TeX Live 2021) (preloaded format=latex)\u001b[0m\r\n    \u001b[0;91;49m! Undefined control sequence.\u001b[0m\r\n    \u001b[0;91;49ml.3   \\abstract\u001b[0m\r\n    \u001b[0;91;49m               {Simply put, my article is awesome.}\u001b[0m\r\n    \u001b[0;91;49m! Undefined control sequence.\u001b[0m\r\n    \u001b[0;91;49ml.4   Let's port my \\KOMAScript\u001b[0m\r\n"]
+[6.140752, "o", "    \u001b[0;91;49m                               \\ article!\u001b[0m\r\n    \u001b[0;97;49mOutput written on main.dvi (1 page, 324 bytes).\u001b[0m\r\n    \u001b[0;91;49mLatexmk: Errors, so I did not complete making targets\u001b[0m\r\n"]
+[6.145564, "o", "\u001b[?2004h$ "]
+[9.623727, "o", "e"]
+[9.720091, "o", "x"]
+[9.904131, "o", "i"]
+[10.016153, "o", "t"]
+[10.496203, "o", "\r\n\u001b[?2004l\r"]
+[10.49658, "o", "exit\r\n"]

data/demo/main.tex

@@ -0,0 +1,5 @@
+\documentclass{scrarticle}
+\begin{document}
+  \abstract{Simply put, my article is awesome.}
+  Let's port my \KOMAScript\ article!
+\end{document}

data/exe/mnogootex

@@ -1,96 +1,6 @@
 #!/usr/bin/env ruby
-# coding: utf-8
+# frozen_string_literal: true
 
 require 'mnogootex'
 
-
-# require 'pathname'
-
-# target = ARGV[0]
-# target_path = File.expand_path target
-# cfg = Mnogootex::Configuration.new
-# cfg.load target_path
-
-require 'tmpdir'
-require 'fileutils'
-require 'open3'
-
-require 'colorize'
-
-target = ARGV[0]
-
-
-raise "No parameters given." if ARGV.length.zero?
-
-if ARGV.length == 3
-  raise "Unknown command." unless %w{show view open}.include? ARGV[1].downcase
-  job = Mnogootex::Job.new cls: ARGV[2], target: File.expand_path(target)
-  pdf = Dir.glob("#{job.tmp_dirname}/*.pdf").first
-  raise "PDF non esiste." unless File.exist? pdf
-  `command -v open >/dev/null && open #{pdf} || xdg-open #{pdf}`
-  exit
-end
-
-puts "Mnogootex v#{Mnogootex::VERSION}"
-
-main_path = File.expand_path(target)
-main_basename = File.basename main_path
-main_dirname = File.dirname main_path
-
-cfg = Mnogootex::Configuration.new
-cfg.load main_dirname
-
-raise "File non esiste." unless File.exist? main_path
-
-@documentclasses = cfg['compile_with']
-
-$jobs = []
-$threads = []
-$draw_threads = []
-
-$threads = []
-
-$anim = cfg['animation'].freeze
-
-STDOUT.sync = true
-
-def draw_status
-  icons = $jobs.map do |j|
-    icon = $anim[j.ticks % $anim.length]
-    case j.thread.status
-    when 'sleep', 'run', 'aborting'
-      icon.yellow
-    when false, nil # exited (normally or w/ error)
-      j.success? ? icon.green : icon.red
-    end
-  end
-  print '  Jobs: ' + icons.join + "\r"
-end
-
-draw_status
-
-@documentclasses.each_with_index do |cls, index|
-  job = Mnogootex::Job.new cls: cls, target: main_path
-  job.setup
-  job.run
-
-  $jobs << job
-
-  $draw_threads << job.tick_thread
-  $threads << job.thread
-end
-
-$threads.map(&:join)
-$draw_threads.map(&:join)
-
-puts
-
-puts '  Details:'
-$jobs.each do |job|
-  if job.success?
-    puts '    ' + "✔".green + ' ' + File.basename(job.cls)
-  else
-    puts '    ' + "✘".red + ' ' + File.basename(job.cls)
-    puts job.log[2..-2].join.gsub(/^/,' '*6).chomp.red
-  end
-end
+Mnogootex::CLI.start ARGV

data/lib/mnogootex/cfg.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require 'pathname'
+
+module Mnogootex
+  module Cfg
+    BASENAME = '.mnogootexrc'
+    DEFAULTS = {
+      'jobs' => [],
+      'spinner' => '⣾⣽⣻⢿⡿⣟⣯⣷',
+      'work_path' => nil,
+    }.freeze
+
+    def self.load_descending(pathname:, basename:)
+      pathname.realpath.descend.
+        map { |path| path.join(basename) }.
+        select(&:exist?).reject(&:zero?).
+        map { |path| YAML.load_file(path) }.
+        reduce(&:merge!)
+    end
+
+    def self.recombobulate(*args)
+      try_args(*args) || try_link(*args) || try_cfgs(*args)
+    end
+
+    class << self
+      private
+
+      def split_jobs_and_flags(args)
+        # TODO: some kind of validation?
+        flags = args.drop_while { |arg| !arg.start_with?('-') }
+        jobs = args.take_while { |arg| !arg.start_with?('-') }
+        [(jobs unless jobs.empty?), (flags unless flags.empty?)]
+      end
+
+      def try_args(*args)
+        main = Pathname.new(args.fetch(-1, ''))
+        return unless main.file?
+
+        main = main.realpath
+        cfg = load_descending(pathname: main.dirname, basename: BASENAME)
+        jobs, flags = split_jobs_and_flags(args[0..-2])
+
+        [jobs, flags, main, cfg]
+      end
+
+      def try_link(*args)
+        link = Pathname.pwd.ascend.map { |p| p.join('.mnogootex.src') }.detect(&:symlink?)
+        return if link.nil?
+
+        main = link.readlink.realpath
+        cfg = load_descending(pathname: main.dirname, basename: BASENAME)
+        jobs, flags = split_jobs_and_flags(args)
+
+        [jobs, flags, main, cfg]
+      end
+
+      def try_cfgs(*args)
+        yaml = Pathname.pwd.ascend.map { |p| p.join('.mnogootexrc') }.detect(&:file?)
+        return if yaml.nil?
+
+        cfg = load_descending(pathname: yaml.dirname, basename: BASENAME)
+        main = yaml.dirname.join(cfg.fetch('main', ''))
+        main = main.file? ? main.realpath : nil
+        jobs, flags = split_jobs_and_flags(args)
+
+        [jobs, flags, main, cfg]
+      end
+    end
+  end
+end

data/lib/mnogootex/cli.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'thor'
+require 'pathname'
+
+require 'mnogootex/utils'
+require 'mnogootex/job/warden'
+require 'mnogootex/job/porter'
+require 'mnogootex/cfg'
+
+module Mnogootex
+  class CLI < Thor
+    desc 'exec [JOB ...] [FLAG ...] ROOT',
+         'Execute latexmk with FLAGs on each JOB for ROOT document'
+    def exec(*args)
+      execute_latexmk(*args, default_flags: [])
+    end
+
+    desc 'build [JOB ...] [FLAG ...] ROOT',
+         'Build each JOB for ROOT document'
+    def build(*args)
+      execute_latexmk(*args, default_flags: ['-interaction=nonstopmode'])
+    end
+
+    desc 'open [JOB ...] [FLAG ...] ROOT',
+         '(Build and) open the artifact of each JOB for ROOT document'
+    def open(*args)
+      execute_latexmk(*args, default_flags: ['-interaction=nonstopmode', '-pv'])
+    end
+
+    desc 'clean [JOB ...] [FLAG ...] ROOT',
+         'Delete nonessential files of each JOB for ROOT document'
+    def clean(*args)
+      execute_latexmk(*args, default_flags: ['-c'])
+    end
+
+    desc 'clobber [JOB ...] [FLAG ...] ROOT',
+         'Delete nonessential files and artifacts of each JOB for ROOT document'
+    def clobber(*args)
+      execute_latexmk(*args, default_flags: ['-C'])
+    end
+    
+    desc 'help [COMMAND]',
+         'Describe available commands or one specific COMMAND'
+    def help(*args)
+      super
+
+      puts <<~EXTRA_HELP
+        JOBs are document class names. The default is the whole list in your configuration file.
+        FLAGs are options passed to latexmk. Please refer to `latexmk -help` for details.
+      EXTRA_HELP
+    end
+
+  private
+
+    def execute_latexmk(*args, default_flags: [])
+      jobs, flags, main, cfg = Mnogootex::Cfg.recombobulate(*args)
+      cfg = Mnogootex::Cfg::DEFAULTS.merge(cfg).merge({ 'jobs' => jobs }.compact)
+      flags = [*default_flags, *flags]
+      Mnogootex::Job::Warden.new(source: main, configuration: cfg, flags: flags).start
+    end
+  end
+end

data/lib/mnogootex/job/logger.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require 'colorize'
+
+module Mnogootex
+  module Job
+    class Logger < Thread
+      def initialize(spinner:, processor:, runners:, porters:)
+        super do
+          while runners.any?(&:alive?)
+            self.class.print_status(runners: runners, spinner: spinner)
+            sleep 0.02 # 50 fps
+          end
+          self.class.print_status(runners: runners, spinner: spinner)
+          puts
+          self.class.print_outcome(runners: runners, porters: porters, processor: processor)
+        end
+      end
+
+      class << self
+        def print_status(runners:, spinner:)
+          spinners_frames = []
+          runners.each do |runner|
+            spinner_frame = spinner[runner.count_lines % spinner.size]
+            spinners_frames << colour_by_state(spinner_frame, runner)
+          end
+          print "Runners: #{spinners_frames.join}\r"
+        end
+
+        def print_outcome(runners:, porters:, processor:)
+          puts 'Outcome:'
+          porters.zip(runners).each do |porter, runner|
+            outcome_icon = runner.successful? ? '✔'.green : '✘'.red
+            puts "  #{outcome_icon} #{porter.hid}"
+            puts processor.call(runner.log_lines) unless runner.successful?
+          end
+        end
+
+        private
+
+        def colour_by_state(string, runner)
+          if runner.alive?
+            string.yellow
+          elsif runner.successful?
+            string.green
+          else
+            string.red
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mnogootex/job/porter.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'pathname'
+require 'tmpdir'
+
+require 'mnogootex/utils'
+
+module Mnogootex
+  module Job
+    class Porter
+      attr_reader :hid
+
+      def initialize(hid:, source_path:, work_path: nil)
+        @source_path = Pathname.new(source_path).realpath
+        @work_path = calc_work_path(work_path).tap(&:mkpath).realpath
+        @hid = hid
+      end
+
+      def target_dir
+        @target_dir ||= @work_path.join(hid)
+      end
+
+      def target_path
+        @target_path ||= target_dir.join(@source_path.basename)
+      end
+
+      def clobber
+        target_dir.rmtree if target_dir.directory?
+      end
+
+      def provide
+        target_dir.mkpath
+        providable_files = @source_path.dirname.children
+        providable_files.reject!(&@work_path.method(:==))
+        FileUtils.cp_r providable_files, target_dir
+        remove_configuration(target_dir)
+        create_link_to_source(target_dir)
+      end
+
+      private
+
+      def remove_configuration(folder_path)
+        path = folder_path.join('.mnogootexrc')
+        path.delete if path.file?
+      end
+
+      def create_link_to_source(folder_path)
+        path = folder_path.join('.mnogootex.src')
+        path.make_symlink(@source_path) unless path.symlink?
+      end
+
+      def calc_work_path(path)
+        return Pathname.new(path) unless path.nil?
+
+        Pathname.new(Dir.tmpdir).join('mnogootex', source_id)
+      end
+
+      def source_id
+        @source_id ||= Utils.short_md5(@source_path.to_s)
+      end
+    end
+  end
+end

data/lib/mnogootex/job/runner.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require 'open3'
+require 'io/wait'
+
+module Mnogootex
+  module Job
+    class Runner
+      POLLING_TIMEOUT = 0.02
+
+      attr_reader :hid, :log_lines
+
+      def initialize(cmd:, chdir:)
+        @log_lines = []
+        _, @stream, @thread = Open3.popen2e(*cmd, chdir: chdir)
+        @poller = start_poller
+      end
+
+      def alive?
+        @poller.alive?
+      end
+
+      def successful?
+        @poller.value.exitstatus.zero?
+      end
+
+      def count_lines
+        return log_lines.size unless alive?
+
+        @ticks = [@ticks || -1, log_lines.size - 1].min + 1
+      end
+
+      private
+
+      def start_poller
+        Thread.new do
+          polling_loop
+
+          # NOTE: waits on @thread and returns its value
+          @thread.value
+        end
+      end
+
+      def polling_loop
+        loop do
+          if @stream.wait_readable(POLLING_TIMEOUT).nil?
+            # If the stream timeouts and the thread is dead we expect no nore data.
+            # This happens on commands like `latexmk -pv` which fork other processes.
+            break unless @thread.alive?
+          else
+            # If we reach EOF, we expect no more data.
+            break if (line = @stream.gets).nil?
+
+            log_lines << line
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mnogootex/job/warden.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+require 'colorize'
+
+require 'mnogootex/log'
+require 'mnogootex/log/processor'
+require 'mnogootex/job/porter'
+require 'mnogootex/job/runner'
+require 'mnogootex/job/logger'
+
+module Mnogootex
+  module Job
+    class Warden
+      LATEXMK_PATH = 'latexmk'
+
+      def initialize(source:, configuration:, flags:)
+        @source = source
+        @configuration = configuration
+        @flags = flags
+
+        @processor = nil
+        @porters = []
+        @runners = []
+        @logger = nil
+      end
+
+      def start
+        init_processor
+        init_porters
+        exec_porters
+        init_and_exec_runners
+        init_and_exec_logger
+        @logger.join
+      end
+
+      private
+
+      def init_porters
+        @configuration['jobs'].each do |cls|
+          @porters << Mnogootex::Job::Porter.new(
+            hid: cls,
+            source_path: @source,
+            work_path: @configuration['work_path'],
+          )
+        end
+      end
+
+      def exec_porters
+        @porters.each do |porter|
+          # porter.clobber
+          porter.provide
+          transformer(porter.hid, porter.target_path)
+        end
+      end
+
+      def init_and_exec_runners
+        @runners = @porters.map do |porter|
+          Mnogootex::Job::Runner.new(
+            cmd: commandline(porter.target_path),
+            chdir: porter.target_dir,
+          )
+        end
+      end
+
+      def init_processor
+        @processor = Log::Processor.new(
+          matchers: Mnogootex::Log::DEFAULT_MATCHERS,
+          levels: Mnogootex::Log::DEFAULT_LEVELS,
+          min_level: :info,
+          colorize: true,
+          indent_width: 4,
+        )
+      end
+
+      def init_and_exec_logger
+        @logger = Mnogootex::Job::Logger.new(
+          spinner: @configuration['spinner'],
+          processor: @processor.method(:run),
+          runners: @runners,
+          porters: @porters,
+        )
+      end
+
+      # TODO: generalize, integrate with Runner
+      def commandline(target_pathname)
+        [
+          LATEXMK_PATH,
+          *@flags,
+          target_pathname.basename.to_s
+        ]
+      end
+
+      # TODO: generalize, integrate with Porter
+      def transformer(new_class_name, target_pathname)
+        old_code = target_pathname.read
+        new_code = old_code.sub(
+          /\\documentclass(\[.*?\])?{.*?}/,
+          "\\documentclass{#{new_class_name}}",
+        )
+        target_pathname.write(new_code)
+      end
+    end
+  end
+end

data/lib/mnogootex/log/level.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Mnogootex
+  module Log
+    # This data structure represents a log level usually referred to
+    # by its {name}. It has a numeric {priority} and a {color} used
+    # for rendering.
+    #
+    # @!attribute priority
+    #   @return [Numeric] the numeric priority of the log level
+    # @!attribute name
+    #   @return [Symbol] the human readable name of the log level
+    # @!attribute color
+    #   @return [Symbol] the color visually representing the {priority}
+    Level = Struct.new(:priority, :name, :color)
+  end
+end