fix: add --strict, support tox-uv's Literal, fix issue with order

Author: henryiii

src/tox/session/cmd/schema.py

@@ -6,6 +6,7 @@
 import sys
 import typing
 from pathlib import Path
+from types import NoneType
 from typing import TYPE_CHECKING
 
 import packaging.requirements
@@ -24,10 +25,11 @@
 
 @impl
 def tox_add_option(parser: ToxParser) -> None:
-    parser.add_command("schema", [], "Generate schema for tox configuration", gen_schema)
+    our = parser.add_command("schema", [], "Generate schema for tox configuration", gen_schema)
+    our.add_argument("--strict", action="store_true", help="Disallow extra properties in configuration")
 
 
-def _process_type(of_type: typing.Any) -> dict[str, typing.Any]:  # noqa: PLR0911
+def _process_type(of_type: typing.Any) -> dict[str, typing.Any]:  # noqa: C901, PLR0911
     if of_type in {
         Path,
         str,
@@ -36,10 +38,18 @@ def _process_type(of_type: typing.Any) -> dict[str, typing.Any]:  # noqa: PLR091
         tox.tox_env.python.pip.req_file.PythonDeps,
     }:
         return {"type": "string"}
+    if typing.get_origin(of_type) is typing.Union:
+        types = [x for x in typing.get_args(of_type) if x is not NoneType]
+        if len(types) == 1:
+            return _process_type(types[0])
+        msg = f"Union types are not supported: {of_type}"
+        raise ValueError(msg)
     if of_type is bool:
         return {"type": "boolean"}
     if of_type is float:
         return {"type": "number"}
+    if typing.get_origin(of_type) is typing.Literal:
+        return {"enum": list(typing.get_args(of_type))}
     if of_type in {tox.config.types.Command, tox.config.types.EnvList}:
         return {"type": "array", "items": {"$ref": "#/definitions/subs"}}
     if typing.get_origin(of_type) in {list, set}:
@@ -82,22 +92,32 @@ def _get_schema(conf: ConfigSet, path: str) -> dict[str, dict[str, typing.Any]]:
 
 def gen_schema(state: State) -> int:
     core = state.conf.core
+    strict = state.conf.options.strict
 
-    properties = _get_schema(core, path="#/properties")
-
+    # Accessing this adds extra stuff to core, so we need to do it first
     env_properties = _get_schema(state.envs["3.13"].conf, path="#/properties/env_run_base/properties")
 
+    properties = _get_schema(core, path="#/properties")
+
     json_schema = {
         "$schema": "http://json-schema.org/draft-07/schema",
         "$id": "https://github.com/tox-dev/tox/blob/main/src/tox/util/tox.schema.json",
         "type": "object",
         "properties": {
             **properties,
-            "env_run_base": {"type": "object", "properties": env_properties},
-            "env_pkg_base": {"$ref": "#/properties/env_run_base"},
+            "env_run_base": {
+                "type": "object",
+                "properties": env_properties,
+                "additionalProperties": not strict,
+            },
+            "env_pkg_base": {
+                "$ref": "#/properties/env_run_base",
+                "additionalProperties": not strict,
+            },
             "env": {"type": "object", "patternProperties": {"^.*$": {"$ref": "#/properties/env_run_base"}}},
             "legacy_tox_ini": {"type": "string"},
         },
+        "additionalProperties": not strict,
         "definitions": {
             "subs": {
                 "anyOf": [

src/tox/tox.schema.json

@@ -66,6 +66,38 @@
       },
       "description": "core labels"
     },
+    "ignore_base_python_conflict": {
+      "type": "boolean",
+      "description": "do not raise error if the environment name conflicts with base python"
+    },
+    "ignore_basepython_conflict": {
+      "$ref": "#/properties/ignore_base_python_conflict"
+    },
+    "skip_missing_interpreters": {
+      "type": "boolean",
+      "description": "skip running missing interpreters"
+    },
+    "no_package": {
+      "type": "boolean",
+      "description": "is there any packaging involved in this project"
+    },
+    "skipsdist": {
+      "$ref": "#/properties/no_package"
+    },
+    "package_env": {
+      "type": "string",
+      "description": "tox environment used to package"
+    },
+    "isolated_build_env": {
+      "$ref": "#/properties/package_env"
+    },
+    "package_root": {
+      "type": "string",
+      "description": "indicates where the packaging root file exists (historically setup.py file or pyproject.toml now)"
+    },
+    "setupdir": {
+      "$ref": "#/properties/package_root"
+    },
     "env_run_base": {
       "type": "object",
       "properties": {
@@ -314,10 +346,12 @@
           "type": "string",
           "description": "wheel tag to use for building applications"
         }
-      }
+      },
+      "additionalProperties": true
     },
     "env_pkg_base": {
-      "$ref": "#/properties/env_run_base"
+      "$ref": "#/properties/env_run_base",
+      "additionalProperties": true
     },
     "env": {
       "type": "object",
@@ -331,6 +365,7 @@
       "type": "string"
     }
   },
+  "additionalProperties": true,
   "definitions": {
     "subs": {
       "anyOf": [