winapi-easy

An ergonomic and safe interface to some Windows API functionality.

Design

This is an experimental library designed as an abstraction over the Windows API with the following properties:

• Properly typed parameters, making wrong usage of the API difficult
• Automatic release of resources on drop
• No unsafe functionality exposed to the user outside of 'escape hatches'
• Consistent error handling without special numerical return values

Expect breaking changes between versions. Any kind of feature completeness is also unrealistic given the huge size of the Windows API.

Features

• Keyboard and mouse control (sending events, hotkeys, hooking)
• Creating windows and manipulating window properties
• Window actions like minimize, flash, taskbar progress animation
• Creating notification icons & menus
• Magnification API
• Running message loops & listening for events
• Process and thread functionality (including CPU & IO priority)
• File transfers with progress notifications

Development

Check code quality:

cargo +nightly clippy -- -D clippy::pedantic

Check that all features work independently with cargo-hack:

cargo hack test --each-feature

Generate and check docs:

cargo +nightly doc --no-deps

Fix formatting:

cargo +nightly fmt

License

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.