Better package version docs (#4721)

* Better package docs * wip * Fix linter issue * [MegaLinter] Apply linters fixes * [MegaLinter] Apply linters fixes --------- Co-authored-by: bdovaz <[email protected]>
oxsecurity · Feb 14, 2025 · 96cb37f · 96cb37f
1 parent b46b3f6
commit 96cb37f
Show file tree

Hide file tree

Showing 64 changed files with 214 additions and 144 deletions.
diff --git a/.automation/build.py b/.automation/build.py
@@ -151,6 +151,8 @@
 
 ALPINE_VERSION = ""
 
+MAIN_DOCKERFILE_ARGS_MAP = {}
+
 with open(MAIN_DOCKERFILE, "r", encoding="utf-8") as main_dockerfile_file:
     main_dockerfile_content = main_dockerfile_file.read()
 
@@ -161,6 +163,11 @@
     else:
         logging.critical("No Alpine version found")
 
+    matches = re.finditer(r"ARG (.*)=(.*)", main_dockerfile_content)
+
+    for match in matches:
+        MAIN_DOCKERFILE_ARGS_MAP[match.group(1)] = match.group(2)
+
 
 # Generate one Dockerfile by MegaLinter flavor
 def generate_all_flavors():
@@ -2188,6 +2195,14 @@ def get_install_md(item):
             "  ",
             f"https://pkgs.alpinelinux.org/packages?branch=v{ALPINE_VERSION}&arch=x86_64&name=",
         )
+    if "cargo" in item["install"]:
+        linter_doc_md += ["- Cargo packages (Rust):"]
+        linter_doc_md += md_package_list(
+            item["install"]["cargo"],
+            "cargo",
+            "  ",
+            "https://crates.io/crates/",
+        )
     if "npm" in item["install"]:
         linter_doc_md += ["- NPM packages (node.js):"]
         linter_doc_md += md_package_list(
@@ -2327,29 +2342,76 @@ def merge_install_attr(item):
 
 def md_package_list(package_list, type, indent, start_url):
     res = []
-    for package_id_v in package_list:
-        package_id = package_id_v
-        package_version = ""
-
-        if type == "npm" and package_id.count("@") == 2:  # npm specific version
-            package_id_split = package_id.split("@")
-            package_id = "@" + package_id_split[1]
-            package_version = "/v/" + package_id_split[2]
-        elif type == "pip" and "==" in package_id_v:  # py specific version
-            package_id = package_id_v.split("==")[0]
-            package_version = "/" + package_id_v.split("==")[1]
-        elif type == "gem":
-            gem_match = re.match(
-                r"(.*)\s-v\s(.*)", package_id_v
-            )  # gem specific version
-
-            if gem_match:  # gem specific version
-                package_id = gem_match.group(1)
-                package_version = "/versions/" + gem_match.group(2)
-        res += [f"{indent}- [{package_id_v}]({start_url}{package_id}{package_version})"]
+    for package in package_list:
+        package_name = package
+        end_url = package
+
+        if type == "cargo":  # cargo specific version
+            match = re.search(r"(.*)@(.*)", package)
+
+            if match:
+                package_id = match.group(1)
+                package_version = get_arg_variable_value(match.group(2))
+
+                if package_version is not None:
+                    package_name = f"{package_id}@{package_version}"
+                    end_url = f"{package_id}/{package_version}"
+                else:
+                    package_name = package_id
+                    end_url = package_id
+        elif type == "npm":  # npm specific version
+            match = re.search(r"(.*)@(.*)", package)
+
+            if match:
+                package_id = match.group(1)
+                package_version = get_arg_variable_value(match.group(2))
+
+                if package_version is not None:
+                    package_name = f"{package_id}@{package_version}"
+                    end_url = f"{package_id}/v/{package_version}"
+                else:
+                    package_name = package_id
+                    end_url = package_id
+        elif type == "pip":  # py specific version
+            match = re.search(r"(.*)==(.*)", package)
+
+            if match:
+                package_id = match.group(1)
+                package_version = get_arg_variable_value(match.group(2))
+
+                if package_version is not None:
+                    package_name = f"{package_id}=={package_version}"
+                    end_url = f"{package_id}/{package_version}"
+                else:
+                    package_name = package_id
+                    end_url = package_id
+        elif type == "gem":  # gem specific version
+            match = re.search(r"(.*):(.*)", package)
+
+            if match:
+                package_id = match.group(1)
+                package_version = get_arg_variable_value(match.group(2))
+
+                if package_version is not None:
+                    package_name = f"{package_id}:{package_version}"
+                    end_url = f"{package_id}/versions/{package_version}"
+                else:
+                    package_name = package_id
+                    end_url = package_id
+
+        res += [f"{indent}- [{package_name}]({start_url}{end_url})"]
     return res
 
 
+def get_arg_variable_value(package_version):
+    extracted_version = re.search(r"\$\{(.*)\}", package_version).group(1)
+
+    if extracted_version in MAIN_DOCKERFILE_ARGS_MAP:
+        return MAIN_DOCKERFILE_ARGS_MAP[extracted_version]
+    else:
+        return None
+
+
 def replace_in_file(file_path, start, end, content, add_new_line=True):
     # Read in the file
     with open(file_path, "r", encoding="utf-8") as file:

diff --git a/docs/descriptors/ansible_ansible_lint.md b/docs/descriptors/ansible_ansible_lint.md
@@ -173,4 +173,4 @@ ARG PIP_ANSIBLE_LINT_VERSION=25.1.2
 ```
 
 - PIP packages (Python):
-  - [ansible-lint==${PIP_ANSIBLE_LINT_VERSION}](https://pypi.org/project/ansible-lint/${PIP_ANSIBLE_LINT_VERSION})
+  - [ansible-lint==25.1.2](https://pypi.org/project/ansible-lint/25.1.2)
diff --git a/docs/descriptors/api_spectral.md b/docs/descriptors/api_spectral.md
@@ -137,4 +137,4 @@ ARG NPM_SPECTRAL_CLI_VERSION=6.14.2
 ```
 
 - NPM packages (node.js):
-  - [@stoplight/spectral-cli@${NPM_SPECTRAL_CLI_VERSION}](https://www.npmjs.com/package/@stoplight/spectral-cli/v/${NPM_SPECTRAL_CLI_VERSION})
+  - [@stoplight/spectral-cli@6.14.2](https://www.npmjs.com/package/@stoplight/spectral-cli/v/6.14.2)
diff --git a/docs/descriptors/bash_shellcheck.md b/docs/descriptors/bash_shellcheck.md
@@ -133,3 +133,5 @@ FROM koalaman/shellcheck:${BASH_SHELLCHECK_VERSION} AS shellcheck
 COPY --link --from=shellcheck /bin/shellcheck /usr/bin/shellcheck
 ```
 
+- Cargo packages (Rust):
+  - [[email protected]](https://crates.io/crates/shellcheck-sarif/0.7.0)
diff --git a/docs/descriptors/c_cpplint.md b/docs/descriptors/c_cpplint.md
@@ -307,4 +307,4 @@ ARG PIP_CPPLINT_VERSION=2.0.0
 ```
 
 - PIP packages (Python):
-  - [cpplint==${PIP_CPPLINT_VERSION}](https://pypi.org/project/cpplint/${PIP_CPPLINT_VERSION})
+  - [cpplint==2.0.0](https://pypi.org/project/cpplint/2.0.0)
diff --git a/docs/descriptors/cloudformation_cfn_lint.md b/docs/descriptors/cloudformation_cfn_lint.md
@@ -169,4 +169,4 @@ ARG PIP_CFN_LINT_VERSION=1.24.0
 ```
 
 - PIP packages (Python):
-  - [cfn-lint[sarif]==${PIP_CFN_LINT_VERSION}](https://pypi.org/project/cfn-lint[sarif]/${PIP_CFN_LINT_VERSION})
+  - [cfn-lint[sarif]==1.24.0](https://pypi.org/project/cfn-lint[sarif]/1.24.0)
diff --git a/docs/descriptors/coffee_coffeelint.md b/docs/descriptors/coffee_coffeelint.md
@@ -121,4 +121,4 @@ ARG NPM_COFFEELINT_CLI_VERSION=5.2.11
 ```
 
 - NPM packages (node.js):
-  - [@coffeelint/cli@${NPM_COFFEELINT_CLI_VERSION}](https://www.npmjs.com/package/@coffeelint/cli/v/${NPM_COFFEELINT_CLI_VERSION})
+  - [@coffeelint/cli@5.2.11](https://www.npmjs.com/package/@coffeelint/cli/v/5.2.11)
diff --git a/docs/descriptors/copypaste_jscpd.md b/docs/descriptors/copypaste_jscpd.md
@@ -175,4 +175,4 @@ ARG NPM_JSCPD_VERSION=4.0.5
 ```
 
 - NPM packages (node.js):
-  - [jscpd@${NPM_JSCPD_VERSION}](https://www.npmjs.com/package/jscpd@${NPM_JSCPD_VERSION})
+  - [jscpd@4.0.5](https://www.npmjs.com/package/jscpd/v/4.0.5)
diff --git a/docs/descriptors/cpp_cpplint.md b/docs/descriptors/cpp_cpplint.md
@@ -307,4 +307,4 @@ ARG PIP_CPPLINT_VERSION=2.0.0
 ```
 
 - PIP packages (Python):
-  - [cpplint==${PIP_CPPLINT_VERSION}](https://pypi.org/project/cpplint/${PIP_CPPLINT_VERSION})
+  - [cpplint==2.0.0](https://pypi.org/project/cpplint/2.0.0)
diff --git a/docs/descriptors/css_stylelint.md b/docs/descriptors/css_stylelint.md
@@ -315,9 +315,9 @@ ARG PIP_CPPLINT_VERSION=2.0.0
 ```
 
 - NPM packages (node.js):
-  - [stylelint@${NPM_STYLELINT_VERSION}](https://www.npmjs.com/package/stylelint@${NPM_STYLELINT_VERSION})
-  - [stylelint-config-standard@${NPM_STYLELINT_CONFIG_STANDARD_VERSION}](https://www.npmjs.com/package/stylelint-config-standard@${NPM_STYLELINT_CONFIG_STANDARD_VERSION})
-  - [stylelint-config-sass-guidelines@${NPM_STYLELINT_CONFIG_SASS_GUIDELINES_VERSION}](https://www.npmjs.com/package/stylelint-config-sass-guidelines@${NPM_STYLELINT_CONFIG_SASS_GUIDELINES_VERSION})
-  - [stylelint-scss@${NPM_STYLELINT_SCSS_VERSION}](https://www.npmjs.com/package/stylelint-scss@${NPM_STYLELINT_SCSS_VERSION})
+  - [stylelint@16.14.1](https://www.npmjs.com/package/stylelint/v/16.14.1)
+  - [stylelint-config-standard@37.0.0](https://www.npmjs.com/package/stylelint-config-standard/v/37.0.0)
+  - [stylelint-config-sass-guidelines@12.1.0](https://www.npmjs.com/package/stylelint-config-sass-guidelines/v/12.1.0)
+  - [stylelint-scss@6.11.0](https://www.npmjs.com/package/stylelint-scss/v/6.11.0)
 - PIP packages (Python):
-  - [cpplint==${PIP_CPPLINT_VERSION}](https://pypi.org/project/cpplint/${PIP_CPPLINT_VERSION})
+  - [cpplint==2.0.0](https://pypi.org/project/cpplint/2.0.0)
diff --git a/docs/descriptors/gherkin_gherkin_lint.md b/docs/descriptors/gherkin_gherkin_lint.md
@@ -98,4 +98,4 @@ ARG NPM_GHERKIN_LINT_VERSION=4.2.4
 ```
 
 - NPM packages (node.js):
-  - [gherkin-lint@${NPM_GHERKIN_LINT_VERSION}](https://www.npmjs.com/package/gherkin-lint@${NPM_GHERKIN_LINT_VERSION})
+  - [gherkin-lint@4.2.4](https://www.npmjs.com/package/gherkin-lint/v/4.2.4)
diff --git a/docs/descriptors/graphql_graphql_schema_linter.md b/docs/descriptors/graphql_graphql_schema_linter.md
@@ -114,5 +114,5 @@ ARG NPM_GRAPHQL_SCHEMA_LINTER_VERSION=3.0.1
 ```
 
 - NPM packages (node.js):
-  - [graphql@${NPM_GRAPHQL_VERSION}](https://www.npmjs.com/package/graphql@${NPM_GRAPHQL_VERSION})
-  - [graphql-schema-linter@${NPM_GRAPHQL_SCHEMA_LINTER_VERSION}](https://www.npmjs.com/package/graphql-schema-linter@${NPM_GRAPHQL_SCHEMA_LINTER_VERSION})
+  - [graphql@16.10.0](https://www.npmjs.com/package/graphql/v/16.10.0)
+  - [graphql-schema-linter@3.0.1](https://www.npmjs.com/package/graphql-schema-linter/v/3.0.1)
diff --git a/docs/descriptors/groovy_npm_groovy_lint.md b/docs/descriptors/groovy_npm_groovy_lint.md
@@ -156,4 +156,4 @@ ARG NPM_GROOVY_LINT_VERSION=15.0.2
 - APK packages (Linux):
   - [openjdk17](https://pkgs.alpinelinux.org/packages?branch=v3.21&arch=x86_64&name=openjdk17)
 - NPM packages (node.js):
-  - [npm-groovy-lint@${NPM_GROOVY_LINT_VERSION}](https://www.npmjs.com/package/npm-groovy-lint@${NPM_GROOVY_LINT_VERSION})
+  - [npm-groovy-lint@15.0.2](https://www.npmjs.com/package/npm-groovy-lint/v/15.0.2)
diff --git a/docs/descriptors/html_djlint.md b/docs/descriptors/html_djlint.md
@@ -183,4 +183,4 @@ ARG PIP_DJLINT_VERSION=1.36.4
 ```
 
 - PIP packages (Python):
-  - [djlint==${PIP_DJLINT_VERSION}](https://pypi.org/project/djlint/${PIP_DJLINT_VERSION})
+  - [djlint==1.36.4](https://pypi.org/project/djlint/1.36.4)
diff --git a/docs/descriptors/html_htmlhint.md b/docs/descriptors/html_htmlhint.md
@@ -140,4 +140,4 @@ ARG NPM_HTMLHINT_VERSION=1.1.4
 ```
 
 - NPM packages (node.js):
-  - [htmlhint@${NPM_HTMLHINT_VERSION}](https://www.npmjs.com/package/htmlhint@${NPM_HTMLHINT_VERSION})
+  - [htmlhint@1.1.4](https://www.npmjs.com/package/htmlhint/v/1.1.4)
diff --git a/docs/descriptors/javascript_eslint.md b/docs/descriptors/javascript_eslint.md
@@ -207,16 +207,16 @@ ARG NPM_MICROSOFT_ESLINT_FORMATTER_SARIF_VERSION=3.1.0
 ```
 
 - NPM packages (node.js):
-  - [eslint@${NPM_ESLINT_VERSION}](https://www.npmjs.com/package/eslint@${NPM_ESLINT_VERSION})
-  - [eslint-config-airbnb@${NPM_ESLINT_CONFIG_AIRBNB_VERSION}](https://www.npmjs.com/package/eslint-config-airbnb@${NPM_ESLINT_CONFIG_AIRBNB_VERSION})
-  - [eslint-config-prettier@${NPM_ESLINT_CONFIG_PRETTIER_VERSION}](https://www.npmjs.com/package/eslint-config-prettier@${NPM_ESLINT_CONFIG_PRETTIER_VERSION})
-  - [eslint-config-standard@${NPM_ESLINT_CONFIG_STANDARD_VERSION}](https://www.npmjs.com/package/eslint-config-standard@${NPM_ESLINT_CONFIG_STANDARD_VERSION})
-  - [eslint-plugin-import@${NPM_ESLINT_PLUGIN_IMPORT_VERSION}](https://www.npmjs.com/package/eslint-plugin-import@${NPM_ESLINT_PLUGIN_IMPORT_VERSION})
-  - [eslint-plugin-jest@${NPM_ESLINT_PLUGIN_JEST_VERSION}](https://www.npmjs.com/package/eslint-plugin-jest@${NPM_ESLINT_PLUGIN_JEST_VERSION})
-  - [eslint-plugin-n@${NPM_ESLINT_PLUGIN_N_VERSION}](https://www.npmjs.com/package/eslint-plugin-n@${NPM_ESLINT_PLUGIN_N_VERSION})
-  - [eslint-plugin-prettier@${NPM_ESLINT_PLUGIN_PRETTIER_VERSION}](https://www.npmjs.com/package/eslint-plugin-prettier@${NPM_ESLINT_PLUGIN_PRETTIER_VERSION})
-  - [eslint-plugin-promise@${NPM_ESLINT_PLUGIN_PROMISE_VERSION}](https://www.npmjs.com/package/eslint-plugin-promise@${NPM_ESLINT_PLUGIN_PROMISE_VERSION})
-  - [eslint-plugin-vue@${NPM_ESLINT_PLUGIN_VUE_VERSION}](https://www.npmjs.com/package/eslint-plugin-vue@${NPM_ESLINT_PLUGIN_VUE_VERSION})
-  - [@babel/core@${NPM_BABEL_CORE_VERSION}](https://www.npmjs.com/package/@babel/core/v/${NPM_BABEL_CORE_VERSION})
-  - [@babel/eslint-parser@${NPM_BABEL_ESLINT_PARSER_VERSION}](https://www.npmjs.com/package/@babel/eslint-parser/v/${NPM_BABEL_ESLINT_PARSER_VERSION})
-  - [@microsoft/eslint-formatter-sarif@${NPM_MICROSOFT_ESLINT_FORMATTER_SARIF_VERSION}](https://www.npmjs.com/package/@microsoft/eslint-formatter-sarif/v/${NPM_MICROSOFT_ESLINT_FORMATTER_SARIF_VERSION})
+  - [eslint@8.57.1](https://www.npmjs.com/package/eslint/v/8.57.1)
+  - [eslint-config-airbnb@19.0.4](https://www.npmjs.com/package/eslint-config-airbnb/v/19.0.4)
+  - [eslint-config-prettier@10.0.1](https://www.npmjs.com/package/eslint-config-prettier/v/10.0.1)
+  - [eslint-config-standard@17.1.0](https://www.npmjs.com/package/eslint-config-standard/v/17.1.0)
+  - [eslint-plugin-import@2.31.0](https://www.npmjs.com/package/eslint-plugin-import/v/2.31.0)
+  - [eslint-plugin-jest@28.11.0](https://www.npmjs.com/package/eslint-plugin-jest/v/28.11.0)
+  - [eslint-plugin-n@16.0.0](https://www.npmjs.com/package/eslint-plugin-n/v/16.0.0)
+  - [eslint-plugin-prettier@5.2.3](https://www.npmjs.com/package/eslint-plugin-prettier/v/5.2.3)
+  - [eslint-plugin-promise@6.6.0](https://www.npmjs.com/package/eslint-plugin-promise/v/6.6.0)
+  - [eslint-plugin-vue@9.32.0](https://www.npmjs.com/package/eslint-plugin-vue/v/9.32.0)
+  - [@babel/core@7.26.8](https://www.npmjs.com/package/@babel/core/v/7.26.8)
+  - [@babel/eslint-parser@7.26.8](https://www.npmjs.com/package/@babel/eslint-parser/v/7.26.8)
+  - [@microsoft/eslint-formatter-sarif@3.1.0](https://www.npmjs.com/package/@microsoft/eslint-formatter-sarif/v/3.1.0)
diff --git a/docs/descriptors/javascript_prettier.md b/docs/descriptors/javascript_prettier.md
@@ -243,4 +243,4 @@ ARG NPM_PRETTIER_VERSION=3.5.1
 ```
 
 - NPM packages (node.js):
-  - [prettier@${NPM_PRETTIER_VERSION}](https://www.npmjs.com/package/prettier@${NPM_PRETTIER_VERSION})
+  - [prettier@3.5.0](https://www.npmjs.com/package/prettier/v/3.5.0)
diff --git a/docs/descriptors/javascript_standard.md b/docs/descriptors/javascript_standard.md
@@ -135,4 +135,4 @@ ARG NPM_STANDARD_VERSION=17.1.2
 ```
 
 - NPM packages (node.js):
-  - [standard@${NPM_STANDARD_VERSION}](https://www.npmjs.com/package/standard@${NPM_STANDARD_VERSION})
+  - [standard@17.1.2](https://www.npmjs.com/package/standard/v/17.1.2)
diff --git a/docs/descriptors/json_eslint_plugin_jsonc.md b/docs/descriptors/json_eslint_plugin_jsonc.md
@@ -241,6 +241,6 @@ ARG NPM_MICROSOFT_ESLINT_FORMATTER_SARIF_VERSION=3.1.0
 ```
 
 - NPM packages (node.js):
-  - [eslint@${NPM_ESLINT_VERSION}](https://www.npmjs.com/package/eslint@${NPM_ESLINT_VERSION})
-  - [eslint-plugin-jsonc@${NPM_ESLINT_PLUGIN_JSONC_VERSION}](https://www.npmjs.com/package/eslint-plugin-jsonc@${NPM_ESLINT_PLUGIN_JSONC_VERSION})
-  - [@microsoft/eslint-formatter-sarif@${NPM_MICROSOFT_ESLINT_FORMATTER_SARIF_VERSION}](https://www.npmjs.com/package/@microsoft/eslint-formatter-sarif/v/${NPM_MICROSOFT_ESLINT_FORMATTER_SARIF_VERSION})
+  - [eslint@8.57.1](https://www.npmjs.com/package/eslint/v/8.57.1)
+  - [eslint-plugin-jsonc](https://www.npmjs.com/package/eslint-plugin-jsonc)
+  - [@microsoft/eslint-formatter-sarif@3.1.0](https://www.npmjs.com/package/@microsoft/eslint-formatter-sarif/v/3.1.0)
diff --git a/docs/descriptors/json_jsonlint.md b/docs/descriptors/json_jsonlint.md
@@ -154,4 +154,4 @@ ARG NPM_PRANTLF_JSONLINT_VERSION=16.0.0
 ```
 
 - NPM packages (node.js):
-  - [@prantlf/jsonlint@${NPM_PRANTLF_JSONLINT_VERSION}](https://www.npmjs.com/package/@prantlf/jsonlint/v/${NPM_PRANTLF_JSONLINT_VERSION})
+  - [@prantlf/jsonlint@16.0.0](https://www.npmjs.com/package/@prantlf/jsonlint/v/16.0.0)
diff --git a/docs/descriptors/json_npm_package_json_lint.md b/docs/descriptors/json_npm_package_json_lint.md
@@ -125,5 +125,5 @@ ARG NPM_PACKAGE_JSON_LINT_CONFIG_DEFAULT_VERSION=7.0.1
 ```
 
 - NPM packages (node.js):
-  - [npm-package-json-lint@${NPM_PACKAGE_JSON_LINT_VERSION}](https://www.npmjs.com/package/npm-package-json-lint@${NPM_PACKAGE_JSON_LINT_VERSION})
-  - [npm-package-json-lint-config-default@${NPM_PACKAGE_JSON_LINT_CONFIG_DEFAULT_VERSION}](https://www.npmjs.com/package/npm-package-json-lint-config-default@${NPM_PACKAGE_JSON_LINT_CONFIG_DEFAULT_VERSION})
+  - [npm-package-json-lint@8.0.0](https://www.npmjs.com/package/npm-package-json-lint/v/8.0.0)
+  - [npm-package-json-lint-config-default@7.0.1](https://www.npmjs.com/package/npm-package-json-lint-config-default/v/7.0.1)
diff --git a/docs/descriptors/json_prettier.md b/docs/descriptors/json_prettier.md
@@ -255,4 +255,4 @@ ARG NPM_PRETTIER_VERSION=3.5.1
 ```
 
 - NPM packages (node.js):
-  - [prettier@${NPM_PRETTIER_VERSION}](https://www.npmjs.com/package/prettier@${NPM_PRETTIER_VERSION})
+  - [prettier@3.5.0](https://www.npmjs.com/package/prettier/v/3.5.0)
diff --git a/docs/descriptors/json_v8r.md b/docs/descriptors/json_v8r.md
@@ -141,4 +141,4 @@ ARG NPM_V8R_VERSION=4.2.1
 ```
 
 - NPM packages (node.js):
-  - [v8r@${NPM_V8R_VERSION}](https://www.npmjs.com/package/v8r@${NPM_V8R_VERSION})
+  - [v8r@4.2.1](https://www.npmjs.com/package/v8r/v/4.2.1)
diff --git a/docs/descriptors/jsx_eslint.md b/docs/descriptors/jsx_eslint.md
@@ -188,7 +188,7 @@ ARG NPM_MICROSOFT_ESLINT_FORMATTER_SARIF_VERSION=3.1.0
 ```
 
 - NPM packages (node.js):
-  - [eslint@${NPM_ESLINT_VERSION}](https://www.npmjs.com/package/eslint@${NPM_ESLINT_VERSION})
-  - [eslint-plugin-react@${NPM_ESLINT_PLUGIN_REACT_VERSION}](https://www.npmjs.com/package/eslint-plugin-react@${NPM_ESLINT_PLUGIN_REACT_VERSION})
-  - [eslint-plugin-jsx-a11y@${NPM_ESLINT_PLUGIN_JSX_ALLY_VERSION}](https://www.npmjs.com/package/eslint-plugin-jsx-a11y@${NPM_ESLINT_PLUGIN_JSX_ALLY_VERSION})
-  - [@microsoft/eslint-formatter-sarif@${NPM_MICROSOFT_ESLINT_FORMATTER_SARIF_VERSION}](https://www.npmjs.com/package/@microsoft/eslint-formatter-sarif/v/${NPM_MICROSOFT_ESLINT_FORMATTER_SARIF_VERSION})
+  - [eslint@8.57.1](https://www.npmjs.com/package/eslint/v/8.57.1)
+  - [eslint-plugin-react@7.37.4](https://www.npmjs.com/package/eslint-plugin-react/v/7.37.4)
+  - [eslint-plugin-jsx-a11y@6.10.2](https://www.npmjs.com/package/eslint-plugin-jsx-a11y/v/6.10.2)
+  - [@microsoft/eslint-formatter-sarif@3.1.0](https://www.npmjs.com/package/@microsoft/eslint-formatter-sarif/v/3.1.0)
diff --git a/docs/descriptors/lua_selene.md b/docs/descriptors/lua_selene.md
@@ -134,3 +134,5 @@ RUN wget --tries=5 https://www.lua.org/ftp/lua-5.3.5.tar.gz -O - -q | tar -xzf -
 ARG CARGO_SELENE_VERSION=0.28.0
 ```
 
+- Cargo packages (Rust):
+  - [[email protected]](https://crates.io/crates/selene/0.28.0)
diff --git a/docs/descriptors/lua_stylua.md b/docs/descriptors/lua_stylua.md
@@ -199,3 +199,5 @@ RUN wget --tries=5 https://www.lua.org/ftp/lua-5.3.5.tar.gz -O - -q | tar -xzf -
 ARG CARGO_STYLUA_VERSION=2.0.0
 ```
 
+- Cargo packages (Rust):
+  - [[email protected]](https://crates.io/crates/stylua/2.0.0)
diff --git a/docs/descriptors/markdown_markdown_link_check.md b/docs/descriptors/markdown_markdown_link_check.md
@@ -116,4 +116,4 @@ ARG NPM_MARKDOWN_LINK_CHECK_VERSION=3.12.2
 ```
 
 - NPM packages (node.js):
-  - [markdown-link-check@${NPM_MARKDOWN_LINK_CHECK_VERSION}](https://www.npmjs.com/package/markdown-link-check@${NPM_MARKDOWN_LINK_CHECK_VERSION})
+  - [markdown-link-check@3.12.2](https://www.npmjs.com/package/markdown-link-check/v/3.12.2)
diff --git a/docs/descriptors/markdown_markdown_table_formatter.md b/docs/descriptors/markdown_markdown_table_formatter.md
@@ -119,4 +119,4 @@ ARG NPM_MARKDOWN_TABLE_FORMATTER_VERSION=1.6.1
 ```
 
 - NPM packages (node.js):
-  - [markdown-table-formatter@${NPM_MARKDOWN_TABLE_FORMATTER_VERSION}](https://www.npmjs.com/package/markdown-table-formatter@${NPM_MARKDOWN_TABLE_FORMATTER_VERSION})
+  - [markdown-table-formatter@1.6.1](https://www.npmjs.com/package/markdown-table-formatter/v/1.6.1)
diff --git a/docs/descriptors/markdown_markdownlint.md b/docs/descriptors/markdown_markdownlint.md
@@ -150,4 +150,4 @@ ARG NPM_MARKDOWNLINT_CLI_VERSION=0.44.0
 ```
 
 - NPM packages (node.js):
-  - [markdownlint-cli@${NPM_MARKDOWNLINT_CLI_VERSION}](https://www.npmjs.com/package/markdownlint-cli@${NPM_MARKDOWNLINT_CLI_VERSION})
+  - [markdownlint-cli@0.44.0](https://www.npmjs.com/package/markdownlint-cli/v/0.44.0)
diff --git a/docs/descriptors/markdown_remark_lint.md b/docs/descriptors/markdown_remark_lint.md
@@ -152,5 +152,5 @@ ARG NPM_REMARK_PRESET_LINT_RECOMMENDED_VERSION=7.0.1
 ```
 
 - NPM packages (node.js):
-  - [remark-cli@${NPM_REMARK_CLI_VERSION}](https://www.npmjs.com/package/remark-cli@${NPM_REMARK_CLI_VERSION})
-  - [remark-preset-lint-recommended@${NPM_REMARK_PRESET_LINT_RECOMMENDED_VERSION}](https://www.npmjs.com/package/remark-preset-lint-recommended@${NPM_REMARK_PRESET_LINT_RECOMMENDED_VERSION})
+  - [remark-cli](https://www.npmjs.com/package/remark-cli)
+  - [remark-preset-lint-recommended](https://www.npmjs.com/package/remark-preset-lint-recommended)
diff --git a/docs/descriptors/puppet_puppet_lint.md b/docs/descriptors/puppet_puppet_lint.md
@@ -203,4 +203,4 @@ ARG GEM_PUPPET_LINT_VERSION=4.2.4
 ```
 
 - GEM packages (Ruby) :
-  - [puppet-lint:${GEM_PUPPET_LINT_VERSION}](https://rubygems.org/gems/puppet-lint:${GEM_PUPPET_LINT_VERSION})
+  - [puppet-lint:4.2.4](https://rubygems.org/gems/puppet-lint/versions/4.2.4)
diff --git a/docs/descriptors/python_bandit.md b/docs/descriptors/python_bandit.md
@@ -283,6 +283,6 @@ ARG PIP_BANDIT_SARIF_FORMATTER_VERSION=1.1.1
 ```
 
 - PIP packages (Python):
-  - [bandit==${PIP_BANDIT_VERSION}](https://pypi.org/project/bandit/${PIP_BANDIT_VERSION})
-  - [bandit_sarif_formatter==${PIP_BANDIT_SARIF_FORMATTER_VERSION}](https://pypi.org/project/bandit_sarif_formatter/${PIP_BANDIT_SARIF_FORMATTER_VERSION})
-  - [bandit[toml]==${PIP_BANDIT_VERSION}](https://pypi.org/project/bandit[toml]/${PIP_BANDIT_VERSION})
+  - [bandit==1.8.2](https://pypi.org/project/bandit/1.8.2)
+  - [bandit_sarif_formatter==1.1.1](https://pypi.org/project/bandit_sarif_formatter/1.1.1)
+  - [bandit[toml]==1.8.2](https://pypi.org/project/bandit[toml]/1.8.2)