Add root level docs for all libraries (#3202)
This commit is contained in:
nerix
GitHub
Родитель
f21e54807b
Коммит
ffe93a7ea6
|
|
@ -20,6 +20,13 @@ jobs:
|
|||
uses: actions/checkout@v4
|
||||
- name: Check
|
||||
run: cargo doc --no-deps -p windows
|
||||
- name: Doctests
|
||||
run: >
|
||||
cargo test --doc -p windows
|
||||
-F Data_Xml_Dom
|
||||
-F Win32_Security
|
||||
-F Win32_System_Threading
|
||||
-F Win32_UI_WindowsAndMessaging
|
||||
|
||||
windows-sys:
|
||||
name: windows-sys
|
||||
|
|
@ -29,3 +36,45 @@ jobs:
|
|||
uses: actions/checkout@v4
|
||||
- name: Check
|
||||
run: cargo doc --no-deps -p windows-sys
|
||||
- name: Doctests
|
||||
run: >
|
||||
cargo test --doc -p windows-sys
|
||||
-F Win32_Security
|
||||
-F Win32_System_Threading
|
||||
-F Win32_UI_WindowsAndMessaging
|
||||
|
||||
other-crates:
|
||||
runs-on: windows-latest
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v4
|
||||
|
||||
- name: Check
|
||||
run: >
|
||||
cargo doc --no-deps
|
||||
-p windows-bindgen
|
||||
-p windows-core
|
||||
-p cppwinrt
|
||||
-p windows-implement
|
||||
-p windows-interface
|
||||
-p windows-metadata
|
||||
-p windows-registry
|
||||
-p windows-result
|
||||
-p windows-strings
|
||||
-p windows-targets
|
||||
-p windows-version
|
||||
|
||||
- name: Doctests
|
||||
run: >
|
||||
cargo test --doc
|
||||
-p windows-bindgen
|
||||
-p windows-core
|
||||
-p cppwinrt
|
||||
-p windows-implement
|
||||
-p windows-interface
|
||||
-p windows-metadata
|
||||
-p windows-registry
|
||||
-p windows-result
|
||||
-p windows-strings
|
||||
-p windows-targets
|
||||
-p windows-version
|
||||
|
|
|
|||
|
|
@ -18,7 +18,7 @@ version = "0.58"
|
|||
|
||||
Generates Rust bindings in a build script or test as needed:
|
||||
|
||||
```rust,no_run
|
||||
```rust,ignore
|
||||
#[test]
|
||||
fn bindgen() {
|
||||
let args = [
|
||||
|
|
|
|||
|
|
@ -1,6 +1,4 @@
|
|||
/*!
|
||||
Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
*/
|
||||
#![doc = include_str!("../readme.md")]
|
||||
|
||||
mod args;
|
||||
mod error;
|
||||
|
|
|
|||
|
|
@ -1,86 +1,7 @@
|
|||
## Rust for Windows
|
||||
## windows-core
|
||||
|
||||
The [windows](https://crates.io/crates/windows) and [windows-sys](https://crates.io/crates/windows-sys) crates let you call any Windows API past, present, and future using code generated on the fly directly from the [metadata describing the API](https://github.com/microsoft/windows-rs/tree/master/crates/libs/bindgen/default) and right into your Rust package where you can call them as if they were just another Rust module. The Rust language projection follows in the tradition established by [C++/WinRT](https://github.com/microsoft/cppwinrt) of building language projections for Windows using standard languages and compilers, providing a natural and idiomatic way for Rust developers to call Windows APIs.
|
||||
Core primitives for the [windows](https://crates.io/crates/windows) crate.
|
||||
|
||||
* [Getting started](https://kennykerr.ca/rust-getting-started/)
|
||||
* [Samples](https://github.com/microsoft/windows-rs/tree/0.58.0/crates/samples)
|
||||
* [Releases](https://github.com/microsoft/windows-rs/releases)
|
||||
|
||||
Start by adding the following to your Cargo.toml file:
|
||||
|
||||
```toml
|
||||
[dependencies.windows]
|
||||
version = "0.58"
|
||||
features = [
|
||||
"Data_Xml_Dom",
|
||||
"Win32_Security",
|
||||
"Win32_System_Threading",
|
||||
"Win32_UI_WindowsAndMessaging",
|
||||
]
|
||||
```
|
||||
|
||||
Make use of any Windows APIs as needed:
|
||||
|
||||
```rust,no_run
|
||||
use windows::{
|
||||
core::*, Data::Xml::Dom::*, Win32::Foundation::*, Win32::System::Threading::*,
|
||||
Win32::UI::WindowsAndMessaging::*,
|
||||
};
|
||||
|
||||
fn main() -> Result<()> {
|
||||
let doc = XmlDocument::new()?;
|
||||
doc.LoadXml(h!("<html>hello world</html>"))?;
|
||||
|
||||
let root = doc.DocumentElement()?;
|
||||
assert!(root.NodeName()? == "html");
|
||||
assert!(root.InnerText()? == "hello world");
|
||||
|
||||
unsafe {
|
||||
let event = CreateEventW(None, true, false, None)?;
|
||||
SetEvent(event)?;
|
||||
WaitForSingleObject(event, 0);
|
||||
CloseHandle(event)?;
|
||||
|
||||
MessageBoxA(None, s!("Ansi"), s!("Caption"), MB_OK);
|
||||
MessageBoxW(None, w!("Wide"), w!("Caption"), MB_OK);
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
```
|
||||
|
||||
## windows-sys
|
||||
|
||||
The `windows-sys` crate is a zero-overhead fallback for the most demanding situations and primarily where the absolute best compile time is essential. It only includes function declarations (externs), structs, and constants. No convenience helpers, traits, or wrappers are provided.
|
||||
|
||||
Start by adding the following to your Cargo.toml file:
|
||||
|
||||
```toml
|
||||
[dependencies.windows-sys]
|
||||
version = "0.59"
|
||||
features = [
|
||||
"Win32_Security",
|
||||
"Win32_System_Threading",
|
||||
"Win32_UI_WindowsAndMessaging",
|
||||
]
|
||||
```
|
||||
|
||||
Make use of any Windows APIs as needed:
|
||||
|
||||
```rust,no_run
|
||||
use windows_sys::{
|
||||
core::*, Win32::Foundation::*, Win32::System::Threading::*, Win32::UI::WindowsAndMessaging::*,
|
||||
};
|
||||
|
||||
fn main() {
|
||||
unsafe {
|
||||
let event = CreateEventW(std::ptr::null(), 1, 0, std::ptr::null());
|
||||
SetEvent(event);
|
||||
WaitForSingleObject(event, 0);
|
||||
CloseHandle(event);
|
||||
|
||||
MessageBoxA(0 as _, s!("Ansi"), s!("Caption"), MB_OK);
|
||||
MessageBoxW(0 as _, w!("Wide"), w!("Caption"), MB_OK);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
|
|
|||
|
|
@ -1,7 +1,4 @@
|
|||
/*!
|
||||
Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
*/
|
||||
|
||||
#![doc = include_str!("../readme.md")]
|
||||
#![doc(html_no_source)]
|
||||
#![allow(non_snake_case)]
|
||||
#![cfg_attr(
|
||||
|
|
|
|||
|
|
@ -16,12 +16,10 @@ version = "0.1"
|
|||
Use `cppwinrt` function as needed:
|
||||
|
||||
```rust
|
||||
fn main() {
|
||||
match cppwinrt::cppwinrt(["-help"]) {
|
||||
Ok(output) => println!("{output}"),
|
||||
Err(error) => println!("{error}"),
|
||||
};
|
||||
}
|
||||
match cppwinrt::cppwinrt(["-help"]) {
|
||||
Ok(output) => println!("{output}"),
|
||||
Err(error) => println!("{error}"),
|
||||
};
|
||||
```
|
||||
|
||||
Source:
|
||||
|
|
|
|||
|
|
@ -1,7 +1,4 @@
|
|||
/*!
|
||||
Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
*/
|
||||
|
||||
#![doc = include_str!("../readme.md")]
|
||||
#![cfg(windows)]
|
||||
|
||||
const VERSION: &str = "2.0.240405.15";
|
||||
|
|
|
|||
|
|
@ -1,6 +1,8 @@
|
|||
/*!
|
||||
Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
*/
|
||||
//! Implement COM interfaces for Rust types.
|
||||
//!
|
||||
//! Take a look at [macro@implement] for an example.
|
||||
//!
|
||||
//! Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
|
||||
use quote::{quote, ToTokens};
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,8 @@
|
|||
/*!
|
||||
Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
*/
|
||||
//! Define COM interfaces to call or implement.
|
||||
//!
|
||||
//! Take a look at [macro@interface] for an example.
|
||||
//!
|
||||
//! Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
|
||||
use quote::quote;
|
||||
use syn::spanned::Spanned;
|
||||
|
|
|
|||
|
|
@ -1,7 +1,4 @@
|
|||
/*!
|
||||
Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
*/
|
||||
|
||||
#![doc = include_str!("../readme.md")]
|
||||
#![doc(hidden)]
|
||||
|
||||
use std::cmp::Ordering;
|
||||
|
|
|
|||
|
|
@ -1,7 +1,4 @@
|
|||
/*!
|
||||
Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
*/
|
||||
|
||||
#![doc = include_str!("../readme.md")]
|
||||
#![cfg(windows)]
|
||||
#![no_std]
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,4 @@
|
|||
/*!
|
||||
Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
*/
|
||||
|
||||
#![doc = include_str!("../readme.md")]
|
||||
#![cfg_attr(
|
||||
windows_debugger_visualizer,
|
||||
debugger_visualizer(natvis_file = "../.natvis")
|
||||
|
|
|
|||
|
|
@ -1,7 +1,4 @@
|
|||
/*!
|
||||
Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
*/
|
||||
|
||||
#![doc = include_str!("../readme.md")]
|
||||
#![cfg(windows)]
|
||||
#![allow(non_snake_case)]
|
||||
# and [windows-sys](https://crates.io/crates/windows-sys) crates let you call any Windows API past, present, and future using code generated on the fly directly from the [metadata describing the API](https://github.com/microsoft/windows-rs/tree/master/crates/libs/bindgen/default) and right into your Rust package where you can call them as if they were just another Rust module. The Rust language projection follows in the tradition established by [C++/WinRT](https://github.com/microsoft/cppwinrt) of building language projections for Windows using standard languages and compilers, providing a natural and idiomatic way for Rust developers to call Windows APIs.
|
||||
|
||||
* [Getting started](https://kennykerr.ca/rust-getting-started/)
|
||||
* [Samples](https://github.com/microsoft/windows-rs/tree/0.59.0/crates/samples)
|
||||
* [Releases](https://github.com/microsoft/windows-rs/releases)
|
||||
* [Feature search](https://microsoft.github.io/windows-rs/features/#/0.59.0)
|
||||
|
||||
Start by adding the following to your Cargo.toml file:
|
||||
|
||||
```toml
|
||||
[dependencies.windows]
|
||||
version = "0.58"
|
||||
features = [
|
||||
"Data_Xml_Dom",
|
||||
"Win32_Security",
|
||||
"Win32_System_Threading",
|
||||
"Win32_UI_WindowsAndMessaging",
|
||||
]
|
||||
```
|
||||
|
||||
Make use of any Windows APIs as needed:
|
||||
|
||||
```rust,no_run
|
||||
use windows::{
|
||||
core::*, Data::Xml::Dom::*, Win32::Foundation::*, Win32::System::Threading::*,
|
||||
Win32::UI::WindowsAndMessaging::*,
|
||||
};
|
||||
|
||||
fn main() -> Result<()> {
|
||||
let doc = XmlDocument::new()?;
|
||||
doc.LoadXml(h!("<html>hello world</html>"))?;
|
||||
|
||||
let root = doc.DocumentElement()?;
|
||||
assert!(root.NodeName()? == "html");
|
||||
assert!(root.InnerText()? == "hello world");
|
||||
|
||||
unsafe {
|
||||
let event = CreateEventW(None, true, false, None)?;
|
||||
SetEvent(event)?;
|
||||
WaitForSingleObject(event, 0);
|
||||
CloseHandle(event)?;
|
||||
|
||||
MessageBoxA(None, s!("Ansi"), s!("Caption"), MB_OK);
|
||||
MessageBoxW(None, w!("Wide"), w!("Caption"), MB_OK);
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
```
|
||||
|
||||
## windows-sys
|
||||
|
||||
The `windows-sys` crate is a zero-overhead fallback for the most demanding situations and primarily where the absolute best compile time is essential. It only includes function declarations (externs), structs, and constants. No convenience helpers, traits, or wrappers are provided.
|
||||
|
||||
- [Getting started](https://kennykerr.ca/rust-getting-started/)
|
||||
- [Samples](https://github.com/microsoft/windows-rs/tree/0.59.0/crates/samples)
|
||||
- [Releases](https://github.com/microsoft/windows-rs/releases)
|
||||
- [Feature search](https://microsoft.github.io/windows-rs/features/#/0.59.0)
|
||||
|
||||
Start by adding the following to your Cargo.toml file:
|
||||
|
||||
```toml
|
||||
|
|
|
|||
|
|
@ -1,9 +1,13 @@
|
|||
/*!
|
||||
Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
|
||||
[Feature search](https://microsoft.github.io/windows-rs/features/#/0.59.0)
|
||||
*/
|
||||
|
||||
#![cfg_attr(
|
||||
all(
|
||||
feature = "Win32_Security",
|
||||
feature = "Win32_System_Threading",
|
||||
feature = "Win32_UI_WindowsAndMessaging",
|
||||
),
|
||||
doc = include_str!("../readme.md")
|
||||
)]
|
||||
// fallback if not all features are enabled
|
||||
#")]
|
||||
#![no_std]
|
||||
#![doc(html_no_source)]
|
||||
#![allow(non_snake_case, non_upper_case_globals, non_camel_case_types, missing_docs, clippy::all)]
|
||||
|
|
|
|||
|
|
@ -1,10 +1,11 @@
|
|||
## Import libs for Windows
|
||||
|
||||
The [windows-targets](https://crates.io/crates/windows-targets) crate includes import libs, supports semantic versioning, and optional support for raw-dylib.
|
||||
The [windows-targets](https://crates.io/crates/windows-targets) crate includes import libs, supports semantic versioning, and optional support for raw-dylib.
|
||||
|
||||
* [Getting started](https://kennykerr.ca/rust-getting-started/)
|
||||
* [Samples](https://github.com/microsoft/windows-rs/tree/0.58.0/crates/samples)
|
||||
* [Releases](https://github.com/microsoft/windows-rs/releases)
|
||||
* [Understanding the `windows-targets` crate](https://kennykerr.ca/rust-getting-started/understanding-windows-targets.html)
|
||||
|
||||
Start by adding the following to your Cargo.toml file:
|
||||
|
||||
|
|
@ -15,14 +16,12 @@ version = "0.52"
|
|||
|
||||
Use the `link` macro to define the external functions you wish to call:
|
||||
|
||||
```rust,no_run
|
||||
```rust
|
||||
windows_targets::link!("kernel32.dll" "system" fn SetLastError(code: u32));
|
||||
windows_targets::link!("kernel32.dll" "system" fn GetLastError() -> u32);
|
||||
|
||||
fn main() {
|
||||
unsafe {
|
||||
SetLastError(1234);
|
||||
assert_eq!(GetLastError(), 1234);
|
||||
}
|
||||
unsafe {
|
||||
SetLastError(1234);
|
||||
assert_eq!(GetLastError(), 1234);
|
||||
}
|
||||
```
|
||||
|
|
|
|||
|
|
@ -1,7 +1,4 @@
|
|||
/*!
|
||||
Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
*/
|
||||
|
||||
#![doc = include_str!("../readme.md")]
|
||||
#![no_std]
|
||||
|
||||
/// Defines an external function to import.
|
||||
|
|
|
|||
|
|
@ -2,9 +2,9 @@
|
|||
|
||||
The [windows-version](https://crates.io/crates/windows-version) crate provides reliable operating system version information without the need for application manifest files.
|
||||
|
||||
* [Getting started](https://kennykerr.ca/rust-getting-started/)
|
||||
* [Samples](https://github.com/microsoft/windows-rs/tree/0.58.0/crates/samples)
|
||||
* [Releases](https://github.com/microsoft/windows-rs/releases)
|
||||
- [Getting started](https://kennykerr.ca/rust-getting-started/)
|
||||
- [Samples](https://github.com/microsoft/windows-rs/tree/0.58.0/crates/samples)
|
||||
- [Releases](https://github.com/microsoft/windows-rs/releases)
|
||||
|
||||
Start by adding the following to your Cargo.toml file:
|
||||
|
||||
|
|
@ -15,18 +15,16 @@ version = "0.1"
|
|||
|
||||
Make use of Windows version information as needed:
|
||||
|
||||
```rust,no_run
|
||||
```rust
|
||||
use windows_version::*;
|
||||
|
||||
fn main() {
|
||||
println!("Current version: {:?}", OsVersion::current());
|
||||
println!("Current version: {:?}", OsVersion::current());
|
||||
|
||||
if is_server() {
|
||||
println!("Running on a Windows Server release.");
|
||||
}
|
||||
if is_server() {
|
||||
println!("Running on a Windows Server release.");
|
||||
}
|
||||
|
||||
if OsVersion::current() >= OsVersion::new(10, 0, 0, 12345) {
|
||||
println!("Can use a feature available on this version or later.")
|
||||
}
|
||||
if OsVersion::current() >= OsVersion::new(10, 0, 0, 12345) {
|
||||
println!("Can use a feature available on this version or later.")
|
||||
}
|
||||
```
|
||||
|
|
|
|||
|
|
@ -1,7 +1,4 @@
|
|||
/*!
|
||||
Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
*/
|
||||
|
||||
#![doc = include_str!("../readme.md")]
|
||||
#![cfg(windows)]
|
||||
#![cfg_attr(not(test), no_std)]
|
||||
|
||||
|
|
|
|||
|
|
@ -49,39 +49,3 @@ fn main() -> Result<()> {
|
|||
Ok(())
|
||||
}
|
||||
```
|
||||
|
||||
## windows-sys
|
||||
|
||||
The `windows-sys` crate is a zero-overhead fallback for the most demanding situations and primarily where the absolute best compile time is essential. It only includes function declarations (externs), structs, and constants. No convenience helpers, traits, or wrappers are provided.
|
||||
|
||||
Start by adding the following to your Cargo.toml file:
|
||||
|
||||
```toml
|
||||
[dependencies.windows-sys]
|
||||
version = "0.59"
|
||||
features = [
|
||||
"Win32_Security",
|
||||
"Win32_System_Threading",
|
||||
"Win32_UI_WindowsAndMessaging",
|
||||
]
|
||||
```
|
||||
|
||||
Make use of any Windows APIs as needed:
|
||||
|
||||
```rust,no_run
|
||||
use windows_sys::{
|
||||
core::*, Win32::Foundation::*, Win32::System::Threading::*, Win32::UI::WindowsAndMessaging::*,
|
||||
};
|
||||
|
||||
fn main() {
|
||||
unsafe {
|
||||
let event = CreateEventW(std::ptr::null(), 1, 0, std::ptr::null());
|
||||
SetEvent(event);
|
||||
WaitForSingleObject(event, 0);
|
||||
CloseHandle(event);
|
||||
|
||||
MessageBoxA(0 as _, s!("Ansi"), s!("Caption"), MB_OK);
|
||||
MessageBoxW(0 as _, w!("Wide"), w!("Caption"), MB_OK);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
|
|
|||
|
|
@ -1,11 +1,16 @@
|
|||
#![cfg_attr(docsrs, doc = "This is a stub. The latest API documentation is here: <https://microsoft.github.io/windows-docs-rs/>")]
|
||||
#![cfg_attr(docsrs, doc = "")]
|
||||
/*!
|
||||
Learn more about Rust for Windows here: <https://github.com/microsoft/windows-rs>
|
||||
|
||||
[Feature search](https://microsoft.github.io/windows-rs/features/#/0.58.0)
|
||||
*/
|
||||
|
||||
#![cfg_attr(
|
||||
all(
|
||||
feature = "Data_Xml_Dom",
|
||||
feature = "Win32_Security",
|
||||
feature = "Win32_System_Threading",
|
||||
feature = "Win32_UI_WindowsAndMessaging",
|
||||
),
|
||||
doc = include_str!("../readme.md"),
|
||||
)]
|
||||
// fallback if not all features are enabled
|
||||
#")]
|
||||
#![cfg(windows)]
|
||||
#![doc(html_no_source)]
|
||||
#![allow(non_snake_case, clashing_extern_declarations, non_upper_case_globals, non_camel_case_types, missing_docs, clippy::all)]
|
||||
|
|
|
|||
Загрузка…
Ссылка в новой задаче