From e33fea221b9183e2b471ed7cfae3577f40b8afaa Mon Sep 17 00:00:00 2001
From: Jeff Dickey <216188+jdx@users.noreply.github.com>
Date: Sat, 12 Oct 2024 08:33:38 -0500
Subject: [PATCH] fix: several fixes/improvements for python version selection

* 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
---
 .idea/inspectionProfiles/Project_Default.xml |   1 +
 .prettierignore                              |   1 +
 docs/.vitepress/cli_commands.ts              | 150 +++++++++----------
 docs/components/setting.vue                  |  38 +++++
 docs/lang/node.md                            |  18 ++-
 docs/lang/python.md                          |  93 +++---------
 docs/lang/ruby.md                            |  67 +--------
 docs/settings.data.ts                        |  42 +++---
 docs/settings.md                             |  51 +------
 schema/mise.json                             |  80 +++++++---
 settings.toml                                |  86 +++++++++--
 src/cli/render_help.rs                       |   1 +
 src/config/env_directive.rs                  |   2 +-
 src/config/settings.rs                       |  34 ++++-
 src/plugins/core/python.rs                   |  79 +++++-----
 src/task/mod.rs                              |   2 +-
 tasks.md                                     |  28 ++--
 tasks/render/settings                        |  59 +++++---
 18 files changed, 441 insertions(+), 391 deletions(-)
 create mode 100644 docs/components/setting.vue

diff --git a/.idea/inspectionProfiles/Project_Default.xml b/.idea/inspectionProfiles/Project_Default.xml
index d4650aa421..838570d852 100644
--- a/.idea/inspectionProfiles/Project_Default.xml
+++ b/.idea/inspectionProfiles/Project_Default.xml
@@ -1,6 +1,7 @@
 <component name="InspectionProjectProfileManager">
   <profile version="1.0">
     <option name="myName" value="Project Default" />
+    <inspection_tool class="CheckEmptyScriptTag" enabled="false" level="WARNING" enabled_by_default="false" />
     <inspection_tool class="DuplicatedCode" enabled="false" level="WEAK WARNING" enabled_by_default="false">
       <Languages>
         <language minSize="55" name="Rust" />
diff --git a/.prettierignore b/.prettierignore
index 46567fa117..d9942f3836 100644
--- a/.prettierignore
+++ b/.prettierignore
@@ -1,2 +1,3 @@
+CHANGELOG.md
 .venv
 registry/
diff --git a/docs/.vitepress/cli_commands.ts b/docs/.vitepress/cli_commands.ts
index edbff82df0..2806ee16a6 100644
--- a/docs/.vitepress/cli_commands.ts
+++ b/docs/.vitepress/cli_commands.ts
@@ -2,39 +2,39 @@
 // 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,
       },
     },
@@ -42,67 +42,67 @@ export const commands: { [key: string]: Command } = {
   "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,
   },
 };
diff --git a/docs/components/setting.vue b/docs/components/setting.vue
new file mode 100644
index 0000000000..10f7a788bb
--- /dev/null
+++ b/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>
diff --git a/docs/lang/node.md b/docs/lang/node.md
index 495a6b2da9..2f67f1264d 100644
--- a/docs/lang/node.md
+++ b/docs/lang/node.md
@@ -24,18 +24,32 @@ required system dependencies.
 
 ## Configuration
 
+<script setup>
+import { data } from '/settings.data.ts';
+import Setting from '/components/Setting.vue';
+
+const settings = data.find(s => s.key === 'node').settings;
+
+</script>
+
+<Setting v-for="setting in settings" :setting="setting" :key="setting.key" :level="3" />
+
+### Environment Variables
+
 - `MISE_NODE_VERIFY` [bool]: Verify the downloaded assets using GPG. Defaults to `true`.
 - `MISE_NODE_NINJA` [bool]: Use ninja instead of make to compile node. Defaults to `true` if installed.
-- `MISE_NODE_COMPILE` [bool]: Forces compilation from source instead of preferring pre-compiled binaries. Can also be set across all languages with [`MISE_NODE__COMPILE`](https://github.com/jdx/mise#mise_node_compile1)
 - `MISE_NODE_CONCURRENCY` [uint]: How many jobs should be used in compilation. Defaults to half the computer cores
 - `MISE_NODE_DEFAULT_PACKAGES_FILE` [string]: location of default packages file, defaults to `$HOME/.default-npm-packages`
-- `MISE_NODE_MIRROR_URL` [string]: overrides the default mirror used for downloading the distributions
 - `MISE_NODE_CFLAGS` [string]: Additional CFLAGS options (e.g., to override -O3).
 - `MISE_NODE_CONFIGURE_OPTS` [string]: Additional `./configure` options.
 - `MISE_NODE_MAKE_OPTS` [string]: Additional `make` options.
 - `MISE_NODE_MAKE_INSTALL_OPTS` [string]: Additional `make install` options.
 - `MISE_NODE_COREPACK` [bool]: Installs the default corepack shims after installing any node version that ships with [corepack](https://github.com/nodejs/corepack).
 
+::: info
+TODO: these env vars should be migrated to compatible settings in the future.
+:::
+
 ## Default node packages
 
 mise-node can automatically install a default set of npm packages right after installing a node version. To enable this feature, provide a `$HOME/.default-npm-packages` file that lists one package per line, for example:
diff --git a/docs/lang/python.md b/docs/lang/python.md
index 0f571184f5..f6f38d5a3e 100644
--- a/docs/lang/python.md
+++ b/docs/lang/python.md
@@ -34,83 +34,14 @@ additional to that python in mise has a few extra configuration variables.
 
 Set these with `mise settings set [VARIABLE] [VALUE]` or by setting the environment variable.
 
-### `python_pyenv_repo`
+<script setup>
+import { data } from '/settings.data.ts';
+import Setting from '/components/Setting.vue';
 
-* Type: `string`
-* Env: `MISE_PYENV_REPO`
-* Default: `https://github.com/pyenv/pyenv.git`
+const settings = data.find(s => s.key === 'python').settings;
+</script>
 
-The pyenv repo to get python-build from.
-
-### `python_compile`
-
-* Type: `bool`
-* Env: `MISE_PYTHON_COMPILE`
-* Default: [undefined]
-* Values:
-  * `true` - always compile with python-build instead of downloading [precompiled binaries](#precompiled-python-binaries).
-  * `false` - always download precompiled binaries.
-  * [undefined] - use precompiled binary if one is available for the current platform, compile otherwise.
-
-### `python_precompiled_os`
-
-* Type: `string`
-* Env: `MISE_PYTHON_PRECOMPILED_OS`
-* Default: `"apple-darwin" | "unknown-linux-gnu" | "unknown-linux-musl"`
-
-Specify the OS to use for precompiled binaries.
-
-### `python_precompiled_arch`
-
-* Type: `string`
-* Env: `MISE_PYTHON_PRECOMPILED_ARCH`
-* Default: `"x86_64_v3" | "aarch64"`
-
-Specify the architecture to use for precompiled binaries. If on an old CPU, you may want to set this
-to
-`"x86_64"` for the most compatible binaries.
-See <https://gregoryszorc.com/docs/python-build-standalone/main/running.html> for more information.
-
-### `python_patch_url`
-
-* Type: `string`
-* Env: `MISE_PYTHON_PATCH_URL`
-
-A url to a patch file to pass to python-build.
-
-### `python_patches_directory`
-
-* Type: `string`
-* Env: `MISE_PYTHON_PATCHES_DIRECTORY`
-
-A local directory containing patch files to pass to python-build.
-
-### `python_default_packages_file`
-
-* Type: `string`
-* Env: `MISE_PYTHON_DEFAULT_PACKAGES_FILE`
-* Default: `$HOME/.default-python-packages`
-
-Packages list to install with pip after installing a Python version.
-
-### `python_venv_auto_create` <Badge type="warning" text="deprecated" />
-
-* Type: `bool`
-* Env: `MISE_PYTHON_VENV_AUTO_CREATE`
-* Default: `false`
-
-Automatically create a virtualenv in the directory specified by `_.python.venv` if it doesn't exist.
-
-Deprecated note: Use `env._python.venv` instead.
-
-### `python_venv_stdlib`
-
-* Type: `bool`
-* Env: `MISE_PYTHON_VENV_STDLIB`
-* Default: `false`
-
-Prefer to use venv from Python's standard library.
-By default, mise will prioritize `uv` for the virtual environment if `uv` is in the `PATH`.
+<Setting v-for="setting in settings" :setting="setting" :key="setting.key" :level="3" />
 
 ## Default Python packages
 
@@ -139,7 +70,7 @@ That said, there are
 some [quirks](https://github.com/indygreg/python-build-standalone/blob/main/docs/quirks.rst)
 with the precompiled binaries to be aware of.
 
-If you'd like to disable these binaries, set [`python_compile`](#python_compile) to `true`.
+If you'd like to disable these binaries, set `mise settings set python.compile 1`.
 
 These binaries may not work on older CPUs however you may opt into binaries which
 are more compatible with older CPUs by setting `MISE_PYTHON_PRECOMPILED_ARCH` with
@@ -212,3 +143,13 @@ _.python.venv = { path = ".venv", create = true } # create the venv if it doesn'
 ```
 
 The venv will need to be created manually with `python -m venv /path/to/venv` unless `create=true`.
+
+## Installing free-threaded python
+
+Free-threaded python can be installed via python-build by running the following:
+
+```bash
+MISE_PYTHON_COMPILE=1 PYTHON_BUILD_FREE_THREADING=1 mise install
+```
+
+Currently, they are not supported with precompiled binaries.
diff --git a/docs/lang/ruby.md b/docs/lang/ruby.md
index b381754712..61e4930731 100644
--- a/docs/lang/ruby.md
+++ b/docs/lang/ruby.md
@@ -29,69 +29,14 @@ for additional settings and some troubleshooting.
 [handful of settings](https://github.com/rbenv/ruby-build?tab=readme-ov-file#custom-build-configuration),
 in additional to that mise has a few extra settings:
 
-### `ruby.apply_patches`
+<script setup>
+import { data } from '/settings.data.ts';
+import Setting from '/components/Setting.vue';
 
-* Type: `Option<String>`
-* Env: `MISE_RUBY_APPLY_PATCHES`
-* Default: `None`
+const settings = data.find(s => s.key === 'ruby').settings;
+</script>
 
-A list of patches (files or URLs) to apply to the ruby source code.
-
-### `ruby.verbose_install`
-
-* Type: `Option<bool>`
-* Env: `MISE_RUBY_VERBOSE_INSTALL`
-* Default: `None` (behaves like `false` unless --verbose is passed to mise)
-
-Show verbose output during installation (passes --verbose to ruby-build)
-
-### `ruby.ruby_build_repo`
-
-* Type: `String`
-* Env: `MISE_RUBY_BUILD_REPO`
-* Default: `https://github.com/rbenv/ruby-build.git`
-
-The git repository to use for getting ruby-build.
-
-### `ruby.ruby_build_opts`
-
-* Type: `Option<String>`
-* Env: `MISE_RUBY_BUILD_OPTS`
-* Default: `None`
-
-Command line options to pass to ruby-build when installing
-
-### `ruby.ruby_install`
-
-* Type: `bool`
-* Env: `MISE_RUBY_INSTALL`
-* Default: `false`
-
-Build with [ruby-install](https://github.com/postmodern/ruby-install) instead of [ruby-build](https://github.com/rbenv/ruby-build).
-
-### `ruby.ruby_install_repo`
-
-* Type: `String`
-* Env: `MISE_RUBY_INSTALL_REPO`
-* Default: `https://github.com/postmodern/ruby-install.git`
-
-The git repository to use for getting ruby-install.
-
-### `ruby.ruby_install_opts`
-
-* Type: `Option<String>`
-* Env: `MISE_RUBY_INSTALL_OPTS`
-* Default: `None`
-
-Command line options to pass to ruby-install when installing (if MISE_RUBY_INSTALL=1)
-
-### `ruby.default_packages_file`
-
-* Type: `String`
-* Env: `MISE_RUBY_DEFAULT_PACKAGES_FILE`
-* Default: `$HOME/.default-gems`
-
-Location of file containing a list of gems to install after installing a new ruby version.
+<Setting v-for="setting in settings" :setting="setting" :key="setting.key" :level="3" />
 
 ## Default gems
 
diff --git a/docs/settings.data.ts b/docs/settings.data.ts
index 5b672cd40d..1d58314c2f 100644
--- a/docs/settings.data.ts
+++ b/docs/settings.data.ts
@@ -1,37 +1,41 @@
-import * as fs from 'node:fs';
-import * as toml from 'toml';
-import markdownit from 'markdown-it'
+import * as fs from "node:fs";
+import * as toml from "toml";
+import markdownit from "markdown-it";
 
 const md = markdownit();
 
 export default {
-  watch: ['./settings.toml'],
+  watch: ["./settings.toml"],
   load() {
     const settings = {};
-    const raw = fs.readFileSync('./settings.toml', 'utf-8');
+    const raw = fs.readFileSync("./settings.toml", "utf-8");
     const doc = toml.parse(raw);
 
     function buildElement(key, props) {
       let type = props.type;
       let optional = false;
-      if (type.startsWith('Option<')) {
+      if (type.startsWith("Option<")) {
         type = type.slice(7, -1);
         optional = true;
       }
-      type = type.replaceAll('PathBuf', 'String');
+      type = type.replaceAll("PathBuf", "String");
       let default_ = props.default;
-      if (default_ === undefined && type === 'bool' && !optional) {
+      if (default_ === undefined && type === "bool" && !optional) {
         default_ = false;
       }
       if (default_ === undefined && optional) {
         default_ = "None";
       }
-      if (type === 'u64' || type === 'usize') {
-        type = 'integer';
-      } else if (type === 'String') {
-        type = 'string';
-      } else if (type === "BTreeSet<String>" || type === "HashSet<String>" || type === "Vec<String>") {
-        type = 'string[]';
+      if (type === "u64" || type === "usize") {
+        type = "integer";
+      } else if (type === "String") {
+        type = "string";
+      } else if (
+        type === "BTreeSet<String>" ||
+        type === "HashSet<String>" ||
+        type === "Vec<String>"
+      ) {
+        type = "string[]";
       }
       // } else if (type === "String" || type === "PathBuf") {
       //   type = 'string';
@@ -67,10 +71,12 @@ export default {
             description: props.description,
             settings: [],
           };
-          settings[key].settings.push(buildElement(`${key}.${subkey}`, props[subkey]));
+          settings[key].settings.push(
+            buildElement(`${key}.${subkey}`, props[subkey]),
+          );
         }
       }
     }
-    return Object.values(settings);
-  }
-}
+    return Object.values(settings).sort((a, b) => a.key.localeCompare(b.key));
+  },
+};
diff --git a/docs/settings.md b/docs/settings.md
index 371a73ae7c..2e4d0c95bd 100644
--- a/docs/settings.md
+++ b/docs/settings.md
@@ -1,7 +1,8 @@
 # Settings
 
 <script setup>
-import { data } from './settings.data.ts'
+import { data } from '/settings.data.ts';
+import Setting from '/components/Setting.vue';
 </script>
 
 The following is a list of all of mise's settings. These can be set via `mise settings set`,
@@ -9,51 +10,9 @@ by directly modifying `~/.config/mise/config.toml` or local config, or via envir
 
 Some of them also can be set via global CLI flags.
 
-<div v-for="setting in data.filter(f => f.type)">
-  <h2>
-    <code>{{ setting.key }}</code>
-    <span v-if="setting.deprecated" class="VPBadge warning">deprecated</span>
-  </h2>
-
-  <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.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>
-</div>
+<Setting v-for="setting in data.filter(f => f.type)" :setting="setting" :key="setting.key" :level="2" />
 
 <div v-for="child in data.filter(f => !f.type)">
-  <h2>
-    <code>{{ child.key }}</code>
-  </h2>
-  <div v-for="setting in child.settings">
-    <h3>
-      <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.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>
-  </div>
+  <h2><code>{{ child.key }}</code></h2>
+  <Setting v-for="setting in child.settings" :setting="setting" :key="setting.key" :level="3" />
 </div>
diff --git a/schema/mise.json b/schema/mise.json
index 2b2c668b7e..30fc3da1ea 100644
--- a/schema/mise.json
+++ b/schema/mise.json
@@ -14,9 +14,7 @@
             "type": "number"
           },
           {
-            "enum": [
-              false
-            ],
+            "enum": [false],
             "type": "boolean"
           }
         ]
@@ -80,9 +78,7 @@
                           "type": "string"
                         }
                       },
-                      "required": [
-                        "path"
-                      ],
+                      "required": ["path"],
                       "type": "object"
                     }
                   ]
@@ -259,13 +255,7 @@
           "default": "info",
           "description": "Show more/less output.",
           "type": "string",
-          "enum": [
-            "trace",
-            "debug",
-            "info",
-            "warn",
-            "error"
-          ]
+          "enum": ["trace", "debug", "info", "warn", "error"]
         },
         "node": {
           "additionalProperties": false,
@@ -306,33 +296,82 @@
           "description": "How long to wait before updating plugins automatically (note this isn't currently implemented).",
           "type": "string"
         },
+        "python": {
+          "additionalProperties": false,
+          "properties": {
+            "compile": {
+              "description": "If true, compile python from source. If false, use precompiled binaries. If not set, use precompiled binaries if available.",
+              "type": "boolean"
+            },
+            "default_packages_file": {
+              "description": "Path to a file containing default python packages to install when installing a python version.",
+              "type": "string"
+            },
+            "patch_url": {
+              "description": "URL to fetch python patches from to pass to python-build.",
+              "type": "string"
+            },
+            "patches_directory": {
+              "description": "Directory to fetch python patches from.",
+              "type": "string"
+            },
+            "precompiled_arch": {
+              "description": "Specify the architecture to use for precompiled binaries.",
+              "type": "string"
+            },
+            "precompiled_os": {
+              "description": "Specify the OS to use for precompiled binaries.",
+              "type": "string"
+            },
+            "pyenv_repo": {
+              "default": "https://github.com/pyenv/pyenv.git",
+              "description": "URL to fetch pyenv from for compiling python with python-build.",
+              "type": "string"
+            },
+            "venv_auto_create": {
+              "description": "Automatically create virtualenvs for python tools.",
+              "deprecated": "Use env._python.venv instead.",
+              "type": "boolean"
+            },
+            "venv_stdlib": {
+              "description": "Prefer to use venv from Python's standard library.",
+              "type": "boolean"
+            }
+          }
+        },
         "python_compile": {
           "description": "If true, compile python from source. If false, use precompiled binaries. If not set, use precompiled binaries if available.",
+          "deprecated": "Use python.compile instead.",
           "type": "boolean"
         },
         "python_default_packages_file": {
           "description": "Path to a file containing default python packages to install when installing python.",
+          "deprecated": "Use python.default_packages_file instead.",
           "type": "string"
         },
         "python_patch_url": {
           "description": "URL to fetch python patches from.",
+          "deprecated": "Use python.patch_url instead.",
           "type": "string"
         },
         "python_patches_directory": {
           "description": "Directory to fetch python patches from.",
+          "deprecated": "Use python.patch_url instead.",
           "type": "string"
         },
         "python_precompiled_arch": {
           "description": "Specify the architecture to use for precompiled binaries.",
+          "deprecated": "Use python.precompiled_arch instead.",
           "type": "string"
         },
         "python_precompiled_os": {
           "description": "Specify the OS to use for precompiled binaries.",
+          "deprecated": "Use python.precompiled_os instead.",
           "type": "string"
         },
         "python_pyenv_repo": {
-          "default": "https://github.com/pyenv/pyenv.git",
           "description": "URL to fetch pyenv from for compiling python.",
+          "deprecated": "Use python.pyenv_repo instead.",
           "type": "string"
         },
         "python_venv_auto_create": {
@@ -417,10 +456,7 @@
         "task_output": {
           "description": "Change output style when executing tasks.",
           "type": "string",
-          "enum": [
-            "prefix",
-            "interleave"
-          ]
+          "enum": ["prefix", "interleave"]
         },
         "trace": {
           "description": "Sets log level to trace",
@@ -512,9 +548,7 @@
                     "type": "number"
                   },
                   {
-                    "enum": [
-                      false
-                    ],
+                    "enum": [false],
                     "type": "boolean"
                   }
                 ]
@@ -599,9 +633,7 @@
               "type": "string"
             }
           },
-          "required": [
-            "version"
-          ],
+          "required": ["version"],
           "type": "object"
         }
       ]
diff --git a/settings.toml b/settings.toml
index bc4a6215c7..9f7fd2d9fa 100644
--- a/settings.toml
+++ b/settings.toml
@@ -329,56 +329,118 @@ type = "String"
 default = "7d"
 description = "How long to wait before updating plugins automatically (note this isn't currently implemented)."
 
-[python_compile]
+[python.compile]
 env = "MISE_PYTHON_COMPILE"
 type = "Option<bool>"
 description = "If true, compile python from source. If false, use precompiled binaries. If not set, use precompiled binaries if available."
+docs = """
+* Values:
+  * `true` - always compile with python-build instead of downloading [precompiled binaries](#precompiled-python-binaries).
+  * `false` - always download precompiled binaries.
+  * [undefined] - use precompiled binary if one is available for the current platform, compile otherwise.
+"""
 
-[python_default_packages_file]
+[python.default_packages_file]
 env = "MISE_PYTHON_DEFAULT_PACKAGES_FILE"
 type = "Option<PathBuf>"
-description = "Path to a file containing default python packages to install when installing python."
+description = "Path to a file containing default python packages to install when installing a python version."
 
-[python_patch_url]
+[python.patch_url]
 env = "MISE_PYTHON_PATCH_URL"
 type = "Option<String>"
-description = "URL to fetch python patches from."
+description = "URL to fetch python patches from to pass to python-build."
 
-[python_patches_directory]
+[python.patches_directory]
 env = "MISE_PYTHON_PATCHES_DIRECTORY"
 type = "Option<PathBuf>"
 description = "Directory to fetch python patches from."
 
-[python_precompiled_arch]
+[python.precompiled_arch]
 env = "MISE_PYTHON_PRECOMPILED_ARCH"
 type = "Option<String>"
 description = "Specify the architecture to use for precompiled binaries."
 default_docs = '"apple-darwin" | "unknown-linux-gnu" | "unknown-linux-musl"'
 
-[python_precompiled_os]
+[python.precompiled_os]
 env = "MISE_PYTHON_PRECOMPILED_OS"
 type = "Option<String>"
 default_docs = '"x86_64_v3" | "aarch64"'
 description = "Specify the OS to use for precompiled binaries."
+docs = """
+Specify the architecture to use for precompiled binaries. If on an old CPU, you may want to set this to "x86_64" for the most compatible binaries. See https://gregoryszorc.com/docs/python-build-standalone/main/running.html for more information.
+"""
 
-[python_pyenv_repo]
+[python.pyenv_repo]
 env = "MISE_PYENV_REPO"
 type = "String"
 default = "https://github.com/pyenv/pyenv.git"
-description = "URL to fetch pyenv from for compiling python."
+description = "URL to fetch pyenv from for compiling python with python-build."
 
-[python_venv_auto_create]
+[python.venv_auto_create]
 env = "MISE_PYTHON_VENV_AUTO_CREATE"
 type = "bool"
 hide = true
 deprecated = "Use env._python.venv instead."
 description = "Automatically create virtualenvs for python tools."
 
-[python_venv_stdlib]
+[python.venv_stdlib]
 env = "MISE_VENV_STDLIB"
 type = "bool"
 description = "Prefer to use venv from Python's standard library."
 
+[python_compile]
+type = "Option<bool>"
+description = "If true, compile python from source. If false, use precompiled binaries. If not set, use precompiled binaries if available."
+deprecated = "Use python.compile instead."
+hide = true
+
+[python_default_packages_file]
+type = "Option<PathBuf>"
+description = "Path to a file containing default python packages to install when installing python."
+deprecated = "Use python.default_packages_file instead."
+hide = true
+
+[python_patch_url]
+type = "Option<String>"
+description = "URL to fetch python patches from."
+deprecated = "Use python.patch_url instead."
+hide = true
+
+[python_patches_directory]
+type = "Option<PathBuf>"
+description = "Directory to fetch python patches from."
+deprecated = "Use python.patch_url instead."
+hide = true
+
+[python_precompiled_arch]
+type = "Option<String>"
+description = "Specify the architecture to use for precompiled binaries."
+deprecated = "Use python.precompiled_arch instead."
+hide = true
+
+[python_precompiled_os]
+type = "Option<String>"
+description = "Specify the OS to use for precompiled binaries."
+deprecated = "Use python.precompiled_os instead."
+hide = true
+
+[python_pyenv_repo]
+type = "Option<String>"
+description = "URL to fetch pyenv from for compiling python."
+deprecated = "Use python.pyenv_repo instead."
+hide = true
+
+[python_venv_auto_create]
+type = "Option<bool>"
+hide = true
+deprecated = "Use env._python.venv instead."
+description = "Automatically create virtualenvs for python tools."
+
+[python_venv_stdlib]
+type = "Option<bool>"
+description = "Prefer to use venv from Python's standard library."
+hide = true
+
 [quiet]
 env = "MISE_QUIET"
 type = "bool"
diff --git a/src/cli/render_help.rs b/src/cli/render_help.rs
index 68363b67ca..919139e543 100644
--- a/src/cli/render_help.rs
+++ b/src/cli/render_help.rs
@@ -15,6 +15,7 @@ impl RenderHelp {
         xx::file::mkdirp("docs/.vitepress")?;
 
         file::write("docs/.vitepress/cli_commands.ts", render_command_ts())?;
+        cmd!("prettier", "--write", "docs/.vitepress/cli_commands.ts").run()?;
         Ok(())
     }
 }
diff --git a/src/config/env_directive.rs b/src/config/env_directive.rs
index ac0a4e7ece..ac2f604504 100644
--- a/src/config/env_directive.rs
+++ b/src/config/env_directive.rs
@@ -266,7 +266,7 @@ impl EnvResults {
                             debug!("python not installed, skipping venv creation");
                         } else {
                             let cmd = if let (false, Some(_uv_in_path)) =
-                                (SETTINGS.python_venv_stdlib, which_non_pristine("uv"))
+                                (SETTINGS.python.venv_stdlib, which_non_pristine("uv"))
                             {
                                 CmdLineRunner::new("uv").args(["venv", &venv.to_string_lossy()])
                             } else {
diff --git a/src/config/settings.rs b/src/config/settings.rs
index 4480862d20..bfcac78fd8 100644
--- a/src/config/settings.rs
+++ b/src/config/settings.rs
@@ -126,14 +126,44 @@ impl Settings {
         }
         if settings.all_compile {
             settings.node.compile = Some(true);
-            if settings.python_compile.is_none() {
-                settings.python_compile = Some(true);
+            if settings.python.compile.is_none() {
+                settings.python.compile = Some(true);
             }
         }
+        settings.set_python_config();
         let settings = Arc::new(settings);
         *BASE_SETTINGS.write().unwrap() = Some(settings.clone());
         Ok(settings)
     }
+
+    /// Sets deprecated python_* settings to the new python.* settings
+    fn set_python_config(&mut self) {
+        if let Some(python_compile) = self.python_compile {
+            self.python.compile = Some(python_compile);
+        }
+        if let Some(python_default_packages_file) = &self.python_default_packages_file {
+            self.python.default_packages_file = Some(python_default_packages_file.clone());
+        }
+        if let Some(python_patch_url) = &self.python_patch_url {
+            self.python.patch_url = Some(python_patch_url.clone());
+        }
+        if let Some(python_patches_directory) = &self.python_patches_directory {
+            self.python.patches_directory = Some(python_patches_directory.clone());
+        }
+        if let Some(python_precompiled_arch) = &self.python_precompiled_arch {
+            self.python.precompiled_arch = Some(python_precompiled_arch.clone());
+        }
+        if let Some(python_precompiled_os) = &self.python_precompiled_os {
+            self.python.precompiled_os = Some(python_precompiled_os.clone());
+        }
+        if let Some(python_pyenv_repo) = &self.python_pyenv_repo {
+            self.python.pyenv_repo = python_pyenv_repo.clone();
+        }
+        if let Some(python_venv_auto_create) = self.python_venv_auto_create {
+            self.python.venv_auto_create = python_venv_auto_create;
+        }
+    }
+
     pub fn add_cli_matches(m: &clap::ArgMatches) {
         let mut s = SettingsPartial::empty();
         for arg in &*env::ARGS.read().unwrap() {
diff --git a/src/plugins/core/python.rs b/src/plugins/core/python.rs
index 16e7b21596..d8678d5237 100644
--- a/src/plugins/core/python.rs
+++ b/src/plugins/core/python.rs
@@ -1,15 +1,10 @@
-use std::collections::BTreeMap;
-use std::path::{Path, PathBuf};
-
-use eyre::{bail, eyre};
-use itertools::Itertools;
-
 use crate::backend::Backend;
 use crate::build_time::built_info;
 use crate::cache::{CacheManager, CacheManagerBuilder};
 use crate::cli::args::BackendArg;
 use crate::cmd::CmdLineRunner;
-use crate::config::{Config, Settings};
+use crate::config::settings::SETTINGS;
+use crate::config::Config;
 use crate::file::display_path;
 use crate::git::Git;
 use crate::http::{HTTP, HTTP_FETCH};
@@ -18,6 +13,11 @@ use crate::plugins::core::CorePlugin;
 use crate::toolset::{ToolRequest, ToolVersion, Toolset};
 use crate::ui::progress_report::SingleReport;
 use crate::{cmd, env, file};
+use eyre::{bail, eyre};
+use itertools::Itertools;
+use std::collections::BTreeMap;
+use std::path::{Path, PathBuf};
+use versions::Versioning;
 
 #[derive(Debug)]
 pub struct PythonPlugin {
@@ -57,13 +57,12 @@ impl PythonPlugin {
         if self.python_build_bin().exists() {
             return Ok(());
         }
-        let settings = Settings::try_get()?;
         let python_build_path = self.python_build_path();
         debug!("Installing python-build to {}", python_build_path.display());
         file::remove_all(&python_build_path)?;
         file::create_dir_all(self.python_build_path().parent().unwrap())?;
         let git = Git::new(self.python_build_path());
-        git.clone(&settings.python_pyenv_repo)?;
+        git.clone(&SETTINGS.python.pyenv_repo)?;
         Ok(())
     }
     fn update_python_build(&self) -> eyre::Result<()> {
@@ -89,6 +88,8 @@ impl PythonPlugin {
             let output = cmd!(python_build_bin, "--definitions").read()?;
             let versions = output
                 .split('\n')
+                // remove free-threaded pythons like 3.13t and 3.14t-dev
+                .filter(|s| !regex!(r"\dt(-dev)?$").is_match(s))
                 .map(|s| s.to_string())
                 .sorted_by_cached_key(|v| regex!(r"^\d+").is_match(v))
                 .collect();
@@ -106,18 +107,20 @@ impl PythonPlugin {
 
     fn fetch_precompiled_remote_versions(&self) -> eyre::Result<&Vec<(String, String, String)>> {
         self.precompiled_cache.get_or_try_init(|| {
-            let settings = Settings::get();
-            let raw = match settings.paranoid {
+            let raw = match SETTINGS.paranoid {
                 true => HTTP_FETCH.get_text("https://mise-versions.jdx.dev/python-precompiled"),
                 // using http is not a security concern and enabling tls makes mise significantly slower
                 false => HTTP_FETCH.get_text("http://mise-versions.jdx.dev/python-precompiled"),
             }?;
-            let platform = format!("{}-{}", python_arch(&settings), python_os(&settings));
+            let arch = python_arch();
+            let os = python_os();
+            let platform = format!("{arch}-{os}-install_only_stripped");
             let versions = raw
                 .lines()
                 .filter(|v| v.contains(&platform))
                 .flat_map(|v| {
-                    regex!(r"^cpython-(\d+\.\d+\.\d+)\+(\d+).*")
+                    // cpython-3.9.5+20210525 or cpython-3.9.5rc3+20210525
+                    regex!(r"^cpython-(\d+\.\d+\.[\da-z]+)\+(\d+).*")
                         .captures(v)
                         .map(|caps| {
                             (
@@ -127,6 +130,13 @@ impl PythonPlugin {
                             )
                         })
                 })
+                // multiple dates can have the same version, so sort by date and remove duplicates by unique
+                .sorted_by_cached_key(|(v, date, _)| (Versioning::new(v), date.to_string()))
+                .rev()
+                .unique_by(|(v, _, _)| v.to_string())
+                .collect_vec() // collecting seems to be necessary for the unique_by to work
+                .into_iter()
+                .rev()
                 .collect_vec();
             Ok(versions)
         })
@@ -141,19 +151,19 @@ impl PythonPlugin {
         let (tag, filename) = match precompile_info {
             Some((_, tag, filename)) => (tag, filename),
             None => {
-                if cfg!(windows) || Settings::get().python_compile == Some(false) {
+                if cfg!(windows) || SETTINGS.python.compile == Some(false) {
                     if !cfg!(windows) {
                         hint!(
                             "python_compile",
                             "To compile python from source, run",
-                            "mise settings set python_compile 1"
+                            "mise settings set python.compile 1"
                         );
                     }
+                    let arch = python_arch();
+                    let os = python_os();
                     bail!(
-                        "no precompiled python found for {} on {}-{}",
-                        ctx.tv.version,
-                        python_arch(&Settings::get()),
-                        python_os(&Settings::get()),
+                        "no precompiled python found for {} on {arch}-{os}",
+                        ctx.tv.version
                     );
                 }
                 debug!("no precompiled python found for {}", ctx.tv.version);
@@ -168,7 +178,7 @@ impl PythonPlugin {
                 "python_precompiled",
                 "installing precompiled python from indygreg/python-build-standalone\n\
                 if you experience issues with this python (e.g.: running poetry), switch to python-build by running",
-                "mise settings set python_compile 1"
+                "mise settings set python.compile 1"
             );
         }
 
@@ -194,7 +204,6 @@ impl PythonPlugin {
 
     fn install_compiled(&self, ctx: &InstallContext) -> eyre::Result<()> {
         let config = Config::get();
-        let settings = Settings::get();
         self.install_or_update_python_build()?;
         if matches!(&ctx.tv.request, ToolRequest::Ref { .. }) {
             return Err(eyre!("Ref versions not supported for python"));
@@ -206,16 +215,16 @@ impl PythonPlugin {
             .arg(ctx.tv.install_path())
             .env("PIP_REQUIRE_VIRTUALENV", "false")
             .envs(config.env()?);
-        if settings.verbose {
+        if SETTINGS.verbose {
             cmd = cmd.arg("--verbose");
         }
-        if let Some(patch_url) = &settings.python_patch_url {
+        if let Some(patch_url) = &SETTINGS.python.patch_url {
             ctx.pr
                 .set_message(format!("with patch file from: {patch_url}"));
             let patch = HTTP.get_text(patch_url)?;
             cmd = cmd.arg("--patch").stdin_string(patch)
         }
-        if let Some(patches_dir) = &settings.python_patches_directory {
+        if let Some(patches_dir) = &SETTINGS.python.patches_directory {
             let patch_file = patches_dir.join(format!("{}.patch", &ctx.tv.version));
             if patch_file.exists() {
                 ctx.pr
@@ -261,8 +270,7 @@ impl PythonPlugin {
         pr: Option<&dyn SingleReport>,
     ) -> eyre::Result<Option<PathBuf>> {
         if let Some(virtualenv) = tv.request.options().get("virtualenv") {
-            let settings = Settings::try_get()?;
-            if !settings.experimental {
+            if !SETTINGS.experimental {
                 warn!(
                     "please enable experimental mode with `mise settings set experimental true` \
                     to use python virtualenv activation"
@@ -276,7 +284,7 @@ impl PythonPlugin {
                 }
             }
             if !virtualenv.exists() {
-                if settings.python_venv_auto_create {
+                if SETTINGS.python.venv_auto_create {
                     info!("setting up virtualenv at: {}", virtualenv.display());
                     let mut cmd = CmdLineRunner::new(self.python_path(tv))
                         .arg("-m")
@@ -340,7 +348,7 @@ impl Backend for PythonPlugin {
     }
 
     fn _list_remote_versions(&self) -> eyre::Result<Vec<String>> {
-        if Settings::get().python_compile == Some(false) {
+        if SETTINGS.python.compile == Some(false) {
             Ok(self
                 .fetch_precompiled_remote_versions()?
                 .iter()
@@ -365,8 +373,7 @@ impl Backend for PythonPlugin {
 
     fn install_version_impl(&self, ctx: &InstallContext) -> eyre::Result<()> {
         let config = Config::get();
-        let settings = Settings::try_get()?;
-        if cfg!(windows) || settings.python_compile == Some(true) {
+        if cfg!(windows) || SETTINGS.python.compile == Some(true) {
             self.install_compiled(ctx)?;
         } else {
             self.install_precompiled(ctx)?;
@@ -375,7 +382,7 @@ impl Backend for PythonPlugin {
         if let Err(e) = self.get_virtualenv(&config, &ctx.tv, Some(ctx.pr.as_ref())) {
             warn!("failed to get virtualenv: {e:#}");
         }
-        if let Some(default_file) = &settings.python_default_packages_file {
+        if let Some(default_file) = &SETTINGS.python.default_packages_file {
             if let Err(err) =
                 self.install_default_packages(&config, default_file, &ctx.tv, ctx.pr.as_ref())
             {
@@ -405,12 +412,12 @@ impl Backend for PythonPlugin {
     }
 }
 
-fn python_os(settings: &Settings) -> String {
-    if let Some(os) = &settings.python_precompiled_os {
+fn python_os() -> String {
+    if let Some(os) = &SETTINGS.python.precompiled_os {
         return os.clone();
     }
     if cfg!(windows) {
-        "pc-windows-msvc-shared-install_only_stripped".into()
+        "pc-windows-msvc-shared".into()
     } else if cfg!(target_os = "macos") {
         "apple-darwin".into()
     } else {
@@ -420,8 +427,8 @@ fn python_os(settings: &Settings) -> String {
     }
 }
 
-fn python_arch(settings: &Settings) -> &str {
-    if let Some(arch) = &settings.python_precompiled_arch {
+fn python_arch() -> &'static str {
+    if let Some(arch) = &SETTINGS.python.precompiled_arch {
         return arch.as_str();
     }
     if cfg!(windows) {
diff --git a/src/task/mod.rs b/src/task/mod.rs
index 3e7a9decdc..896c74b721 100644
--- a/src/task/mod.rs
+++ b/src/task/mod.rs
@@ -210,7 +210,7 @@ impl Task {
             && spec.cmd.before_help_long.is_none()
             && !self.depends.is_empty()
         {
-            spec.cmd.before_help_long = Some(format!("* Depends: {}", self.depends.join(", ")));
+            spec.cmd.before_help_long = Some(format!("- Depends: {}", self.depends.join(", ")));
         }
         spec.cmd.usage = spec.cmd.usage();
         Ok((spec, scripts))
diff --git a/tasks.md b/tasks.md
index f4dfdb7cc3..61b3d3753f 100644
--- a/tasks.md
+++ b/tasks.md
@@ -8,7 +8,7 @@
 
 ## `b1`
 
-* Depends: a1, a2
+- Depends: a1, a2
 
 **Usage**: `b1`
 
@@ -20,13 +20,13 @@
 
 ## `c1`
 
-* Depends: b1
+- Depends: b1
 
 **Usage**: `c1`
 
 ## `ci`
 
-* Depends: format, build, test
+- Depends: format, build, test
 
 **Usage**: `ci`
 
@@ -60,7 +60,7 @@ run mise inside of development docker container
 
 ## `docker:run`
 
-* Depends: docker:image
+- Depends: docker:image
 
 **Usage**: `docker:run`
 
@@ -68,7 +68,7 @@ run a command inside of development docker container
 
 ## `filetask`
 
-* Depends: lint, build
+- Depends: lint, build
 
 **Usage**: `filetask [-f --force] [-u --user <user>] <file> <arg_with_default>`
 
@@ -98,7 +98,7 @@ User to run as
 
 ## `lint`
 
-* Depends: lint:*
+- Depends: lint:*
 
 **Usage**: `lint`
 
@@ -146,7 +146,7 @@ User to run as
 
 ## `pre-commit`
 
-* Depends: render, lint
+- Depends: render, lint
 
 **Usage**: `pre-commit`
 
@@ -164,7 +164,7 @@ User to run as
 
 ## `render`
 
-* Depends: render:*
+- Depends: render:*
 
 **Usage**: `render`
 
@@ -172,25 +172,25 @@ User to run as
 
 ## `render:completions`
 
-* Depends: build, render:usage
+- Depends: build, render:usage
 
 **Usage**: `render:completions`
 
 ## `render:help`
 
-* Depends: build
+- Depends: build
 
 **Usage**: `render:help`
 
 ## `render:mangen`
 
-* Depends: build
+- Depends: build
 
 **Usage**: `render:mangen`
 
 ## `render:registry`
 
-* Depends: build
+- Depends: build
 
 **Usage**: `render:registry`
 
@@ -200,7 +200,7 @@ User to run as
 
 ## `render:usage`
 
-* Depends: build
+- Depends: build
 
 **Usage**: `render:usage`
 
@@ -234,7 +234,7 @@ run all tests with coverage report
 
 ## `test:e2e`
 
-* Depends: build
+- Depends: build
 
 **Usage**: `test:e2e`
 
diff --git a/tasks/render/settings b/tasks/render/settings
index 40eba834ee..f575cdc91c 100755
--- a/tasks/render/settings
+++ b/tasks/render/settings
@@ -1,27 +1,31 @@
 #!/usr/bin/env node
 
-const fs = require('fs');
-const toml = require('toml');
-const child_process = require('child_process');
-const Handlebars = require('handlebars');
+const fs = require("fs");
+const toml = require("toml");
+const child_process = require("child_process");
+const Handlebars = require("handlebars");
 
-const doc = toml.parse(fs.readFileSync('settings.toml', 'utf-8'));
+const doc = toml.parse(fs.readFileSync("settings.toml", "utf-8"));
 const settings = {};
 
 function buildElement(key, props) {
   let type = props.type;
-  if (type.startsWith('Option<')) {
+  if (type.startsWith("Option<")) {
     type = type.slice(7, -1);
   }
-  type = type.replaceAll('PathBuf', 'String');
-  if (type === 'bool') {
-    type = 'boolean';
+  type = type.replaceAll("PathBuf", "String");
+  if (type === "bool") {
+    type = "boolean";
   } else if (type === "String" || type === "PathBuf") {
-    type = 'string';
+    type = "string";
   } else if (type === "usize" || type === "u64") {
-    type = 'number';
-  } else if (type === "BTreeSet<String>" || type === "HashSet<String>" || type === "Vec<String>") {
-    type = 'string[]';
+    type = "number";
+  } else if (
+    type === "BTreeSet<String>" ||
+    type === "HashSet<String>" ||
+    type === "Vec<String>"
+  ) {
+    type = "string[]";
   } else {
     throw new Error(`Unknown type: ${type}`);
   }
@@ -38,10 +42,10 @@ function buildElement(key, props) {
   if (props.enum) {
     ele.enum = props.enum.map((e) => e[0]);
   }
-  if (type === 'string[]') {
-    ele.type = 'array';
+  if (type === "string[]") {
+    ele.type = "array";
     ele.items = {
-      type: 'string',
+      type: "string",
     };
   }
   return ele;
@@ -58,15 +62,24 @@ for (const key in doc) {
         description: props.description,
         properties: {},
       };
-      settings[key].properties[subkey] = buildElement(`${key}.${subkey}`, props[subkey]);
+      settings[key].properties[subkey] = buildElement(
+        `${key}.${subkey}`,
+        props[subkey],
+      );
     }
   }
 }
 
-const schema_tmpl = Handlebars.compile(fs.readFileSync('schema/mise.json.hbs', 'utf-8'));
-fs.writeFileSync('schema/mise.json.tmp', schema_tmpl({
-  settings_json: new Handlebars.SafeString(JSON.stringify(settings, null, 2)),
-}));
+const schema_tmpl = Handlebars.compile(
+  fs.readFileSync("schema/mise.json.hbs", "utf-8"),
+);
+fs.writeFileSync(
+  "schema/mise.json.tmp",
+  schema_tmpl({
+    settings_json: new Handlebars.SafeString(JSON.stringify(settings, null, 2)),
+  }),
+);
 
-child_process.execSync('jq . < schema/mise.json.tmp > schema/mise.json');
-fs.unlinkSync('schema/mise.json.tmp');
+child_process.execSync("jq . < schema/mise.json.tmp > schema/mise.json");
+child_process.execSync("prettier --write schema/mise.json");
+fs.unlinkSync("schema/mise.json.tmp");