Release 0.62.0 (#3502)

kennykerr · web-flow · commit 50e85cbbc063 · 2025-02-21T10:22:52.000-06:00
diff --git a/crates/libs/bindgen/Cargo.toml b/crates/libs/bindgen/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "windows-bindgen"
-version = "0.59.0"
+version = "0.60.0"
 edition = "2021"
 rust-version = "1.74"
 license = "MIT OR Apache-2.0"
@@ -16,4 +16,4 @@ default-target = "x86_64-pc-windows-msvc"
 targets = []
 
 [dependencies]
-rayon = "1.7"
+rayon = "1.10"
diff --git a/crates/libs/bindgen/readme.md b/crates/libs/bindgen/readme.md
@@ -9,11 +9,11 @@ The [windows-bindgen](https://crates.io/crates/windows-bindgen) crate automatica
 Start by adding the following to your Cargo.toml file:
 
 ```toml
-[dependencies.windows-targets]
-version = "0.53"
+[dependencies.windows-link]
+version = "0.1"
 
-[dev-dependencies.windows-bindgen]
-version = "0.59"
+[build-dependencies.windows-bindgen]
+version = "0.60"
 ```
 
 Generate Rust bindings in a build script as follows:
diff --git a/crates/libs/collections/Cargo.toml b/crates/libs/collections/Cargo.toml
@@ -16,7 +16,7 @@ default-target = "x86_64-pc-windows-msvc"
 targets = []
 
 [dependencies.windows-core]
-version = "0.59.0"
+version = "0.60.0"
 path = "../core"
 default-features = false
 
diff --git a/crates/libs/core/Cargo.toml b/crates/libs/core/Cargo.toml
@@ -1,11 +1,11 @@
 [package]
 name = "windows-core"
-version = "0.59.0"
+version = "0.60.0"
 authors = ["Microsoft"]
 edition = "2021"
 rust-version = "1.74"
 license = "MIT OR Apache-2.0"
-description = "Rust for Windows"
+description = "Core type support for COM and Windows"
 repository = "https://github.com/microsoft/windows-rs"
 readme = "readme.md"
 categories = ["os::windows-apis"]
diff --git a/crates/libs/core/readme.md b/crates/libs/core/readme.md
@@ -1,6 +1,6 @@
-## windows-core
+## Core type support for COM and Windows
 
-Core primitives for the [windows](https://crates.io/crates/windows) crate.
+The [windows-core](https://crates.io/crates/windows-core) crate provides core type support for the windows-* family of crates.
 
 * [Getting started](https://kennykerr.ca/rust-getting-started/)
 * [Samples](https://github.com/microsoft/windows-rs/tree/master/crates/samples)
diff --git a/crates/libs/cppwinrt/Cargo.toml b/crates/libs/cppwinrt/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "cppwinrt"
-version = "0.2.0"
+version = "0.2.1"
 authors = ["Microsoft"]
 edition = "2021"
 rust-version = "1.74"
diff --git a/crates/libs/cppwinrt/readme.md b/crates/libs/cppwinrt/readme.md
@@ -10,7 +10,7 @@ Start by adding the following to your Cargo.toml file:
 
 ```toml
 [dependencies.cppwinrt]
-version = "0.1"
+version = "0.2"
 ```
 
 Use `cppwinrt` function as needed:
diff --git a/crates/libs/cppwinrt/src/lib.rs b/crates/libs/cppwinrt/src/lib.rs
@@ -5,7 +5,7 @@ const VERSION: &str = "2.0.240405.15";
 
 /// Calls the C++/WinRT compiler with the given arguments.
 ///
-/// Use `cppwinrt["-help"]` for available options.
+/// Use `cppwinrt(["-help"])` for available options.
 #[track_caller]
 pub fn cppwinrt<I, S>(args: I) -> String
 where
diff --git a/crates/libs/future/Cargo.toml b/crates/libs/future/Cargo.toml
@@ -20,10 +20,13 @@ default = ["std"]
 std = []
 
 [dependencies.windows-core]
-version = "0.59.0"
+version = "0.60.0"
 path = "../core"
 default-features = false
 
 [dependencies.windows-link]
 version = "0.1.0"
 path = "../link"
+
+[dev-dependencies]
+windows-result = { path = "../result" }
diff --git a/crates/libs/future/readme.md b/crates/libs/future/readme.md
@@ -5,3 +5,32 @@ The [windows-future](https://crates.io/crates/windows-future) crate provides sto
 * [Getting started](https://kennykerr.ca/rust-getting-started/)
 * [Samples](https://github.com/microsoft/windows-rs/tree/master/crates/samples)
 * [Releases](https://github.com/microsoft/windows-rs/releases)
+
+Start by adding the following to your Cargo.toml file:
+
+```toml
+[dependencies.windows-future]
+version = "0.1"
+```
+
+Use the Windows async types as needed:
+
+```rust
+use windows_future::*;
+use windows_result::*;
+
+fn main() -> Result<()> {
+    // This result will be available immediately.
+    let ready = IAsyncOperation::ready(Ok(123));
+    assert_eq!(ready.get()?, 123);
+
+    let ready = IAsyncOperation::spawn(|| {
+        // Some lengthy operation goes here...
+        Ok(456)
+    });
+
+    assert_eq!(ready.get()?, 456);
+
+    Ok(())
+}
+```
diff --git a/crates/libs/helpers/Cargo.toml b/crates/libs/helpers/Cargo.toml
@@ -5,6 +5,5 @@ edition = "2021"
 publish = false
 
 [dependencies]
-regex = "1.7"
-windows-bindgen = { workspace = true }
+regex = "1.11"
 windows-link = { workspace = true }
diff --git a/crates/libs/numerics/Cargo.toml b/crates/libs/numerics/Cargo.toml
@@ -20,7 +20,7 @@ default = ["std"]
 std = []
 
 [dependencies.windows-core]
-version = "0.59.0"
+version = "0.60.0"
 path = "../core"
 default-features = false
 
diff --git a/crates/libs/registry/Cargo.toml b/crates/libs/registry/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "windows-registry"
-version = "0.4.0"
+version = "0.5.0"
 authors = ["Microsoft"]
 edition = "2021"
 rust-version = "1.74"
diff --git a/crates/libs/registry/readme.md b/crates/libs/registry/readme.md
@@ -10,7 +10,7 @@ Start by adding the following to your Cargo.toml file:
 
 ```toml
 [dependencies.windows-registry]
-version = "0.3"
+version = "0.5"
 ```
 
 Read and write registry keys and values as needed:
diff --git a/crates/libs/result/Cargo.toml b/crates/libs/result/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "windows-result"
-version = "0.3.0"
+version = "0.3.1"
 authors = ["Microsoft"]
 edition = "2021"
 rust-version = "1.74"
diff --git a/crates/libs/result/readme.md b/crates/libs/result/readme.md
@@ -10,7 +10,7 @@ Start by adding the following to your Cargo.toml file:
 
 ```toml
 [dependencies.windows-result]
-version = "0.2"
+version = "0.3"
 ```
 
 Use the `HRESULT`, `Error`, and specialized `Result` types as needed:
diff --git a/crates/libs/strings/Cargo.toml b/crates/libs/strings/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "windows-strings"
-version = "0.3.0"
+version = "0.3.1"
 authors = ["Microsoft"]
 edition = "2021"
 rust-version = "1.74"
diff --git a/crates/libs/strings/readme.md b/crates/libs/strings/readme.md
@@ -10,7 +10,7 @@ Start by adding the following to your Cargo.toml file:
 
 ```toml
 [dependencies.windows-strings]
-version = "0.2"
+version = "0.3"
 ```
 
 Use the Windows string types as needed:
diff --git a/crates/libs/version/Cargo.toml b/crates/libs/version/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "windows-version"
-version = "0.1.2"
+version = "0.1.3"
 authors = ["Microsoft"]
 edition = "2021"
 rust-version = "1.74"
diff --git a/crates/libs/windows/Cargo.toml b/crates/libs/windows/Cargo.toml
@@ -1,7 +1,7 @@
 
 [package]
 name = "windows"
-version = "0.59.0"
+version = "0.60.0"
 authors = ["Microsoft"]
 edition = "2021"
 rust-version = "1.74"
@@ -27,7 +27,7 @@ targets = []
 rustdoc-args = ["--cfg", "docsrs"]
 
 [dependencies.windows-core]
-version = "0.59.0"
+version = "0.60.0"
 path = "../core"
 default-features = false
 
diff --git a/crates/libs/windows/readme.md b/crates/libs/windows/readme.md
@@ -11,7 +11,7 @@ Start by adding the following to your Cargo.toml file:
 
 ```toml
 [dependencies.windows]
-version = "0.59"
+version = "0.60"
 features = [
     "Data_Xml_Dom",
     "Win32_Security",
diff --git a/crates/samples/components/json_validator_winrt/src/bindings.rs b/crates/samples/components/json_validator_winrt/src/bindings.rs
@@ -1,4 +1,4 @@
-// Bindings generated by `windows-bindgen` 0.59.0
+// Bindings generated by `windows-bindgen` 0.60.0
 
 #![allow(
     non_snake_case,
diff --git a/crates/samples/components/json_validator_winrt_client/src/bindings.rs b/crates/samples/components/json_validator_winrt_client/src/bindings.rs
@@ -1,4 +1,4 @@
-// Bindings generated by `windows-bindgen` 0.59.0
+// Bindings generated by `windows-bindgen` 0.60.0
 
 #![allow(
     non_snake_case,
diff --git a/crates/tests/libs/bindgen/src/comment.rs b/crates/tests/libs/bindgen/src/comment.rs
@@ -1,4 +1,4 @@
-// Bindings generated by `windows-bindgen` 0.59.0
+// Bindings generated by `windows-bindgen` 0.60.0
 
 #![allow(
     non_snake_case,
diff --git a/crates/tests/libs/bindgen/src/comment_no_allow.rs b/crates/tests/libs/bindgen/src/comment_no_allow.rs
@@ -1,3 +1,3 @@
-// Bindings generated by `windows-bindgen` 0.59.0
+// Bindings generated by `windows-bindgen` 0.60.0
 
 windows_link::link!("kernel32.dll" "system" fn GetTickCount() -> u32);
diff --git a/crates/tests/misc/readme/Cargo.toml b/crates/tests/misc/readme/Cargo.toml
@@ -42,6 +42,9 @@ workspace = true
 [dev-dependencies.windows-strings]
 workspace = true
 
+[dev-dependencies.windows-future]
+workspace = true
+
 [dev-dependencies.cppwinrt]
 workspace = true
 
diff --git a/crates/tests/misc/readme/src/lib.rs b/crates/tests/misc/readme/src/lib.rs
@@ -10,3 +10,5 @@
 #![doc = include_str!("../../../../libs/windows/readme.md")]
 #![doc = include_str!("../../../../libs/link/readme.md")]
 #![doc = include_str!("../../../../libs/collections/readme.md")]
+#![doc = include_str!("../../../../libs/numerics/readme.md")]
+#![doc = include_str!("../../../../libs/future/readme.md")]
diff --git a/crates/tests/winrt/collection_interop/build.rs b/crates/tests/winrt/collection_interop/build.rs
@@ -37,6 +37,7 @@ fn main() {
         "Test",
         "--implement",
         "--flat",
+        "--no-comment",
         "--reference",
         "windows_collections,flat,Windows",
     ]);
diff --git a/crates/tests/winrt/collection_interop/src/bindings.rs b/crates/tests/winrt/collection_interop/src/bindings.rs
@@ -1,5 +1,3 @@
-// Bindings generated by `windows-bindgen` 0.59.0
-
 #![allow(
     non_snake_case,
     non_upper_case_globals,
diff --git a/crates/tests/winrt/noexcept/build.rs b/crates/tests/winrt/noexcept/build.rs
@@ -37,6 +37,7 @@ fn main() {
         "Test",
         "--implement",
         "--flat",
+        "--no-comment",
     ]);
 
     let include = std::env::var("OUT_DIR").unwrap();
diff --git a/crates/tests/winrt/noexcept/src/bindings.rs b/crates/tests/winrt/noexcept/src/bindings.rs
@@ -1,5 +1,3 @@
-// Bindings generated by `windows-bindgen` 0.59.0
-
 #![allow(
     non_snake_case,
     non_upper_case_globals,
diff --git a/crates/tests/winrt/ref_params/build.rs b/crates/tests/winrt/ref_params/build.rs
@@ -37,6 +37,7 @@ fn main() {
         "Test",
         "--implement",
         "--flat",
+        "--no-comment",
     ]);
 
     let include = std::env::var("OUT_DIR").unwrap();
diff --git a/crates/tests/winrt/ref_params/src/bindings.rs b/crates/tests/winrt/ref_params/src/bindings.rs
@@ -1,5 +1,3 @@
-// Bindings generated by `windows-bindgen` 0.59.0
-
 #![allow(
     non_snake_case,
     non_upper_case_globals,
diff --git a/crates/tests/winrt/reference_custom/build.rs b/crates/tests/winrt/reference_custom/build.rs
@@ -33,6 +33,7 @@ fn main() {
         "IAsyncAction",
         "--implement",
         "--flat",
+        "--no-comment",
         "--no-deps",
         "--reference",
         "windows,skip-root,Windows.Foundation.IStringable",
diff --git a/crates/tests/winrt/reference_custom/src/bindings.rs b/crates/tests/winrt/reference_custom/src/bindings.rs
@@ -1,5 +1,3 @@
-// Bindings generated by `windows-bindgen` 0.59.0
-
 #![allow(
     non_snake_case,
     non_upper_case_globals,
diff --git a/crates/tests/winrt/reference_no_deps/build.rs b/crates/tests/winrt/reference_no_deps/build.rs
@@ -35,5 +35,6 @@ fn main() {
         "--implement",
         "--flat",
         "--no-deps",
+        "--no-comment",
     ]);
 }
diff --git a/crates/tests/winrt/reference_no_deps/src/bindings.rs b/crates/tests/winrt/reference_no_deps/src/bindings.rs
@@ -1,5 +1,3 @@
-// Bindings generated by `windows-bindgen` 0.59.0
-
 #![allow(
     non_snake_case,
     non_upper_case_globals,
diff --git a/crates/tests/winrt/reference_no_windows/build.rs b/crates/tests/winrt/reference_no_windows/build.rs
@@ -31,5 +31,6 @@ fn main() {
         "IStringable",
         "--implement",
         "--flat",
+        "--no-comment",
     ]);
 }
diff --git a/crates/tests/winrt/reference_no_windows/src/bindings.rs b/crates/tests/winrt/reference_no_windows/src/bindings.rs
@@ -1,5 +1,3 @@
-// Bindings generated by `windows-bindgen` 0.59.0
-
 #![allow(
     non_snake_case,
     non_upper_case_globals,
diff --git a/crates/tests/winrt/reference_windows/build.rs b/crates/tests/winrt/reference_windows/build.rs
@@ -30,6 +30,7 @@ fn main() {
         "Test",
         "--implement",
         "--flat",
+        "--no-comment",
         "--reference",
         "windows",
     ]);
diff --git a/crates/tests/winrt/reference_windows/src/bindings.rs b/crates/tests/winrt/reference_windows/src/bindings.rs
@@ -1,5 +1,3 @@
-// Bindings generated by `windows-bindgen` 0.59.0
-
 #![allow(
     non_snake_case,
     non_upper_case_globals,
diff --git a/docs/readme.md b/docs/readme.md
@@ -13,12 +13,15 @@ This repo is the home of the following crates (and other supporting crates):
 * [windows](https://crates.io/crates/windows) - Safer bindings including C-style APIs as well as COM and WinRT APIs.
 
 * [windows-bindgen](https://crates.io/crates/windows-bindgen) - Code generator for Windows metadata.
-* [windows-core](https://crates.io/crates/windows-core) - Core type support for the Windows bindings.
+* [windows-collections](https://crates.io/crates/windows-collections) - Windows collection types.
+* [windows-core](https://crates.io/crates/windows-core) - Core type support for COM and Windows.
+* [windows-future](https://crates.io/crates/windows-future) - Windows async type support.
+* [windows-link](https://crates.io/crates/windows-link) - Linking for Windows.
+* [windows-numerics](https://crates.io/crates/windows-numerics) - Windows numeric types.
 * [windows-registry](https://crates.io/crates/windows-registry) - Windows registry.
 * [windows-result](https://crates.io/crates/windows-result) - Windows error handling.
 * [windows-strings](https://crates.io/crates/windows-strings) - Windows string types.
-* [windows-link](https://crates.io/crates/windows-link) - Direct linking for Windows.
-* [windows-targets](https://crates.io/crates/windows-targets) - Import libs for Windows (and the precursor to `windows-link` for older compilers).
 * [windows-version](https://crates.io/crates/windows-version) - Windows version information.
+* [windows-targets](https://crates.io/crates/windows-targets) - Import libs for Windows (and the precursor to `windows-link` for older compilers).
 
 * [cppwinrt](https://crates.io/crates/cppwinrt) - Bundles the C++/WinRT compiler for use in Rust.

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		-// Bindings generated by `windows-bindgen` 0.59.0
	`1`	+// Bindings generated by `windows-bindgen` 0.60.0
`2`	`2`
`3`	`3`	`#![allow(`
`4`	`4`	`non_snake_case,`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`		-// Bindings generated by `windows-bindgen` 0.59.0
	`1`	+// Bindings generated by `windows-bindgen` 0.60.0
`2`	`2`
`3`	`3`	`windows_link::link!("kernel32.dll" "system" fn GetTickCount() -> u32);`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,3 @@`
`1`		-// Bindings generated by `windows-bindgen` 0.59.0
`2`		`-`
`3`	`1`	`#![allow(`
`4`	`2`	`non_snake_case,`
`5`	`3`	`non_upper_case_globals,`
Original file line number	Diff line number	Diff line change
`@@ -35,5 +35,6 @@ fn main() {`
`35`	`35`	`"--implement",`
`36`	`36`	`"--flat",`
`37`	`37`	`"--no-deps",`
	`38`	`+ "--no-comment",`
`38`	`39`	`]);`
`39`	`40`	`}`
Original file line number	Diff line number	Diff line change
`@@ -31,5 +31,6 @@ fn main() {`
`31`	`31`	`"IStringable",`
`32`	`32`	`"--implement",`
`33`	`33`	`"--flat",`
	`34`	`+ "--no-comment",`
`34`	`35`	`]);`
`35`	`36`	`}`