Rose Bush utility migration to cylc: incoming

ACKNOWLEDGEMENT.md

@@ -19,3 +19,23 @@ Licences for non-cylc work included in this distribution can be found in the
     External software released under the LGPL license.
     Modifications based on version 0.6. See
     [xdot](https://github.com/jrfonseca/xdot.py)
+ * `lib/cylc/cylc-review/static/css/bootstrap-???`,
+   `lib/cylc/cylc-review/static/images/glyphicons-halflings-???` &
+   `lib/cylc/cylc-review/static/js/bootstrap.min.js`:
+    Unmodified external software library copyright 2013 Twitter Inc released
+    under the Apache 2.0 license. See [Bootstrap](http://getbootstrap.com/).
+ * `lib/cylc/cylc-review/static/css/cylc-review.css`:
+    Contains modified code from Twitter Bootstrap v2.3.1 released under the
+    Apache 2.0 licence. See
+    [Bootstrap v.2.3.1](http://getbootstrap.com/2.3.1/).
+ * `lib/cylc/cylc-review/static/css/jquery.dataTables.???`,
+   `lib/cylc/cylc-review/static/images/sort_???` &
+   `lib/cylc/cylc-review/static/js/jquery.dataTables.???`:
+    Unmodified external software library released under GPLv2 and BSD. See
+    [DataTables](http://www.datatables.net/).
+ * `lib/cylc/cylc-review/static/js/livestamp.min.js`:
+    Unmodified external software library released under the MIT license. See
+    [Livestamp.js](http://mattbradley.github.io/livestampjs/).
+ * `lib/cylc/cylc-review/static/js/moment.min.js`:
+    Unmodified external software library released under the MIT license. See
+    [Moment.js](http://momentjs.com/).

bin/cylc-help

@@ -239,6 +239,7 @@ information_commands['get-suite-contact'] = [
     'get-suite-contact', 'get-contact', 'print-contact']
 information_commands['get-suite-version'] = [
     'get-suite-version', 'get-cylc-version']
+information_commands['review'] = ['review']
 
 information_commands['documentation'] = ['documentation', 'browse']
 information_commands['monitor'] = ['monitor']
@@ -394,6 +395,7 @@ comsum['get-suite-contact'] = (
 comsum['get-suite-version'] = 'Print cylc version of a suite server program'
 comsum['gscan'] = 'Scan GUI for monitoring multiple suites'
 comsum['gpanel'] = 'Internal interface for GNOME 2 panel applet'
+comsum['review'] = 'Start/stop ad-hoc Cylc Review web service server.'
 # control
 comsum['gui'] = '(a.k.a. gcylc) cylc GUI for suite control etc.'
 comsum['run'] = 'Start a suite at a given cycle point'

bin/cylc-review

@@ -0,0 +1,50 @@
+#!/usr/bin/env python2
+
+# THIS FILE IS PART OF THE CYLC SUITE ENGINE.
+# Copyright (C) 2008-2018 NIWA & British Crown (Met Office) & Contributors.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+"""cylc [info] review [OPTIONS] ARGS
+
+Start/stop ad-hoc Cylc Review web service server for browsing users' suite
+logs via an HTTP interface.
+
+With no arguments, the status of the ad-hoc web service server is printed.
+
+For 'cylc review start', if 'PORT' is not specified, port 8080 is used."""
+
+
+import sys
+
+import cylc.flags
+from cylc.review import CylcReviewService
+
+
+def main():
+    from cylc.ws import ws_cli
+    ws_cli(CylcReviewService, __doc__)
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except Exception as exc:
+        if cylc.flags.debug:
+            raise
+        sys.exit(str(exc))
+elif 'doctest' not in sys.argv[0]:
+    # If called as a module but not by the doctest module.
+    from cylc.ws import wsgi_app
+    application = wsgi_app(CylcReviewService)

lib/cylc/cylc-review/static/css/cylc-review.css

@@ -0,0 +1,115 @@
+pre {
+    white-space: pre;
+}
+.entry {
+    border-radius: 5px;
+    padding: 5px;
+}
+.even {
+    background: #eee;
+}
+.inline {
+    margin: 0;
+}
+.page-header {
+    padding-left: 10px;
+    padding-right: 10px;
+}
+.highlight {
+    background-color: yellow;
+}
+.line-number {
+    cursor: pointer;
+}
+.badge-label {
+    border-radius: 1em;
+}
+
+
+@media screen {
+    div.top_nav {
+        position: fixed;
+        bottom: 0;
+        background-color: lightgrey;
+        z-index: 10;
+     }
+    .next {
+        background: white
+     }
+    .previous {
+        background: white
+     }
+    .page_entries select {
+        width: 300px;
+     }
+}
+
+
+/* dropdown-submenu code from bootstrap v2.3.1 (removed in v3.x)
+   see boostrap v2.3.1 docs/assets/css/boostrap.css #3031->3075 */
+.dropdown-submenu {
+  position: relative;
+}
+
+.dropdown-submenu > .dropdown-menu {
+  top: 0;
+  left: 100%;
+  margin-top: -6px;
+  margin-left: -1px;
+  -webkit-border-radius: 0 6px 6px 6px;
+     -moz-border-radius: 0 6px 6px 6px;
+          border-radius: 0 6px 6px 6px;
+}
+
+.dropdown-submenu:hover > .dropdown-menu {
+  display: block;
+}
+
+.dropup .dropdown-submenu > .dropdown-menu {
+  top: auto;
+  bottom: 0;
+  margin-top: 0;
+  margin-bottom: -2px;
+  -webkit-border-radius: 5px 5px 5px 0;
+     -moz-border-radius: 5px 5px 5px 0;
+          border-radius: 5px 5px 5px 0;
+}
+
+.dropdown-submenu > a:after {
+  display: block;
+  float: right;
+  width: 0;
+  height: 0;
+  margin-top: 5px;
+  margin-right: -10px;
+  border-color: transparent;
+  border-left-color: #cccccc;
+  border-style: solid;
+  border-width: 5px 0 5px 5px;
+  content: " ";
+}
+
+.dropdown-submenu:hover > a:after {
+  border-left-color: #222222;  /* make the right arrow visible on hover */
+}
+
+.dropdown-submenu.pull-left {
+  float: none;
+}
+
+.dropdown-submenu.pull-left > .dropdown-menu {
+  left: -100%;
+  margin-left: 10px;
+  -webkit-border-radius: 6px 0 6px 6px;
+     -moz-border-radius: 6px 0 6px 6px;
+          border-radius: 6px 0 6px 6px;
+}
+
+@-moz-document url-prefix() {
+  fieldset { display: table-cell; }
+}
+
+th,
+.livestamp {
+  white-space: nowrap;
+}