Add hidden --preview / --no-preview options to ruff check

crates/ruff/src/settings/defaults.rs

@@ -84,6 +84,7 @@ impl Default for Settings {
             line_length: LineLength::default(),
             logger_objects: vec![],
             namespace_packages: vec![],
+            preview_mode: false,
             per_file_ignores: vec![],
             project_root: path_dedot::CWD.clone(),
             respect_gitignore: true,

crates/ruff/src/settings/mod.rs

@@ -55,6 +55,7 @@ pub struct Settings {
     pub per_file_ignores: Vec<(GlobMatcher, GlobMatcher, RuleSet)>,
 
     pub target_version: PythonVersion,
+    pub preview_mode: bool,
 
     // Resolver settings
     pub exclude: FilePatternSet,

crates/ruff_cli/src/args.rs

@@ -115,6 +115,11 @@ pub struct CheckCommand {
     /// The minimum Python version that should be supported.
     #[arg(long, value_enum)]
     pub target_version: Option<PythonVersion>,
+    /// Enable preview mode
+    #[arg(long, overrides_with("no_preview"), hide = true)]
+    preview: bool,
+    #[clap(long, overrides_with("preview"), hide = true)]
+    no_preview: bool,
     /// Path to the `pyproject.toml` or `ruff.toml` file to use for
     /// configuration.
     #[arg(long, conflicts_with = "isolated")]
@@ -458,6 +463,7 @@ impl CheckCommand {
                 ignore: self.ignore,
                 line_length: self.line_length,
                 per_file_ignores: self.per_file_ignores,
+                preview_mode: resolve_bool_arg(self.preview, self.no_preview),
                 respect_gitignore: resolve_bool_arg(
                     self.respect_gitignore,
                     self.no_respect_gitignore,
@@ -569,6 +575,7 @@ pub struct Overrides {
     pub ignore: Option<Vec<RuleSelector>>,
     pub line_length: Option<LineLength>,
     pub per_file_ignores: Option<Vec<PatternPrefixPair>>,
+    pub preview_mode: Option<bool>,
     pub respect_gitignore: Option<bool>,
     pub select: Option<Vec<RuleSelector>>,
     pub show_source: Option<bool>,
@@ -632,6 +639,9 @@ impl ConfigProcessor for Overrides {
         if let Some(line_length) = &self.line_length {
             config.line_length = Some(*line_length);
         }
+        if let Some(preview_mode) = &self.preview_mode {
+            config.preview_mode = Some(*preview_mode);
+        }
         if let Some(per_file_ignores) = &self.per_file_ignores {
             config.per_file_ignores = Some(collect_per_file_ignores(per_file_ignores.clone()));
         }

crates/ruff_wasm/src/lib.rs

@@ -128,6 +128,7 @@ impl Workspace {
             external: Some(Vec::default()),
             ignore: Some(Vec::default()),
             line_length: Some(LineLength::default()),
+            preview_mode: Some(false),
             select: Some(defaults::PREFIXES.to_vec()),
             tab_size: Some(TabSize::default()),
             target_version: Some(PythonVersion::default()),

crates/ruff_workspace/src/configuration.rs

@@ -67,6 +67,7 @@ pub struct Configuration {
     pub line_length: Option<LineLength>,
     pub logger_objects: Option<Vec<String>>,
     pub namespace_packages: Option<Vec<PathBuf>>,
+    pub preview_mode: Option<bool>,
     pub required_version: Option<Version>,
     pub respect_gitignore: Option<bool>,
     pub show_fixes: Option<bool>,
@@ -174,6 +175,7 @@ impl Configuration {
                     .collect()
             }),
             logger_objects: self.logger_objects.unwrap_or_default(),
+            preview_mode: self.preview_mode.unwrap_or_default(),
             typing_modules: self.typing_modules.unwrap_or_default(),
             // Plugins
             flake8_annotations: self
@@ -387,6 +389,7 @@ impl Configuration {
                 .namespace_packages
                 .map(|namespace_package| resolve_src(&namespace_package, project_root))
                 .transpose()?,
+            preview_mode: options.preview_mode,
             per_file_ignores: options.per_file_ignores.map(|per_file_ignores| {
                 per_file_ignores
                     .into_iter()
@@ -676,6 +679,7 @@ impl Configuration {
             show_fixes: self.show_fixes.or(config.show_fixes),
             src: self.src.or(config.src),
             target_version: self.target_version.or(config.target_version),
+            preview_mode: self.preview_mode.or(config.preview_mode),
             task_tags: self.task_tags.or(config.task_tags),
             typing_modules: self.typing_modules.or(config.typing_modules),
             // Plugins

crates/ruff_workspace/src/options.rs

@@ -482,6 +482,17 @@ pub struct Options {
     /// field (e.g., `requires-python = ">=3.8"`). If Ruff is configured via
     /// `ruff.toml` or `.ruff.toml`, no such inference will be performed.
     pub target_version: Option<PythonVersion>,
+    #[option(
+        default = "false",
+        value_type = "bool",
+        example = r#"
+            # Enable preview mode
+            preview-mode = true
+        "#
+    )]
+    /// Whether to enable preview mode. When preview mode is enabled, Ruff will
+    /// use unstable rules and fixes.
+    pub preview_mode: Option<bool>,
     #[option(
         default = r#"["TODO", "FIXME", "XXX"]"#,
         value_type = "list[str]",