[pdm-devel] [PATCH widget-toolkit v4 1/1] api viewer: add support for endpoints that are marked as unstable

[Shannon Sterz]

display a warning when an endpoint is marked as unstable.

Signed-off-by: Shannon Sterz <s.sterz at proxmox.com>
Tested-by: Lukas Wagner <l.wagner at proxmox.com>
Reviewed-by: Lukas Wagner <l.wagner at proxmox.com>
---
 src/api-viewer/APIViewer.js | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/src/api-viewer/APIViewer.js b/src/api-viewer/APIViewer.js
index 7f27e0d..1357741 100644
--- a/src/api-viewer/APIViewer.js
+++ b/src/api-viewer/APIViewer.js
@@ -210,7 +210,21 @@ Ext.onReady(function () {
                     usage += cliUsageRenderer(method, endpoint);
                 }

-                let sections = [
+                let sections = [];
+
+                if (info.unstable) {
+                    sections.push({
+                        title: 'Unstable',
+                        html: `<div class="proxmox-warning-row" style="padding: 10px;">
+                                <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
+                                This API endpoint is marked as unstable. All information on this
+                                page is subject to change, including input parameters, return values
+                                and permissions.
+                            </div>`,
+                    });
+                }
+
+                sections.concat([
                     {
                         title: 'Description',
                         html: Ext.htmlEncode(info.description),
@@ -221,7 +235,7 @@ Ext.onReady(function () {
                         html: usage,
                         bodyPadding: 10,
                     },
-                ];
+                ]);

                 if (info.parameters && info.parameters.properties) {
                     let pstore = Ext.create('Ext.data.Store', {
--
2.47.3