From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) by lore.proxmox.com (Postfix) with ESMTPS id 58DAF1FF179 for ; Wed, 12 Nov 2025 11:23:41 +0100 (CET) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 424131DB63; Wed, 12 Nov 2025 11:24:23 +0100 (CET) From: Shannon Sterz To: pdm-devel@lists.proxmox.com Date: Wed, 12 Nov 2025 11:24:15 +0100 Message-ID: <20251112102415.175358-9-s.sterz@proxmox.com> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20251112102415.175358-1-s.sterz@proxmox.com> References: <20251112102415.175358-1-s.sterz@proxmox.com> MIME-Version: 1.0 X-Bm-Milter-Handled: 55990f41-d878-4baa-be0a-ee34c49e34d2 X-Bm-Transport-Timestamp: 1762943032826 X-SPAM-LEVEL: Spam detection results: 0 AWL 0.061 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% DMARC_MISSING 0.1 Missing DMARC policy KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record Subject: [pdm-devel] [PATCH datacenter-manager 2/2] api-viewer: add an api-viewer package X-BeenThere: pdm-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox Datacenter Manager development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Proxmox Datacenter Manager development discussion Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: pdm-devel-bounces@lists.proxmox.com Sender: "pdm-devel" this can be installed as a suggested package and will then be served at `https://$pdm-host::8443/docs/api-viewer/apidoc.js`. Signed-off-by: Shannon Sterz --- Makefile | 1 + debian/control | 13 +++++++++ ...xmox-datacenter-manager-api-viewer.install | 1 + docs/api-viewer/Makefile | 27 +++++++++++++++++++ docs/api-viewer/index.html | 16 +++++++++++ 5 files changed, 58 insertions(+) create mode 100644 debian/proxmox-datacenter-manager-api-viewer.install create mode 100644 docs/api-viewer/Makefile create mode 100644 docs/api-viewer/index.html diff --git a/Makefile b/Makefile index b2f794a..ca721eb 100644 --- a/Makefile +++ b/Makefile @@ -82,6 +82,7 @@ install: $(COMPILED_BINS) $(SHELL_COMPLETION_FILES) $(foreach i,$(ZSH_COMPLETIONS), \ install -m644 $(COMPLETION_DIR)/$(i) $(DESTDIR)$(ZSHCOMPDIR)/ ;) make -C services install + make -C docs/api-viewer install $(COMPILED_BINS): .do-cargo-build .do-cargo-build: diff --git a/debian/control b/debian/control index 19b13c8..ebe0923 100644 --- a/debian/control +++ b/debian/control @@ -125,6 +125,7 @@ Build-Depends: cargo:native, librust-zstd-0.13+default-dev, libstd-rust-dev, libsystemd-dev, + proxmox-widget-toolkit-dev, rustc:native, Maintainer: Proxmox Support Team Standards-Version: 4.6.1 @@ -143,6 +144,7 @@ Depends: proxmox-mini-journalreader, ${misc:Depends}, ${shlibs:Depends}, Recommends: proxmox-datacenter-manager-client, proxmox-datacenter-manager-ui, +Suggests: proxmox-datacenter-manager-api-viewer, Description: Manage multiple Proxmox VE cluster and other Proxmox projects This package provides the API daemons of the Proxmox Datacenter Manager (PDM) which allows one to add multiple Proxmox VE and Proxmox Backup Server @@ -155,3 +157,14 @@ Depends: ${misc:Depends}, ${shlibs:Depends}, Description: CLI Client for the Proxmox Datacenter Manager This package provides the CLI client that can interface with a Proxmox Datacenter Manager (PDM) instance. + +Package: proxmox-datacenter-manager-api-viewer +Architecture: any +Multi-Arch: allowed +Depends: fonts-font-awesome, + libjs-extjs (>= 7~), + proxmox-widget-toolkit, + ${misc:Depends}, + ${shlibs:Depends}, +Recommends: proxmox-datacenter-manager, +Description: API Viewer for the Proxmox Datacenter Manager. diff --git a/debian/proxmox-datacenter-manager-api-viewer.install b/debian/proxmox-datacenter-manager-api-viewer.install new file mode 100644 index 0000000..0e4d9df --- /dev/null +++ b/debian/proxmox-datacenter-manager-api-viewer.install @@ -0,0 +1 @@ +usr/share/doc/proxmox-datacenter-manager/html diff --git a/docs/api-viewer/Makefile b/docs/api-viewer/Makefile new file mode 100644 index 0000000..c64bfbb --- /dev/null +++ b/docs/api-viewer/Makefile @@ -0,0 +1,27 @@ +DOCDIR = /usr/share/doc/proxmox-datacenter-manager + +API_VIEWER_SOURCES= \ + index.html \ + apidoc.js + +API_VIEWER_FILES := \ + apidata.js \ + /usr/share/javascript/proxmox-widget-toolkit-dev/APIViewer.js + +ifeq ($(BUILD_MODE), release) +COMPILEDIR := ../../target/release +else +COMPILEDIR := ../../target/debug +endif + +.PHONY: install +install: ${API_VIEWER_SOURCES} + install -dm 0755 $(DESTDIR)$(DOCDIR)/html/api-viewer + install -m 0644 ${API_VIEWER_SOURCES} $(DESTDIR)$(DOCDIR)/html/api-viewer + +apidata.js: ${COMPILEDIR}/docgen + ${COMPILEDIR}/docgen apidata.js >$@ + +apidoc.js: ${API_VIEWER_FILES} + cat ${API_VIEWER_FILES} >$@.tmp + mv $@.tmp $@ diff --git a/docs/api-viewer/index.html b/docs/api-viewer/index.html new file mode 100644 index 0000000..2bf97c5 --- /dev/null +++ b/docs/api-viewer/index.html @@ -0,0 +1,16 @@ + + + + + + Proxmox Datacenter Manager API Documentation + + + + + + + + + + -- 2.47.3 _______________________________________________ pdm-devel mailing list pdm-devel@lists.proxmox.com https://lists.proxmox.com/cgi-bin/mailman/listinfo/pdm-devel