fix: several fixes/improvements for python version selection (#2730)

* do not use free-threaded python by default
* document how to get free-threaded python via python-build
* add precompiled rc releases
* use precompiled install_only_stripped variants
* always use the latest precompiled build for a particular version
* remove duplicate precompiled versions
* dynamically add settings to node/python/ruby docs

Fixes #2716

.prettierignore

@@ -1,2 +1,3 @@
+CHANGELOG.md
 .venv
 registry/

docs/.vitepress/cli_commands.ts

@@ -2,107 +2,107 @@
 // Do not edit this file directly
 
 export type Command = {
-  hide: boolean,
+  hide: boolean;
   subcommands?: {
-    [key: string]: Command,
-  },
+    [key: string]: Command;
+  };
 };
 export const commands: { [key: string]: Command } = {
-  "activate": {
+  activate: {
     hide: false,
   },
-  "alias": {
+  alias: {
     hide: false,
     subcommands: {
-      "get": {
+      get: {
         hide: false,
       },
-      "ls": {
+      ls: {
         hide: false,
       },
-      "set": {
+      set: {
         hide: false,
       },
-      "unset": {
+      unset: {
         hide: false,
       },
     },
   },
-  "asdf": {
+  asdf: {
     hide: true,
   },
-  "backends": {
+  backends: {
     hide: false,
     subcommands: {
-      "ls": {
+      ls: {
         hide: false,
       },
     },
   },
   "bin-paths": {
     hide: false,
   },
-  "cache": {
+  cache: {
     hide: false,
     subcommands: {
-      "clear": {
+      clear: {
         hide: false,
       },
-      "prune": {
+      prune: {
         hide: false,
       },
     },
   },
-  "completion": {
+  completion: {
     hide: false,
   },
-  "config": {
+  config: {
     hide: false,
     subcommands: {
-      "generate": {
+      generate: {
         hide: false,
       },
-      "get": {
+      get: {
         hide: false,
       },
-      "ls": {
+      ls: {
         hide: false,
       },
-      "set": {
+      set: {
         hide: false,
       },
     },
   },
-  "current": {
+  current: {
     hide: false,
   },
-  "deactivate": {
+  deactivate: {
     hide: false,
   },
-  "direnv": {
+  direnv: {
     hide: false,
     subcommands: {
-      "envrc": {
+      envrc: {
         hide: true,
       },
-      "exec": {
+      exec: {
         hide: true,
       },
-      "activate": {
+      activate: {
         hide: false,
       },
     },
   },
-  "doctor": {
+  doctor: {
     hide: false,
   },
-  "env": {
+  env: {
     hide: false,
   },
-  "exec": {
+  exec: {
     hide: false,
   },
-  "generate": {
+  generate: {
     hide: false,
     subcommands: {
       "git-pre-commit": {
@@ -116,7 +116,7 @@ export const commands: { [key: string]: Command } = {
       },
     },
   },
-  "global": {
+  global: {
     hide: true,
   },
   "hook-env": {
@@ -125,57 +125,57 @@ export const commands: { [key: string]: Command } = {
   "hook-not-found": {
     hide: true,
   },
-  "implode": {
+  implode: {
     hide: false,
   },
-  "install": {
+  install: {
     hide: false,
   },
-  "latest": {
+  latest: {
     hide: false,
   },
-  "link": {
+  link: {
     hide: false,
   },
-  "local": {
+  local: {
     hide: true,
   },
-  "ls": {
+  ls: {
     hide: false,
   },
   "ls-remote": {
     hide: false,
   },
-  "outdated": {
+  outdated: {
     hide: false,
   },
-  "plugins": {
+  plugins: {
     hide: false,
     subcommands: {
-      "install": {
+      install: {
         hide: false,
       },
-      "link": {
+      link: {
         hide: false,
       },
-      "ls": {
+      ls: {
         hide: false,
       },
       "ls-remote": {
         hide: false,
       },
-      "uninstall": {
+      uninstall: {
         hide: false,
       },
-      "update": {
+      update: {
         hide: false,
       },
     },
   },
-  "prune": {
+  prune: {
     hide: false,
   },
-  "registry": {
+  registry: {
     hide: false,
   },
   "render-help": {
@@ -184,97 +184,97 @@ export const commands: { [key: string]: Command } = {
   "render-mangen": {
     hide: true,
   },
-  "reshim": {
+  reshim: {
     hide: false,
   },
-  "run": {
+  run: {
     hide: false,
   },
   "self-update": {
     hide: false,
   },
-  "set": {
+  set: {
     hide: false,
   },
-  "settings": {
+  settings: {
     hide: false,
     subcommands: {
-      "get": {
+      get: {
         hide: false,
       },
-      "ls": {
+      ls: {
         hide: false,
       },
-      "set": {
+      set: {
         hide: false,
       },
-      "unset": {
+      unset: {
         hide: false,
       },
     },
   },
-  "shell": {
+  shell: {
     hide: false,
   },
-  "sync": {
+  sync: {
     hide: false,
     subcommands: {
-      "node": {
+      node: {
         hide: false,
       },
-      "python": {
+      python: {
         hide: false,
       },
     },
   },
-  "tasks": {
+  tasks: {
     hide: false,
     subcommands: {
-      "deps": {
+      deps: {
         hide: false,
       },
-      "edit": {
+      edit: {
         hide: false,
       },
-      "info": {
+      info: {
         hide: false,
       },
-      "ls": {
+      ls: {
         hide: false,
       },
-      "run": {
+      run: {
         hide: false,
       },
     },
   },
-  "trust": {
+  trust: {
     hide: false,
   },
-  "uninstall": {
+  uninstall: {
     hide: false,
   },
-  "unset": {
+  unset: {
     hide: false,
   },
-  "upgrade": {
+  upgrade: {
     hide: false,
   },
-  "usage": {
+  usage: {
     hide: true,
   },
-  "use": {
+  use: {
     hide: false,
   },
-  "version": {
+  version: {
     hide: false,
   },
-  "watch": {
+  watch: {
     hide: false,
   },
-  "where": {
+  where: {
     hide: false,
   },
-  "which": {
+  which: {
     hide: false,
   },
 };

docs/components/setting.vue

@@ -0,0 +1,38 @@
+<script setup>
+defineProps(["setting", "level"]);
+</script>
+
+<template>
+  <h2 v-if="level === 2">
+    <code>{{ setting.key }}</code>
+    <span v-if="setting.deprecated" class="VPBadge warning">deprecated</span>
+  </h2>
+  <h3 v-if="level === 3">
+    <code>{{ setting.key }}</code>
+    <span v-if="setting.deprecated" class="VPBadge warning">deprecated</span>
+  </h3>
+
+  <ul>
+    <li>
+      Type: <code>{{ setting.type }}</code>
+      <span v-if="setting.optional">(optional)</span>
+    </li>
+    <li>
+      Env: <code>{{ setting.env }}</code>
+    </li>
+    <li>
+      Default: <code>{{ setting.default }}</code>
+    </li>
+    <li v-if="setting.deprecated">Deprecated: {{ setting.deprecated }}</li>
+    <li v-if="setting.enum">
+      Choices:
+      <ul>
+        <li v-for="choice in setting.enum">
+          <code>{{ choice[0] }}</code> – {{ choice[1] }}
+        </li>
+      </ul>
+    </li>
+  </ul>
+
+  <span v-html="setting.docs"></span>
+</template>