From: egernug <gerard.nugent@est.tech>
Date: Thu, 19 Jun 2025 10:07:00 +0000 (+0100)
Subject: Fix the input spec url for code generation in CPS-NCMP and ONAP-DMI-PLUGIN repo
X-Git-Url: https://gerrit.onap.org/r/gitweb?a=commitdiff_plain;h=refs%2Fchanges%2F44%2F141344%2F2;p=cps%2Fncmp-dmi-plugin.git

Fix the input spec url for code generation in CPS-NCMP and ONAP-DMI-PLUGIN repo

- Added rst_epilog to conf.py
- Referenced rst_epilog replace in design.rst. Release variable in conf.py now controls what branch we download from.
- Added variable to pom.xml to download OpenAPI files from referenced branch

Issue-ID: CPS-2857

Change-Id: I79503398971f919b3cabc69a485ed7470d1ce7ed
Signed-off-by: egernug <gerard.nugent@est.tech>
---

diff --git a/dmi-service/pom.xml b/dmi-service/pom.xml
index 60efb445..1b93225d 100644
--- a/dmi-service/pom.xml
+++ b/dmi-service/pom.xml
@@ -61,6 +61,7 @@
         <onap.nexus.url>https://nexus.onap.org</onap.nexus.url>
         <releaseNexusPath>/content/repositories/releases/</releaseNexusPath>
         <snapshotNexusPath>/content/repositories/snapshots/</snapshotNexusPath>
+        <swagger.branch>master</swagger.branch>
     </properties>
 
     <dependencyManagement>
@@ -364,7 +365,7 @@
                             <goal>generate</goal>
                         </goals>
                         <configuration>
-                            <inputSpec>https://gerrit.onap.org/r/gitweb?p=cps.git;a=blob_plain;f=docs/api/swagger/dmi/openapi.yml</inputSpec>
+                            <inputSpec>https://gerrit.onap.org/r/gitweb?p=cps.git;a=blob_plain;f=docs/api/swagger/dmi/openapi.yml;hb=refs/heads/${swagger.branch}</inputSpec>
                             <generatorName>spring</generatorName>
                             <generateSupportingFiles>false</generateSupportingFiles>
                             <invokerPackage>org.onap.cps.ncmp.dmi.rest.controller</invokerPackage>
@@ -389,7 +390,7 @@
                             <goal>generate</goal>
                         </goals>
                         <configuration>
-                            <inputSpec>https://gerrit.onap.org/r/gitweb?p=cps.git;a=blob_plain;f=docs/api/swagger/dmi/openapi-datajob.yml</inputSpec>
+                            <inputSpec>https://gerrit.onap.org/r/gitweb?p=cps.git;a=blob_plain;f=docs/api/swagger/dmi/openapi-datajob.yml;hb=refs/heads/${swagger.branch}</inputSpec>
                             <generatorName>spring</generatorName>
                             <generateSupportingFiles>false</generateSupportingFiles>
                             <invokerPackage>org.onap.cps.ncmp.dmi.datajobs.rest.controller</invokerPackage>
@@ -415,7 +416,7 @@
                         </goals>
                         <phase>compile</phase>
                         <configuration>
-                            <inputSpec>https://gerrit.onap.org/r/gitweb?p=cps.git;a=blob_plain;f=docs/api/swagger/dmi/openapi.yml</inputSpec>
+                            <inputSpec>https://gerrit.onap.org/r/gitweb?p=cps.git;a=blob_plain;f=docs/api/swagger/dmi/openapi.yml;hb=refs/heads/${swagger.branch}</inputSpec>
                             <generatorName>openapi-yaml</generatorName>
                             <configOptions>
                                 <outputFile>openapi.yaml</outputFile>
diff --git a/docs/conf.py b/docs/conf.py
index 724b903f..391d7d92 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -23,6 +23,11 @@ project = "onap"
 release = "master"
 version = "master"
 
+rst_epilog = f"""
+.. |dmi_openapi_url| replace:: `DMI Rest OpenAPI Specification <https://gerrit.onap.org/r/gitweb?p=cps.git;a=blob_plain;f=docs/api/swagger/dmi/openapi.yml;hb=refs/heads/{release}>`__
+.. |dmi_openapi_datajob_url| replace:: `DMI Datajob OpenApi Specification <https://gerrit.onap.org/r/gitweb?p=cps.git;a=blob_plain;f=docs/api/swagger/dmi/openapi-datajob.yml;hb=refs/heads/{release}>`__
+"""
+
 author = "Open Network Automation Platform"
 # yamllint disable-line rule:line-length
 copyright = "ONAP. Licensed under Creative Commons Attribution 4.0 International License"
diff --git a/docs/design.rst b/docs/design.rst
index 92975cc1..a0dd4552 100644
--- a/docs/design.rst
+++ b/docs/design.rst
@@ -17,9 +17,10 @@ Offered APIs
 
 The DMI-Plugin supports the public APIs listed in the link below:
 
-:download:`DMI Rest OpenApi Specification <https://gerrit.onap.org/r/gitweb?p=cps.git;a=blob_plain;f=docs/api/swagger/dmi/openapi.yml>`
+|dmi_openapi_url|
+
+|dmi_openapi_datajob_url|
 
-:download:`DMI Datajob OpenApi Specification <https://gerrit.onap.org/r/gitweb?p=cps.git;a=blob_plain;f=docs/api/swagger/dmi/openapi-datajob.yml>`
 
 View Offered APIs
 -----------------