Generate custom JSON schema for dynamic setting

crates/ruff_python_formatter/src/options.rs

@@ -1,10 +1,11 @@
+use std::fmt;
+use std::path::Path;
+use std::str::FromStr;
+
 use ruff_formatter::printer::{LineEnding, PrinterOptions, SourceMapGeneration};
 use ruff_formatter::{FormatOptions, IndentStyle, IndentWidth, LineWidth};
 use ruff_macros::CacheKey;
 use ruff_python_ast::PySourceType;
-use std::fmt;
-use std::path::Path;
-use std::str::FromStr;
 
 /// Resolved options for formatting one individual file. The difference to `FormatterSettings`
 /// is that `FormatterSettings` stores the settings for multiple files (the entire project, a subdirectory, ..)
@@ -367,15 +368,39 @@ impl fmt::Display for DocstringCode {
 #[cfg_attr(feature = "serde", serde(untagged))]
 #[cfg_attr(feature = "schemars", derive(schemars::JsonSchema))]
 pub enum DocstringCodeLineWidth {
+    /// Wrap docstring code examples at a fixed line width.
     Fixed(LineWidth),
+
+    /// Respect the line length limit setting for the surrounding Python code.
     #[default]
     #[cfg_attr(
         feature = "serde",
         serde(deserialize_with = "deserialize_docstring_code_line_width_dynamic")
     )]
+    #[cfg_attr(feature = "schemars", schemars(with = "DynamicSchema"))]
     Dynamic,
 }
 
+/// A dummy type that is used to generate a schema for `DocstringCodeLineWidth::Dynamic`.
+#[cfg(feature = "schemars")]
+struct DynamicSchema;
+
+#[cfg(feature = "schemars")]
+impl schemars::JsonSchema for DynamicSchema {
+    fn schema_name() -> String {
+        "Dynamic".to_string()
+    }
+
+    fn json_schema(_: &mut schemars::gen::SchemaGenerator) -> schemars::schema::Schema {
+        schemars::schema::SchemaObject {
+            instance_type: Some(schemars::schema::InstanceType::String.into()),
+            const_value: Some("dynamic".to_string().into()),
+            ..Default::default()
+        }
+        .into()
+    }
+}
+
 impl fmt::Debug for DocstringCodeLineWidth {
     fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
         match *self {