patch: Create versioned docs for Python SDK

Signed-off-by: Vipul Gupta (@vipulgupta2048) <[email protected]>

Author: vipulgupta2048

.cspell/balena-words.txt

@@ -8,6 +8,7 @@ balenacli
 balenahup
 balenalib
 balenasdk
+balenasdkpython
 balenista
 balenistas
 Barys

.gitignore

@@ -15,7 +15,7 @@ tmp
 
 # Ignore external docs that are pulled via tools/fetch-external.sh
 # pages/reference/sdk/node-sdk.md
-pages/reference/sdk/python-sdk.md
+# pages/reference/sdk/python-sdk.md
 
 pages/reference/supervisor/supervisor-api.md
 pages/reference/supervisor/upgrade-policy.md
@@ -50,6 +50,10 @@ shared/balena-cli-versions/
 config/dictionaries/balenasdk.json
 shared/balena-sdk-versions/
 
+# Ignore dynamic Python SDK version docs
+config/dictionaries/balenasdkpython.json
+shared/balena-sdk-python-versions/
+
 # Ignore dynamic assets generated for Getting Started
 static/img/device/**
 config/dictionaries/device.json

config/navigation.txt

@@ -152,7 +152,7 @@ Reference
   CLI[/reference/balena-cli/$balenacli]
   SDKs
     Node.js SDK[/reference/sdk/node-sdk/$balenasdk]
-    Python SDK[/reference/sdk/python-sdk]
+    Python SDK[/reference/sdk/python-sdk/$balenasdkpython]
     Deprecation Policy[/reference/sdk/deprecation-policy]
 
   Diagnostics

config/redirects.txt

@@ -196,8 +196,8 @@
 /tools/cli /reference/balena-cli/latest/
 /tools/sdk/ /reference/sdk/node-sdk/latest/
 /tools/sdk /reference/sdk/node-sdk/latest/
-/tools/python-sdk/ /reference/sdk/python-sdk/
-/tools/python-sdk /reference/sdk/python-sdk/
+/tools/python-sdk/ /reference/sdk/python-sdk/latest/
+/tools/python-sdk /reference/sdk/python-sdk/latest/
 /runtime/resin-base-images/ /reference/base-images/balena-base-images/
 /runtime/resin-base-images /reference/base-images/balena-base-images/
 /configuration/custom-docker-base-images/ /reference/base-images/customer-docker-base-images/
@@ -274,6 +274,10 @@
 /reference/sdk/node-sdk/ /reference/sdk/node-sdk/latest/
 /reference/sdk/node-sdk /reference/sdk/node-sdk/latest/
 
+# Versioned Python.js SDK docs
+/reference/sdk/python-sdk/ /reference/sdk/python-sdk/latest/
+/reference/sdk/python-sdk /reference/sdk/python-sdk/latest/
+
 # Important: keep dynamic redirect below the static redirects
 # https://developers.cloudflare.com/pages/platform/redirects/
 

pages/reference/sdk/python-sdk.md

@@ -0,0 +1,14 @@
+---
+title: balena Python SDK Documentation
+
+layout: balena-sdk-python.html
+
+dynamic:
+  variables: [ $balenasdkpython ]
+  ref: $original_ref/$balenasdkpython
+  $switch_text: balena SDK version $balenasdkpython
+---
+
+# Balena Python SDK {{ $balenasdkpython.version }} Documentation
+
+{{import "balena-sdk-python-versions"}}

templates/balena-sdk-python.html

@@ -0,0 +1,8 @@
+{% extends "default.html" %}
+
+{% block dynamicSwitchCustom %}
+<p class="dynamic-switch__append">
+</p>
+{% endblock %}
+
+<div id="output"></div>

tools/build.sh

@@ -16,6 +16,9 @@ node ./tools/versioning.js https://github.com/balena-io/balena-cli/blob/master/d
 # Generate versioned balena-sdk docs
 node ./tools/versioning.js https://github.com/balena-io/balena-sdk/blob/master/DOCUMENTATION.md
 
+# Generate versioned balena-python-sdk docs
+node ./tools/versioning.js https://github.com/balena-io/balena-sdk-python/blob/master/DOCUMENTATION.md
+
 # Generate Masterclasses Dynamically
 ./tools/build-masterclass.sh
 

tools/fetch-external.sh

@@ -100,7 +100,7 @@ cd shared/sdk/ && {
 } &
 
 # get latest python SDK docs
-curl --fail --show-error -o pages/reference/sdk/python-sdk.md -L https://github.com/balena-io/balena-sdk-python/raw/master/DOCUMENTATION.md &
+# curl --fail --show-error -o pages/reference/sdk/python-sdk.md -L https://github.com/balena-io/balena-sdk-python/raw/master/DOCUMENTATION.md &
 
 # get latest base images ref docs
 cd pages/reference/base-images/ && {