Add project listing
[candle] / src / main / cli.lisp
1 (in-package #:candle-cli)
2
3 (defgeneric execute-command (command args))
4
5 (defmethod execute-command (command args)
6  (format *error-output* "Unknown command '~(~A~)'.  See 'candle --help'.~%" command))
7
8 (defun job-info->line (job-info)
9  (format nil "~A (~A) ~A"
10   (subseq (first job-info) 0 8)
11   (format nil "~{~A/~A/~A ~A:~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))
16    (:queued "In queue")
17    (:no-candle-file "No candle file present")
18    (:in-progress "In progress"))))
19
20 ;;; Section for ./candle
21
22 (defun run ()
23  (multiple-value-bind (options remaining-args error) (opera:process-arguments (main-options) (cdr sb-ext:*posix-argv*))
24   (cond
25    ((opera:option-present :help options) (main-usage))
26    ((eql error :unknown-option) (format *error-output* "Unknown option: ~A.  See 'candle --help'.~%" (car remaining-args)))
27    ((and (opera:option-present :port options) (not (parse-integer (opera:option-argument :port options) :junk-allowed t)))
28     (format *error-output* "--port requires a number.  See 'candle-server -h'~%"))
29    ((not remaining-args) (format *error-output* "Command required.  See 'candle --help'.~%"))
30    (t
31     (let
32      ((communication:*query-port*
33        (or
34         (and
35          (opera:option-present :port options)
36          (parse-integer (opera:option-argument :port options) :junk-allowed t))
37         25004)))
38      (execute-command (intern (string-upcase (car remaining-args)) :keyword) (cdr remaining-args)))))))
39
40 (defun main-options ()
41  '((:name :help :short "h" :long "help" :description "Print this usage.")
42    (:name :port :short "p" :long "port" :takes-argument t :variable-name "PORT"
43     :description "Port on which to listen for commands.  Defaults to 25004")
44    (:positional "<command>" :required t :description "Command for candle, see below")))
45
46 (defun main-usage ()
47  (format t "~A"
48   (opera:usage
49    "candle"
50    (main-options)
51    "Interacts with candle server.  The available commands are:
52   project   Interact with projects
53   job       Get information about jobs
54   run       Local command.  Run candle in the current working directory")))
55
56 ;;; Section for ./candle project
57
58 (defmethod execute-command ((command (eql :project)) args)
59  (multiple-value-bind (options remaining-args error) (opera:process-arguments (project-options) args)
60   (cond
61    ((eql error :unknown-option)
62     (format *error-output* "Unknown option: ~A.  See 'candle project --help'.~%" (car remaining-args)))
63    ((eql error :required-argument-missing)
64     (format *error-output* "Missing argument for ~A.  See 'candle project --help'.~%" (car remaining-args)))
65    ((opera:option-present :help options) (project-usage))
66    (t
67     (let
68      ((subcommand (intern (string-upcase (car remaining-args)) :keyword)))
69      (case subcommand
70       (:delete (delete-project (cdr remaining-args)))
71       (:add (add-project (cdr remaining-args)))
72       (:show (show-project (cdr remaining-args)))
73       (:refresh (refresh-project (cdr remaining-args)))
74       (:list (list-projects))
75       (t (project-usage))))))))
76
77 (defun project-usage ()
78  (format t "~A"
79   (opera:usage
80    "candle project"
81    (project-options)
82    "Interacts with projects.  The available project subcommands are:
83   list              List all projects
84   add <name>:<src>  Add a project
85   delete <name>     Delete a project
86   show <name>       Show project branch information
87   refresh <name>    Tell the candle server to refresh the project information")))
88
89 (defun project-options ()
90  '((:name :help :short "h" :long "help" :description "Print this usage.")
91    (:positional "<subcommand>" :description "Project subcommand, see below.")))
92
93 (defun add-project (args)
94  (let*
95   ((options
96    '((:name :help :short "h" :long "help" :description "Print this usage.")
97      (: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.")))
98     (usage (opera:usage "candle project add" options)))
99   (multiple-value-bind (options remaining-args error) (opera:process-arguments options args)
100    (cond
101     ((eql error :unknown-option) (format *error-output* "Unknown option: ~A.  See 'candle project add --help'.~%" (car remaining-args)))
102     ((eql error :required-argument-missing) (format *error-output* "Missing argument for ~A.  See 'candle project add --help'.~%" (car remaining-args)))
103     ((opera:option-present :help options) (format t "~A" usage))
104     ((not remaining-args) (format *error-output* "Required <name>:<src>.  See 'candle project add --help'.~%"))
105     (t
106      (let*
107       ((project-definition (car remaining-args))
108        (pos (position #\: project-definition)))
109       (cond
110        ((not pos) (format *error-output* "Project definition ~A is not valid.  See 'candle project --help'.~%" project-definition))
111        (t
112         (let*
113          ((name (subseq project-definition 0 pos))
114           (src (subseq project-definition (1+ pos))))
115          (communication:query `(candle:add-project ,name ,src))
116          (format t "Added project ~A at src definition ~A~%" name src))))))))))
117
118 (defun delete-project (args)
119  (let*
120   ((options
121    '((:name :help :short "h" :long "help" :description "Print this usage.")
122      (:positional "<name>" :description "<name> is the name of the project to delete")))
123     (usage (opera:usage "candle project delete" options)))
124   (multiple-value-bind (options remaining-args error) (opera:process-arguments options args)
125    (cond
126     ((eql error :unknown-option) (format *error-output* "Unknown option: ~A.  See 'candle project delete --help'.~%" (car remaining-args)))
127     ((eql error :required-argument-missing) (format *error-output* "Missing argument for ~A.  See 'candle project delete --help'.~%" (car remaining-args)))
128     ((opera:option-present :help options) (format t "~A" usage))
129     ((not remaining-args) (format *error-output* "Required <name>.  See 'candle project delete --help'.~%"))
130     (t
131      (communication:query `(candle:delete-project ,(car remaining-args)))
132      (format t "Removed project ~A~%" (car remaining-args)))))))
133
134 (defun show-project (args)
135  (let*
136   ((options
137    '((:name :help :short "h" :long "help" :description "Print this usage.")
138      (:positional "<name>" :description "<name> is the name of the project to show")))
139     (usage (opera:usage "candle project delete" options)))
140   (multiple-value-bind (options remaining-args error) (opera:process-arguments options args)
141    (cond
142     ((eql error :unknown-option) (format *error-output* "Unknown option: ~A.  See 'candle project show --help'.~%" (car remaining-args)))
143     ((eql error :required-argument-missing) (format *error-output* "Missing argument for ~A.  See 'candle project show --help'.~%" (car remaining-args)))
144     ((opera:option-present :help options) (format t "~A" usage))
145     ((not remaining-args) (format *error-output* "Required <name>.  See 'candle project show --help'.~%"))
146     (t
147      (let*
148       ((branch-infos (communication:query `(candle:project-branch-information ,(car remaining-args))))
149        (width (apply #'max (mapcar #'length (mapcar #'car branch-infos)))))
150       (mapcar
151        (lambda (branch-info)
152         (format t (format nil "~~~A@A: ~~A~~%" width)
153          (first branch-info)
154          (job-info->line (second branch-info))))
155        (sort branch-infos #'< :key (lambda (branch-info) (third (second branch-info)))))))))))
156
157 (defun refresh-project (args)
158  (let*
159   ((options
160    '((:name :help :short "h" :long "help" :description "Print this usage.")
161      (:positional "<name>" :description "<name> is the name of the project to refresh")))
162     (usage (opera:usage "candle project refresh" options)))
163   (multiple-value-bind (options remaining-args error) (opera:process-arguments options args)
164    (cond
165     ((eql error :unknown-option) (format *error-output* "Unknown option: ~A.  See 'candle project refresh --help'.~%" (car remaining-args)))
166     ((eql error :required-argument-missing) (format *error-output* "Missing argument for ~A.  See 'candle project refresh --help'.~%" (car remaining-args)))
167     ((opera:option-present :help options) (format t "~A" usage))
168     ((not remaining-args) (format *error-output* "Required <name>.  See 'candle project refresh --help'.~%"))
169     (t
170      (communication:query `(candle:refresh-project ,(car remaining-args)))
171      (format t "Refreshed project ~A~%" (car remaining-args)))))))
172
173 (defun list-projects ()
174  (format t "~{~{~A  ~A~}~%~}" (communication:query `(candle:list-projects))))
175
176 ;;; Section for ./candle job
177
178 (defmethod execute-command ((command (eql :job)) args)
179  (multiple-value-bind (options remaining-args error) (opera:process-arguments (job-options) args)
180   (cond
181    ((eql error :unknown-option) (format *error-output* "Unknown option: ~A.  See 'candle job --help'.~%" (car remaining-args)))
182    ((eql error :required-argument-missing) (format *error-output* "Missing argument for ~A.  See 'candle job --help'.~%" (car remaining-args)))
183    ((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")))
184    ((not (opera:option-present :project-name options)) (format *error-output* "Requires --project argument.  See 'candle job --help'.~%" ))
185    ((opera:option-present :log options) (job-log (opera:option-argument :project-name options) (opera:option-argument :log options)))
186    (t (project-history (opera:option-argument :project-name options))))))
187
188 (defun job-options ()
189  '((:name :help :short "h" :long "help" :description "Print this usage.")
190    (:name :project-name :long "project" :takes-argument t
191     :variable-name "PROJECT"
192     :description "The project name for the jobs under consideration.  Required argumnet.")
193    (:name :log :long "log" :takes-argument t
194     :variable-name "SHA"
195     :description "Show's the processing log for job at sha SHA.  SHA can be truncated.")))
196
197 (defun project-history (name)
198  (format t "~{~A~%~}"
199   (mapcar
200    #'job-info->line
201    (sort (communication:query `(candle:project-job-information ,name)) #'< :key #'third))))
202
203 (defun job-log (project-name sha)
204  (format t "~A~%" (communication:query `(candle:get-job-log ,project-name ,sha))))
205
206 ;;; Section for ./candle run
207
208 (defmethod execute-command ((command (eql :run)) args)
209  (multiple-value-bind (options remaining-args error) (opera:process-arguments (run-options) args)
210   (cond
211    ((eql error :unknown-option) (format *error-output* "Unknown option: ~A.  See 'candle run --help'.~%" (car remaining-args)))
212    ((eql error :required-argument-missing) (format *error-output* "Missing argument for ~A.  See 'candle run --help'.~%" (car remaining-args)))
213    (remaining-args (format *error-output* "Unknown option: ~A. See 'candle run --help'.~%" (car remaining-args)))
214    ((opera:option-present :help options) (format t "~A" (opera:usage "candle run" (run-options))))
215    ((not (candle:run)) (sb-ext:exit :code 1)))))
216
217 (defun run-options ()
218  '((:name :help :short "h" :long "help" :description "Print this usage.")))