1 (in-package #:candle-cli)
3 (defgeneric execute-command (command args))
5 (defmethod execute-command (command args)
6 (format *error-output* "Unknown command '~(~A~)'. See 'candle --help'.~%" command))
8 (defun job-info->line (job-info)
9 (format nil "~A (~A) ~A"
10 (subseq (first job-info) 0 8)
11 (format nil "~{~2,,,'0@A/~2,,,'0@A/~A ~2,,,'0@A:~2,,,'0@A~}"
12 (utils:time-as-list (third job-info) :month :date :year :hr :min))
13 (case (second job-info)
14 (:succeeded (format nil "~c[1;32mPassed~c[0m" #\Esc #\Esc))
15 (:failed (format nil "~c[1;31mFailed~c[0m" #\Esc #\Esc))
17 (:no-candle-file "No candle file present")
18 (:in-progress "In progress"))))
20 (defmacro standard-cli (cmd options-in args usage remaining-args-required &rest success)
21 `(multiple-value-bind (parsed-options remaining-args error) (opera:process-arguments ,options-in ,args)
23 ((opera:option-present :help parsed-options)
24 (format t "~A" ,(if (eql usage :default) `(opera:usage ,cmd ,options-in) usage)))
25 ((eql error :unknown-option)
26 (format *error-output* "Unknown option: ~A. See '~A --help'.~%" (car remaining-args) ,cmd))
27 ((eql error :required-argument-missing)
28 (format *error-output* "Missing argument for ~A. See '~A --help'.~%" (car remaining-args) ,cmd))
29 ((and ,remaining-args-required (not remaining-args)) (format *error-output* "~A required. See 'candle --help'.~%" ,remaining-args-required))
33 ;;; Section for ./candle
36 (standard-cli "candle" (main-options) (cdr sb-ext:*posix-argv*) (main-usage) "Command"
38 (and (opera:option-present :port parsed-options) (not (parse-integer (opera:option-argument :port parsed-options) :junk-allowed t)))
39 (format *error-output* "--port requires a number. See 'candle -h'~%")
41 ((communication:*query-port*
44 (opera:option-present :port parsed-options)
45 (parse-integer (opera:option-argument :port parsed-options) :junk-allowed t))
47 (execute-command (intern (string-upcase (car remaining-args)) :keyword) (cdr remaining-args))))))
49 (defun main-options ()
50 '((:name :help :short "h" :long "help" :description "Print this usage.")
51 (:name :port :short "p" :long "port" :takes-argument t :variable-name "PORT"
52 :description "Port on which to listen for commands. Defaults to 25004")
53 (:positional "<command>" :required t :description "Command for candle, see below")))
59 "Interacts with candle server. The available commands are:
60 project Interact with projects
61 job Get information about jobs
62 run Local command. Run candle in the current working directory"))
64 ;;; Section for ./candle project
66 (defmethod execute-command ((command (eql :project)) args)
67 (standard-cli "candle project" (project-options) args (project-usage) nil
69 ((subcommand (intern (string-upcase (car remaining-args)) :keyword)))
71 (:delete (delete-project (cdr remaining-args)))
72 (:add (add-project (cdr remaining-args)))
73 (:show (show-project (cdr remaining-args)))
74 (:refresh (refresh-project (cdr remaining-args)))
75 (:list (list-projects))
76 (:failures (project-failures (cdr remaining-args)))
77 (t (format t "~A" (project-usage)))))))
79 (defun project-usage ()
83 "Interacts with projects. The available project subcommands are:
84 list List all projects
85 add <name>:<src> Add a project
86 delete <name> Delete a project
87 show <name> Show project branch information
88 refresh <name> Tell the candle server to refresh the project information"))
90 (defun project-options ()
91 '((:name :help :short "h" :long "help" :description "Print this usage.")
92 (:positional "<subcommand>" :description "Project subcommand, see below.")))
94 (defun add-project (args)
97 '((:name :help :short "h" :long "help" :description "Print this usage.")
98 (:positional "<name>:<src>" :description "<name> is the name of the project, which must be alphanumeric (hyphens are allowed), while <src> is the location of the repository for cloning. This location must be accessible by the machine running candle."))))
99 (standard-cli "candle project add" options args :default "<name>:<src>"
101 ((project-definition (car remaining-args))
102 (pos (position #\: project-definition)))
104 ((not pos) (format *error-output* "Project definition ~A is not valid. See 'candle project --help'.~%" project-definition))
107 ((name (subseq project-definition 0 pos))
108 (src (subseq project-definition (1+ pos))))
109 (communication:query `(candle:add-project ,name ,src))
110 (format t "Added project ~A at src definition ~A~%" name src))))))))
112 (defun delete-project (args)
115 '((:name :help :short "h" :long "help" :description "Print this usage.")
116 (:positional "<name>" :description "<name> is the name of the project to delete"))))
117 (standard-cli "candle project delete" options args :default "<name>"
118 (communication:query `(candle:delete-project ,(car remaining-args)))
119 (format t "Removed project ~A~%" (car remaining-args)))))
121 (defun show-project (args)
124 '((:name :help :short "h" :long "help" :description "Print this usage.")
125 (:positional "<name>" :description "<name> is the name of the project to show"))))
126 (standard-cli "candle project show" options args :default "<name>"
128 ((branch-infos (communication:query `(candle:project-branch-information ,(car remaining-args))))
129 (width (apply #'max (mapcar #'length (mapcar #'car branch-infos)))))
131 (lambda (branch-info)
132 (format t (format nil "~~~A@A: ~~A~~%" width)
134 (job-info->line (second branch-info))))
135 (sort branch-infos #'< :key (lambda (branch-info) (third (second branch-info)))))))))
137 (defun refresh-project (args)
140 '((:name :help :short "h" :long "help" :description "Print this usage.")
141 (:positional "<name>" :description "<name> is the name of the project to refresh"))))
142 (standard-cli "candle project refresh" options args :default "<name>"
143 (communication:query `(candle:refresh-project ,(car remaining-args)))
144 (format t "Refreshed project ~A~%" (car remaining-args)))))
146 (defun list-projects ()
147 (format t "~{~{~A ~A~}~%~}" (communication:query `(candle:list-projects))))
149 (defun project-failures (args)
152 '((:name :help :short "h" :long "help" :description "Print this usage.")
153 (:name :project :long "project" :variable-name "PROJECT" :takes-argument t :description "Restrict failures to project named by PROJECT"))))
154 (standard-cli "candle project failures" options args :default nil
157 `(candle:failures ,(when (opera:option-present :project parsed-options) (opera:option-argument :project parsed-options))))))))
159 ;;; Section for ./candle job
161 (defmethod execute-command ((command (eql :job)) args)
162 (multiple-value-bind (options remaining-args error) (opera:process-arguments (job-options) args)
164 ((eql error :unknown-option) (format *error-output* "Unknown option: ~A. See 'candle job --help'.~%" (car remaining-args)))
165 ((eql error :required-argument-missing) (format *error-output* "Missing argument for ~A. See 'candle job --help'.~%" (car remaining-args)))
166 ((opera:option-present :help options) (format t "~A" (opera:usage "candle job" (job-options) "Lists all jobs in PROJECT if no other action is specified")))
167 ((not (opera:option-present :project-name options)) (format *error-output* "Requires --project argument. See 'candle job --help'.~%" ))
168 ((opera:option-present :log options) (job-log (opera:option-argument :project-name options) (opera:option-argument :log options)))
169 (t (project-history (opera:option-argument :project-name options))))))
171 (defun job-options ()
172 '((:name :help :short "h" :long "help" :description "Print this usage.")
173 (:name :project-name :long "project" :takes-argument t
174 :variable-name "PROJECT"
175 :description "The project name for the jobs under consideration. Required argumnet.")
176 (:name :log :long "log" :takes-argument t
178 :description "Show's the processing log for job at sha SHA. SHA can be truncated.")))
180 (defun project-history (name)
184 (sort (communication:query `(candle:project-job-information ,name)) #'< :key #'third))))
186 (defun job-log (project-name sha)
187 (format t "~A~%" (communication:query `(candle:get-job-log ,project-name ,sha))))
189 ;;; Section for ./candle run
191 (defmethod execute-command ((command (eql :run)) args)
193 ((options '((:name :help :short "h" :long "help" :description "Print this usage."))))
194 (standard-cli "run" options args :default nil
195 (when (not (candle:run)) (sb-ext:exit :code 1)))))