(MAINT) Disable docs tests for library crates by default

Prior to this change, invoking `cargo test` for library crates without
specifically choosing a test subset (unit, integration, etc) would
always run the documentation tests.

Documentation tests are particularly slow because Rust compiles a binary
for every codeblock in your documentation. This is the slowest part of
the rust tests when working on a library with extensive examples.

This change adds the `doctest` setting to the crate manifests as `false`
to disable documentation tests by default. These tests can still be
invoked by passing the `--doc` flag to `cargo test`.

Future changes will provide simplified access to generating and testing
the docs from the build script, as well as validating documentation in
CI.

Author: michaeltlombardi

grammars/tree-sitter-dscexpression/Cargo.toml

@@ -18,6 +18,7 @@ include = [
 
 [lib]
 path = "bindings/rust/lib.rs"
+doctest = false
 
 [dependencies]
 tree-sitter-rust = { workspace = true }

grammars/tree-sitter-ssh-server-config/Cargo.toml

@@ -0,0 +1,32 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+//! Provides helper functions for working with VS Code's extended JSON Schema keywords with
+//! [`schemars::Schema`] instances.
+//!
+//! The `get_keyword_as_*` functions simplify retrieving the value of a keyword for a given type.
+//! If the schema defines the keyword with the expected type, those functions return a reference to
+//! that value as the correct type. If the keyword doesn't exist or has the wrong value type, the
+//! functions return [`None`].
+//!
+//! The rest of the utility methods work with specific keywords, like `$id` and `$defs`.
+
+use core::{clone::Clone, iter::Iterator, option::Option::None};
+use std::string::String;
+
+use schemars::Schema;
+use serde_json::{Map, Number, Value};
+use url::{Position, Url};
+
+type Array = Vec<Value>;
+type Object = Map<String, Value>;
+
+pub trait VSCodeSchemaExtensions {
+    fn has_markdown_description(&self) -> bool;
+}
+
+impl VSCodeSchemaExtensions for Schema {
+    fn has_markdown_description(&self) -> bool {
+        self.get("markdownDescription").is_some()
+    }
+}

lib/dsc-lib-jsonschema/src/vscode/vscode_schema_extensions.rs

@@ -3,6 +3,9 @@ name = "dsc-lib-osinfo"
 version = "1.0.0"
 edition = "2021"
 
+[lib]
+doctest = false
+
 [dependencies]
 os_info = { workspace = true }
 serde = { workspace = true }

lib/dsc-lib-osinfo/Cargo.toml

@@ -5,5 +5,8 @@ name = "dsc-lib-pal"
 version = "0.1.0"
 edition = "2021"
 
+[lib]
+doctest = false
+
 [build-dependencies]
 cc = { workspace = true }

lib/dsc-lib-pal/Cargo.toml

@@ -8,6 +8,9 @@ available-locales = ["en-us"]
 default-locale = "en-us"
 load-path = "locales"
 
+[lib]
+doctest = false
+
 [dependencies]
 crossterm = { workspace = true }
 registry = { workspace = true }

lib/dsc-lib-registry/Cargo.toml

@@ -3,6 +3,9 @@ name = "dsc-lib-security_context"
 version = "0.1.0"
 edition = "2021"
 
+[lib]
+doctest = false
+
 [target.'cfg(target_os = "windows")'.dependencies]
 is_elevated = { workspace = true }
 

lib/dsc-lib-security_context/Cargo.toml

@@ -3,6 +3,9 @@ name = "dsc-lib"
 version = "3.2.0"
 edition = "2021"
 
+[lib]
+doctest = false
+
 [dependencies]
 # external dependencies
 base32 = { workspace = true }