ruff server: Introduce the ruff.printDebugInformation command

crates/ruff_server/src/server/api/requests/execute_command.rs

@@ -13,6 +13,7 @@ use serde::Deserialize;
 
 #[derive(Debug)]
 enum Command {
+    Debug,
     Format,
     FixAll,
     OrganizeImports,
@@ -40,6 +41,15 @@ impl super::SyncRequestHandler for ExecuteCommand {
         let command =
             Command::from_str(&params.command).with_failure_code(ErrorCode::InvalidParams)?;
 
+        if let Command::Debug = command {
+            let output = debug_information(session);
+            #[allow(clippy::print_stderr)]
+            {
+                eprintln!("Debug information:\n{output}");
+            }
+            return Ok(None);
+        }
+
         // check if we can apply a workspace edit
         if !session.resolved_client_capabilities().apply_edit {
             return Err(anyhow::anyhow!("Cannot execute the '{}' command: the client does not support `workspace/applyEdit`", command.label())).with_failure_code(ErrorCode::InternalError);
@@ -87,6 +97,9 @@ impl super::SyncRequestHandler for ExecuteCommand {
                         .set_fixes_for_document(fixes, snapshot.query().version())
                         .with_failure_code(ErrorCode::InternalError)?;
                 }
+                Command::Debug => {
+                    unreachable!("The debug command should have already been handled")
+                }
             }
         }
 
@@ -109,6 +122,7 @@ impl Command {
             Self::FixAll => "Fix all auto-fixable problems",
             Self::Format => "Format document",
             Self::OrganizeImports => "Format imports",
+            Self::Debug => "Print debug information",
         }
     }
 }
@@ -121,6 +135,7 @@ impl FromStr for Command {
             "ruff.applyAutofix" => Self::FixAll,
             "ruff.applyFormat" => Self::Format,
             "ruff.applyOrganizeImports" => Self::OrganizeImports,
+            "ruff.printDebugInformation" => Self::Debug,
             _ => return Err(anyhow::anyhow!("Invalid command `{name}`")),
         })
     }
@@ -148,3 +163,25 @@ fn apply_edit(
         },
     )
 }
+
+fn debug_information(session: &Session) -> String {
+    let path = std::env::current_exe()
+        .map(|path| format!("{}", path.display()))
+        .unwrap_or_else(|_| "<unavailable>".to_string());
+    format!(
+        r#"path = {path}
+version = {version}
+encoding = {encoding:?}
+open_document_count = {doc_count}
+active_workspace_count = {workspace_count}
+configuration_files = {config_files:?}
+{client_capabilities}
+    "#,
+        version = crate::version(),
+        encoding = session.encoding(),
+        client_capabilities = session.resolved_client_capabilities(),
+        doc_count = session.count_documents(),
+        workspace_count = session.count_workspaces(),
+        config_files = session.list_config_files()
+    )
+}

crates/ruff_server/src/session.rs

@@ -145,6 +145,18 @@ impl Session {
         Ok(())
     }
 
+    pub(crate) fn count_documents(&self) -> usize {
+        self.index.count_documents()
+    }
+
+    pub(crate) fn count_workspaces(&self) -> usize {
+        self.index.count_workspaces()
+    }
+
+    pub(crate) fn list_config_files(&self) -> Vec<&std::path::Path> {
+        self.index.list_config_files()
+    }
+
     pub(crate) fn resolved_client_capabilities(&self) -> &ResolvedClientCapabilities {
         &self.resolved_client_capabilities
     }

crates/ruff_server/src/session/capabilities.rs

@@ -1,4 +1,5 @@
 use lsp_types::ClientCapabilities;
+use ruff_linter::display_settings;
 
 #[derive(Debug, Clone, PartialEq, Eq, Default)]
 #[allow(clippy::struct_excessive_bools)]
@@ -65,3 +66,20 @@ impl ResolvedClientCapabilities {
         }
     }
 }
+
+impl std::fmt::Display for ResolvedClientCapabilities {
+    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+        display_settings! {
+            formatter = f,
+            namespace = "capabilities",
+            fields = [
+                self.code_action_deferred_edit_resolution,
+                self.apply_edit,
+                self.document_changes,
+                self.workspace_refresh,
+                self.pull_diagnostics,
+            ]
+        };
+        Ok(())
+    }
+}

crates/ruff_server/src/session/index.rs

@@ -187,6 +187,21 @@ impl Index {
         Self::register_workspace_settings(&mut self.settings, url, None, global_settings)
     }
 
+    pub(super) fn count_documents(&self) -> usize {
+        self.documents.len()
+    }
+
+    pub(super) fn count_workspaces(&self) -> usize {
+        self.settings.len()
+    }
+
+    pub(super) fn list_config_files(&self) -> Vec<&Path> {
+        self.settings
+            .values()
+            .flat_map(|WorkspaceSettings { ruff_settings, .. }| ruff_settings.list_files())
+            .collect()
+    }
+
     fn register_workspace_settings(
         settings_index: &mut SettingsIndex,
         workspace_url: &Url,

crates/ruff_server/src/session/index/ruff_settings.rs

@@ -19,6 +19,9 @@ use walkdir::WalkDir;
 use crate::session::settings::{ConfigurationPreference, ResolvedEditorSettings};
 
 pub(crate) struct RuffSettings {
+    /// The path to this configuration file, used for debugging.
+    /// The default fallback configuration does not have a file path.
+    path: Option<PathBuf>,
     /// Settings used to manage file inclusion and exclusion.
     file_resolver: ruff_workspace::FileResolverSettings,
     /// Settings to pass into the Ruff linter.
@@ -48,14 +51,17 @@ impl std::fmt::Display for RuffSettings {
 
 impl RuffSettings {
     pub(crate) fn fallback(editor_settings: &ResolvedEditorSettings, root: &Path) -> RuffSettings {
+        let mut path = None;
         let fallback = find_user_settings_toml()
             .and_then(|user_settings| {
-                ruff_workspace::resolver::resolve_root_settings(
+                let settings = ruff_workspace::resolver::resolve_root_settings(
                     &user_settings,
                     Relativity::Cwd,
                     &EditorConfigurationTransformer(editor_settings, root),
                 )
-                .ok()
+                .ok();
+                path = Some(user_settings);
+                settings
             })
             .unwrap_or_else(|| {
                 let default_configuration = Configuration::default();
@@ -68,6 +74,7 @@ impl RuffSettings {
             });
 
         RuffSettings {
+            path,
             file_resolver: fallback.file_resolver,
             formatter: fallback.formatter,
             linter: fallback.linter,
@@ -108,6 +115,7 @@ impl RuffSettingsIndex {
                 index.insert(
                     directory.to_path_buf(),
                     Arc::new(RuffSettings {
+                        path: Some(pyproject),
                         file_resolver: settings.file_resolver,
                         linter: settings.linter,
                         formatter: settings.formatter,
@@ -176,6 +184,7 @@ impl RuffSettingsIndex {
                 index.insert(
                     directory,
                     Arc::new(RuffSettings {
+                        path: Some(pyproject),
                         file_resolver: settings.file_resolver,
                         linter: settings.linter,
                         formatter: settings.formatter,
@@ -198,6 +207,12 @@ impl RuffSettingsIndex {
             .clone()
     }
 
+    pub(crate) fn list_files(&self) -> impl Iterator<Item = &Path> {
+        self.index
+            .values()
+            .filter_map(|settings| settings.path.as_deref())
+    }
+
     pub(super) fn fallback(&self) -> Arc<RuffSettings> {
         self.fallback.clone()
     }