#windows

no-std fenestroj

Easier wrappers for Win32 API stuff, safe when possible

13 releases

0.0.11 Feb 22, 2020
0.0.10 Feb 22, 2020
0.0.9 Jan 31, 2020
0.0.3 Aug 18, 2019
0.0.2 Jul 22, 2019

#29 in Windows APIs

Download history 4/week @ 2021-01-13 3/week @ 2021-01-20 2/week @ 2021-01-27 2/week @ 2021-02-03 90/week @ 2021-02-10 41/week @ 2021-02-17 3/week @ 2021-02-24 3/week @ 2021-03-03 2/week @ 2021-03-10 2/week @ 2021-03-17 35/week @ 2021-03-24 27/week @ 2021-03-31 15/week @ 2021-04-07 35/week @ 2021-04-14 4/week @ 2021-04-21 15/week @ 2021-04-28

60 downloads per month
Used in vanadium

Zlib license

87KB
2K SLoC

License:Zlib Minimum Rust Version travis.ci AppVeyor crates.io docs.rs

fenestroj

Easier to use wrappers for winapi stuff.

All wrappers are kept in feature gated modules the same as how winapi works.

Conventions

  • Names:
    • Snake case function names: GetLastError becomes get_last_error
    • If there's an A and W variant of a winapi function, the W variant is used without "_w" on the end: GetMessageW becomes get_message
    • Some functions are new utilities to this crate, they just have names that don't conflict with any winapi name.
  • Arguments:
    • Enums are used when possible.
    • If there's some "obvious" default for the user to calculate then Option is sometimes used and it will do the calculation for you.
    • Functions with a large number of arguments are converted to take a single struct with a field for each argument so you don't have to remember the ordering perfectly.
  • Return Values:
    • Usage of bool, Option, or Result is done whenever possible.
    • Numeric codes are given newtype wrappers as often as possible: u32 error values become wrapped in pub struct ErrorCode(pub u32) for example.
  • Safety:
    • Things are all still left as unsafe until a careful investigation of the safety involved can be done.
    • The investigation process is generally "ask WinBun and hope they're not too busy to answer".

Dependencies

~34KB