pywebexec 2.1.18__tar.gz → 2.2.0__tar.gz

{pywebexec-2.1.18/pywebexec.egg-info → pywebexec-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: pywebexec
-Version: 2.1.18
+Version: 2.2.0
 Summary: Simple Python HTTP Exec Server
 Home-page: https://github.com/joknarf/pywebexec
 Author: Franck Jouvanceau

{pywebexec-2.1.18 → pywebexec-2.2.0}/pywebexec/pywebexec.py

@@ -1038,15 +1038,12 @@ def swagger_yaml():
         swagger_spec = yaml.safe_load(swagger_spec_str)
         # Update existing POST /commands enum if present
         executables = get_executables()
-        post_cmd = swagger_spec.get('paths', {}).get('/commands', {}).get('post')
-        if post_cmd:
-            params_list = post_cmd.get('parameters', [])
-            for param in params_list:
-                if param.get('in') == 'body' and 'schema' in param:
-                    props = param['schema'].get('properties', {})
-                    if 'command' in props:
-                        props['command']['enum'] = [e['command'] for e in executables]
-        # Add dynamic paths for each 
+        post_cmd = swagger_spec.get('paths', {}).get('/commands', {}).get('post', {})
+        if post_cmd and 'requestBody' in post_cmd:
+            schema = post_cmd['requestBody'].get('content', {}).get('application/json', {}).get('schema', {})
+            if 'properties' in schema and 'command' in schema['properties']:
+                schema['properties']['command']['enum'] = [e['command'] for e in executables]
+
         # Add dynamic paths for each executable:
         for exe in executables:
             dynamic_path = "/commands/" + exe["command"]
@@ -1065,28 +1062,32 @@ def swagger_yaml():
                     "parallel": {"type": "integer", "description": 'nb parallel jobs', "default": 1, "required": True, "minimum": 1, "maximum": 100},
                     "delay": {"type": "number", "description": "initial delay in s between jobs", "default": 10, "required": True, "minimum": 0, "maximum": 600},
                   })
+
             swagger_spec.setdefault("paths", {})[dynamic_path] = {
                 "post": {
                     "summary": f"Run command {exe['command']}",
                     "tags": ["run_commands"],
                     "description": f"{exe['help']}",
-                    "consumes": ["application/json"],
-                    "produces": ["application/json"],
-                    "parameters": [
-                        {
-                            "in": "body",
-                            "name": "requestBody",
-                            "schema": cmd_schema
+                    "requestBody": {
+                        "required": True,
+                        "content": {
+                            "application/json": {
+                                "schema": cmd_schema
+                            }
                         }
-                    ],
+                    },
                     "responses": {
                         "200": {
                             "description": "Command started",
-                            "schema": {
-                                "type": "object",
-                                "properties": {
-                                    "message": {"type": "string"},
-                                    "command_id": {"type": "string"}
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "type": "object",
+                                        "properties": {
+                                            "message": {"type": "string"},
+                                            "command_id": {"type": "string"}
+                                        }
+                                    }
                                 }
                             }
                         }

{pywebexec-2.1.18 → pywebexec-2.2.0}/pywebexec/static/css/markdown.css

@@ -1,5 +1,5 @@
 
-.markdown, .swagger-ui .markdown {
+.markdown, .swagger-ui .markdown, .swagger-ui .renderedMarkdown {
     /* background-color: #e0e0ff; */
     border: 1px solid #ccc;
     padding: 0px 8px 8px 8px;

{pywebexec-2.1.18 → pywebexec-2.2.0}/pywebexec/static/css/style.css

@@ -449,6 +449,7 @@ body.dimmed * {
 .command-line:hover {
     text-overflow: unset;
     max-width: unset;
+    white-space: pre;
 }
 .nbrunning {
     display: inline-block;

{pywebexec-2.1.18 → pywebexec-2.2.0}/pywebexec/static/js/executables.js

@@ -301,7 +301,7 @@ paramsInput.addEventListener('focus', () => {
                     console.log('Error running command:', error);
                 }
             }
-        }, currentCmd.toString());
+        }, currentCmd);
         setHelpDivPosition();
         paramsContainer.style.display = 'block';
         const input1 = schemaFormPW.querySelector('input, select, textarea');

{pywebexec-2.1.18 → pywebexec-2.2.0}/pywebexec/static/js/popup.js

@@ -1,6 +1,6 @@
 const maxScrollback = 99999;
 const maxSize = 10485760; // 10MB
-let fontSize = 14;
+let fontSize = +localStorage.getItem('popupFontSize') || 14;
 let terminal = new Terminal({
     cursorBlink: false,
     cursorInactiveStyle: 'none',
@@ -75,8 +75,8 @@ let slider = null;
 let isPaused = false;
 let cols = 0;
 let rows = 0;
-let fitWindow = false;
-
+let fitWindow = localStorage.getItem('popupFitWindow') === 'false' ? false : true;
+console.log(localStorage.getItem('popupFitWindow'));
 const toggleButton = document.getElementById('toggleFetch');
 const pausedMessage = document.getElementById('pausedMessage');
 const toggleFitButton = document.getElementById('toggleFit');
@@ -169,9 +169,13 @@ async function viewOutput(command_id) {
         }
         const data = await response.json();
         const commandInfo = document.getElementById('commandInfo');
-        const command = `${data.command.replace(/^\.\//, '')} ${data.params.join(' ')}`;
+        if (data.command.endsWith('/run-para')) {
+            command = `${data.params.join(' ').replace(/^.* -- run .\//, 'batch ')}`;
+        } else {
+            command = `${data.command.replace(/^\.\//, '')} ${data.params.join(' ')}`;
+        }
         setCommandStatus(data.status);
-        commandInfo.innerText = command;
+        commandInfo.innerHTML = command;
         commandInfo.setAttribute('title', command);
         document.title = `${data.command} ${data.params.join(' ')} - [${data.status}]`;
         if (data.command == 'term')
@@ -232,21 +236,31 @@ function toggleFetchOutput() {
     }
     isPaused = !isPaused;
 }
-function toggleFit() {
-    fitWindow = ! fitWindow;
+function setFitIcon()
+{
+    console.log(fitWindow);
     if (fitWindow) {
+        toggleFitButton.classList.remove('fit-window');
         toggleFitButton.classList.add('fit-tty');
         toggleFitButton.setAttribute('title', 'terminal fit tty');
     } else {
         toggleFitButton.classList.remove('fit-tty');
+        toggleFitButton.classList.add('fit-window');
         toggleFitButton.setAttribute('title', 'terminal fit window');
-    }
+    }     
+}
+
+function toggleFit() {
+    fitWindow = ! fitWindow;
+    setFitIcon();
+    localStorage.setItem('popupFitWindow', fitWindow);
     autoFit();
     viewOutput(currentCommandId);
 }
 
 toggleButton.addEventListener('click', toggleFetchOutput);
 toggleFitButton.addEventListener('click', toggleFit);
+setFitIcon();
 window.addEventListener('resize', adjustOutputHeight);
 window.addEventListener('load', () => {
     slider = document.getElementById('outputSlider');
@@ -259,11 +273,13 @@ window.addEventListener('load', () => {
 document.getElementById('decreaseFontSize').addEventListener('click', () => {
     fontSize = Math.max(8, fontSize - 1);
     terminal.options.fontSize = fontSize;
+    localStorage.setItem('popupFontSize', fontSize);
     autoFit();
 });
 
 document.getElementById('increaseFontSize').addEventListener('click', () => {
     fontSize = Math.min(32, fontSize + 1);
     terminal.options.fontSize = fontSize;
+    localStorage.setItem('popupFontSize', fontSize);
     autoFit();
 });

{pywebexec-2.1.18 → pywebexec-2.2.0}/pywebexec/static/js/schemaform.js

@@ -11,7 +11,7 @@ function adjustInputWidth(input) {
 function formInputHandle() {
   schemaForm.querySelectorAll('input[type="text"], input[type="number"]').forEach(input => {
     if (! inputHandlers.includes(input)) {
-      val = input.value || input.placeholder;
+      val = input.placeholder;
       if (val) {
         size = Math.max(val.length, 2)
         if (input.type== 'number') {
@@ -35,16 +35,17 @@ function extractKeysAndPlaceholders(obj, formoptions, prefix = '') {
     let result = [];
   
     for (let key in obj.properties) {
+      k = prefix ? `${prefix}.${key}` : key;
       if (obj.properties[key].type === 'object' && obj.properties[key].properties) {
-        result = result.concat(extractKeysAndPlaceholders(obj.properties[key], formoptions, prefix ? `${prefix}.${key}` : key));
+        result = result.concat(extractKeysAndPlaceholders(obj.properties[key], formoptions, k));
       } else {
-        if (formoptions[`${prefix}.${key}`]) {
-          foptions = formoptions[`${prefix}.${key}`];
+        if (formoptions[k]) {
+          foptions = formoptions[k];
         } else {
           foptions = {};
         }
         result.push({
-          key: prefix ? `${prefix}.${key}` : key,
+          key: k,
           placeholder: obj.properties[key].example || null,
           ... foptions
         });
@@ -52,7 +53,7 @@ function extractKeysAndPlaceholders(obj, formoptions, prefix = '') {
     }
     return result;
 }
-let schemaValues = {};
+
 function createSchemaForm(form, schema, onSubmit, schemaName) {
   if (schemaValues[schemaName]) {
     value = schemaValues[schemaName];
@@ -167,16 +168,22 @@ function createSchemaForm(form, schema, onSubmit, schemaName) {
     txt.setAttribute("spellcheck", "false");
     txt.addEventListener("input", () => adjustTxtHeight(txt));
   });
+
   form[0].addEventListener('input', () => {
     schemaValues[schemaName] = jsform.root.getFormValues();
-    // localStorage.setItem('schemaValues', JSON.stringify(schemaValues));
+    localStorage.setItem('schemaValues', JSON.stringify(schemaValues));
   });
   
   return jsform;
 }
 function adjustTxtHeight(txt) {
+  if (txt.value.includes('\n')) {
+    delta = 2;
+  } else {
+    delta = 0;
+  }
   txt.style.height = "0";
-  txt.style.height = txt.scrollHeight + "px";
+  txt.style.height = `${txt.scrollHeight+delta}px`;
 }
 async function getSwaggerSpec() {
   const response = await fetch('/swagger.yaml');
@@ -209,5 +216,6 @@ async function getPostParametersSchema() {
 
 let schemaForm;
 let inputHandlers = [];
+let schemaValues = JSON.parse(localStorage.getItem('schemaValues')) || {};
 
 

{pywebexec-2.1.18 → pywebexec-2.2.0}/pywebexec/static/js/script.js

@@ -7,11 +7,11 @@ let fullOutput = '';
 let outputLength = 0;
 const maxScrollback = 99999;
 const maxSize = 10485760; // 10MB
-let fontSize = 14;
+let fontSize = +localStorage.getItem('fontSize') || 14;
 let isPaused = false;
 let showRunningOnly = false;
 let hiddenCommandIds = [];
-let fitWindow = false;
+let fitWindow = localStorage.getItem('fitWindow') === 'false' ? false : true;
 let cols = 0;
 let rows = 0;
 
@@ -260,7 +260,12 @@ async function viewOutput(command_id) {
         }
         const data = await response.json();
         const commandInfo = document.getElementById('commandInfo');
-        const command = `${data.command.replace(/^\.\//, '')} ${data.params.join(' ')}`;
+        if (data.command.endsWith('/run-para')) {
+            command = `${data.params.join(' ').replace(/^.* -- run .\//, 'batch ')}`;
+        } else {
+            command = `${data.command.replace(/^\.\//, '')} ${data.params.join(' ')}`;
+        }
+        console.log(command);
         setCommandStatus(data.status)
         commandInfo.innerHTML = command;
         commandInfo.setAttribute('title', command);
@@ -415,12 +420,14 @@ slider.addEventListener('input', sliderUpdateOutput);
 document.getElementById('decreaseFontSize').addEventListener('click', () => {
     fontSize = Math.max(8, fontSize - 1);
     terminal.options.fontSize = fontSize;
+    localStorage.setItem('fontSize', fontSize);
     autoFit();
 });
 
 document.getElementById('increaseFontSize').addEventListener('click', () => {
     fontSize = Math.min(32, fontSize + 1);
     terminal.options.fontSize = fontSize;
+    localStorage.setItem('fontSize', fontSize);
     autoFit();
 });
 
@@ -451,21 +458,31 @@ function toggleFetchOutput() {
     }
     isPaused = !isPaused;
 }
-function toggleFit() {
-    fitWindow = ! fitWindow;
+
+function setFitIcon()
+{
     if (fitWindow) {
+        toggleFitButton.classList.remove('fit-window');
         toggleFitButton.classList.add('fit-tty');
         toggleFitButton.setAttribute('title', 'terminal fit tty');
     } else {
         toggleFitButton.classList.remove('fit-tty');
+        toggleFitButton.classList.add('fit-window');
         toggleFitButton.setAttribute('title', 'terminal fit window');
-    }
+    }     
+}
+
+function toggleFit() {
+    fitWindow = ! fitWindow;
+    setFitIcon();
+    localStorage.setItem('fitWindow', fitWindow);
     autoFit();
     viewOutput(currentCommandId);
 }
 
 toggleButton.addEventListener('click', toggleFetchOutput);
 toggleFitButton.addEventListener('click', toggleFit);
+setFitIcon();
 
 document.getElementById('thStatus').addEventListener('click', () => {
     showRunningOnly = !showRunningOnly;

{pywebexec-2.1.18 → pywebexec-2.2.0}/pywebexec/static/js/swagger-form.js

@@ -26,6 +26,28 @@ function addFormInputListener(textArea, jsform){
   };
 }
 
+async function getPostParametersSchema() {
+  const swaggerSpec = await getSwaggerSpec();
+  const result = {};
+  for (const path in swaggerSpec.paths) {
+    const pathItem = swaggerSpec.paths[path];
+    if (pathItem.post) {
+      const postDef = pathItem.post;
+      // Look for requestBody with JSON schema in OpenAPI 3.0
+      if (postDef.requestBody && postDef.requestBody.content && postDef.requestBody.content['application/json']) {
+        result[path] = postDef.requestBody.content['application/json'].schema;
+      } else {
+        result[path] = null;
+      }
+    }
+  }
+  return result;
+}
+function adjustTxtHeight2(paramtext) {
+  paramtext.style.height = "0";
+  paramtext.style.height = `${paramtext.scrollHeight+2}px`;
+}
+
 window.onload = function() {
   ui = SwaggerUIBundle({
     url: "/swagger.yaml",
@@ -69,29 +91,25 @@ window.onload = function() {
   const observer = new MutationObserver((mutations) => {
     mutations.forEach(mutation => {
       mutation.addedNodes.forEach(node => {
-        if (node.classList && (node.classList.contains("highlight-code") ||
-          node.classList.contains("body-param__text"))) {
-          // Retrieve the data-path attribute from the first opblock-summary-path element
-          const routePath = $(node).closest('.opblock').find('.opblock-summary-path').first().attr('data-path');
-          const routePathId = `schemaForm${routePath.replaceAll("/", "_")}`;
-          const prevForm = node.parentNode.querySelector(`#${routePathId}`)
-          if (prevForm) {
-            prevForm.remove();
-          }
-          if (node.classList.contains("body-param__text")) {
-            node.addEventListener("input", (e) => {
-              e.target.style.height = "0"
-              e.target.style.height = e.target.scrollHeight + "px";
-            });
-            node.style.height = "0"
-            node.style.height = node.scrollHeight + "px";
+        if (node.nodeType === Node.ELEMENT_NODE) {
+          const paramtext = node.querySelector(".body-param__text");
+          if (paramtext) {
+            // Retrieve the data-path attribute from the first opblock-summary-path element
+            const routePath = $(node).closest('.opblock').find('.opblock-summary-path').first().attr('data-path');
+            const routePathId = `schemaForm${routePath.replaceAll("/", "_")}`;
+            const prevForm = paramtext.parentNode.querySelector(`#${routePathId}`)
+            if (prevForm) {
+              prevForm.remove();
+            }
+            paramtext.addEventListener("input", () => adjustTxtHeight2(paramtext));
+            setTimeout(() => adjustTxtHeight2(paramtext), 100);
             const form = document.createElement("form");
             form.id = routePathId;
             form.classList.add("schema-form");
             jsform = createSchemaForm($(form), swaggerSchemas[routePath], null, routePath);
             // form.addEventListener("input", formInput(node, jsform)); 
-            form.addEventListener("input", addFormInputListener(node, jsform));
-            node.parentNode.insertBefore(form, node.nextSibling);
+            form.addEventListener("input", addFormInputListener(paramtext, jsform));
+            paramtext.parentNode.insertBefore(form, paramtext.nextSibling);
             item1 = form.querySelector("input, select, textarea");
             if (item1) {
               item1.focus();

pywebexec-2.2.0/pywebexec/swagger.yaml

@@ -0,0 +1,278 @@
+openapi: "3.0.0"
+info:
+  title: PyWebExec API
+  version: "1.0"
+paths:
+  /commands:
+    get:
+      summary: "List commands status"
+      tags:
+        - commands
+      responses:
+        "200":
+          description: "List of all commands status"
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  commands:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        command_id:
+                          type: string
+                        command:
+                          type: string
+                        status:
+                          type: string
+                        start_time:
+                          type: string
+                          format: date-time
+                        end_time:
+                          type: string
+                          format: date-time
+                        exit_code:
+                          type: integer
+                        last_output_line:
+                          type: string
+                        user:
+                          type: string
+    post:
+      summary: "Run a command"
+      tags:
+        - commands
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                command:
+                  type: string
+                  description: "Command to run"
+                  # Enum will be added dynamically by the APIs
+                  default: commandName
+                  required: true
+                params:
+                  type: array
+                  description: "Command parameters"
+                  items:
+                    type: string
+                  default: []
+                rows:
+                  type: integer
+                  description: "tty nb rows"
+                  default: 24
+                cols:
+                  type: integer
+                  description: "tty nb columns"
+                  default: 125
+              required:
+                - command
+      responses:
+        "200":
+          description: "Command started"
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  command_id:
+                    type: string
+                  message:
+                    type: string
+
+  /commands/{command_id}:
+    get:
+      summary: "Get command status"
+      tags:
+        - commands
+      parameters:
+        - in: path
+          name: command_id
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: "Command status returned"
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  command_id:
+                    type: string
+                  command:
+                    type: string
+                  params:
+                    type: array
+                    items:
+                      type: string
+                  status:
+                    type: string
+                  start_time:
+                    type: string
+                    format: date-time
+                  end_time:
+                    type: string
+                    format: date-time
+                  exit_code:
+                    type: integer
+                  last_output_line:
+                    type: string
+                  cols:
+                    type: integer
+                  rows:
+                    type: integer
+                  user:
+                    type: string
+                  from:
+                    type: string
+                  pid:
+                    type: integer
+
+  /commands/{command_id}/output:
+    get:
+      summary: "Get command output"
+      tags:
+        - commands
+      parameters:
+        - in: path
+          name: command_id
+          required: true
+          schema:
+            type: string
+        - in: query
+          name: offset
+          schema:
+            type: integer
+            default: 0
+        - in: query
+          name: maxsize
+          schema:
+            type: integer
+            default: 10485760
+        - in: query
+          name: maxlines
+          schema:
+            type: integer
+            default: 5000
+      responses:
+        "200":
+          description: "Command output returned"
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  output:
+                    type: string
+                  status:
+                    type: string
+                  rows:
+                    type: integer
+                  cols:
+                    type: integer
+                  links:
+                    type: object
+                    properties:
+                      next:
+                        type: string
+                        format: uri
+            text/plain:
+              schema:
+                type: string
+
+  /commands/{command_id}/stop:
+    patch:
+      summary: "Stop a running command"
+      tags:
+        - commands
+      parameters:
+        - in: path
+          name: command_id
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: "Command stopped successfully"
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+
+  /commands/{command_id}/run:
+    post:
+      summary: "Relaunch a command"
+      tags:
+        - commands
+      parameters:
+        - in: path
+          name: command_id
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                rows:
+                  type: integer
+                  description: "tty nb rows"
+                  default: 24
+                cols:
+                  type: integer
+                  description: "tty nb columns" 
+                  default: 125
+      responses:
+        "200":
+          description: "Command relaunched"
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                  command_id:
+                    type: string
+
+  /commands/exposed:
+    get:
+      summary: "List available executable commands"
+      tags:
+        - commands
+      responses:
+        "200":
+          description: "List of commands with markdown help"
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  commands:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        command:
+                          type: string
+                        help:
+                          type: string
+              example:
+                commands:
+                  - command: ls
+                    help: "List directory contents \n**params**:\n* `<ls_params>`"
+                  - command: cat
+                    help: "Concatenate and display files \n**params**:\n* `<cat_params>`"

{pywebexec-2.1.18 → pywebexec-2.2.0}/pywebexec/version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '2.1.18'
-__version_tuple__ = version_tuple = (2, 1, 18)
+__version__ = version = '2.2.0'
+__version_tuple__ = version_tuple = (2, 2, 0)

{pywebexec-2.1.18 → pywebexec-2.2.0/pywebexec.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: pywebexec
-Version: 2.1.18
+Version: 2.2.0
 Summary: Simple Python HTTP Exec Server
 Home-page: https://github.com/joknarf/pywebexec
 Author: Franck Jouvanceau

pywebexec-2.1.18/pywebexec/swagger.yaml

@@ -1,258 +0,0 @@
-swagger: "2.0"
-info:
-  title: PyWebExec API
-  version: "1.0"
-paths:
-  /commands:
-    get:
-      summary: "List commands status"
-      tags:
-        - commands
-      responses:
-        "200":
-          description: "List of all commands status"
-          schema:
-            type: object
-            properties:
-              commands:
-                type: array
-                items:
-                  type: object
-                  properties:
-                    command_id:
-                      type: string
-                    command:
-                      type: string
-                    status:
-                      type: string
-                    start_time:
-                      type: string
-                      format: date-time
-                    end_time:
-                      type: string
-                      format: date-time
-                    exit_code:
-                      type: integer
-                    last_output_line:
-                      type: string
-                    user:
-                      type: string
-    post:
-      summary: "Run a command"
-      tags:
-        - commands
-      consumes:
-        - application/json
-      produces:
-        - application/json
-      parameters:
-        - in: body
-          name: requestBody
-          schema:
-            type: object
-            properties:
-              command:
-                type: string
-                description: "Command to run"
-                # Enum will be added dynamically by the APIs
-                default: commandName
-              params:
-                type: array
-                description: "Command parameters"
-                items:
-                  type: string
-                default: []
-              rows:
-                type: integer
-                description: "tty nb rows"
-                default: 24
-              cols:
-                type: integer
-                description: "tty nb columns"
-                default: 125
-            required:
-              - command
-      responses:
-        "200":
-          description: "Command started"
-          schema:
-            type: object
-            properties:
-              command_id:
-                type: string
-              message:
-                type: string
-  /commands/{command_id}:
-    get:
-      summary: "Get command status"
-      tags:
-        - commands
-      parameters:
-        - in: path
-          name: command_id
-          required: true
-          type: string
-      responses:
-        "200":
-          description: "Command status returned"
-          schema:
-            type: object
-            properties:
-              command_id:
-                type: string
-              command:
-                type: string
-              params:
-                type: array
-                items:
-                  type: string
-              status:
-                type: string
-              start_time:
-                type: string
-                format: date-time
-              end_time:
-                type: string
-                format: date-time
-              exit_code:
-                type: integer
-              last_output_line:
-                type: string
-              cols:
-                type: integer
-              rows:
-                type: integer
-              user:
-                type: string
-              from:
-                type: string
-              pid:
-                type: integer
-
-  /commands/{command_id}/output:
-    get:
-      summary: "Get command output"
-      tags:
-        - commands
-      parameters:
-        - in: path
-          name: command_id
-          required: true
-          type: string
-        - in: query
-          name: offset
-          type: integer
-          default: 0
-        - in: query
-          name: maxsize
-          type: integer
-          default: 10485760
-        - in: query
-          name: maxlines
-          type: integer
-          default: 5000
-      consumes:
-        - application/json
-      produces:
-        - application/json
-        - text/plain
-      responses:
-        "200":
-          description: "Command output returned"
-          schema:
-            type: object
-            properties:
-              output:
-                type: string
-              status:
-                type: string
-              rows:
-                type: integer
-              cols:
-                type: integer
-              links:
-                type: object
-                properties:
-                  next:
-                    type: string
-                    format: uri
-  /commands/{command_id}/stop:
-    patch:
-      summary: "Stop a running command"
-      tags:
-        - commands
-      parameters:
-        - in: path
-          name: command_id
-          required: true
-          type: string
-      responses:
-        "200":
-          description: "Command stopped successfully"
-          schema:
-            type: object
-            properties:
-              message:
-                type: string
-  /commands/{command_id}/run:
-    post:
-      summary: "Relaunch a command"
-      tags:
-        - commands
-      parameters:
-        - in: path
-          name: command_id
-          required: true
-          type: string
-        - in: body
-          name: requestBody
-          schema:
-            type: object
-            properties:
-              rows:
-                type: integer
-                description: "tty nb rows"
-                default: 24
-              cols:
-                type: integer
-                description: "tty nb columns" 
-                default: 125
-      responses:
-        "200":
-          description: "Command relaunched"
-          schema:
-            type: object
-            properties:
-              message:
-                type: string
-              command_id:
-                type: string
-  /commands/exposed:
-    get:
-      summary: "List available executable commands"
-      tags:
-        - commands
-      produces:
-        - application/json
-      responses:
-        "200":
-          description: "List of commands with markdown help"
-          schema:
-            type: object
-            properties:
-              commands:
-                type: array
-                items:
-                  type: object
-                  properties:
-                    command:
-                      type: string
-                    help:
-                      type: string
-          examples:
-            application/json:
-              commands:
-                - command: ls
-                  help: "List directory contents \n**params**:\n* `<ls_params>`"
-                - command: cat
-                  help: "Concatenate and display files \n**params**:\n* `<cat_params>`"