winscribe 0.1.3

Inscribe Windows resource & manifest files onto your executables
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

//! Version-information resource. ([`VERSIONINFO`](crate::version_info::VersionInfo))

mod block;
mod fixed;

pub use block::*;
pub use fixed::*;

use crate::{ResError, ResWriter, Resource};

/// Version-information resource. (`VERSIONINFO`)
///
/// Defines a version-information resource. The resource contains information about the file
/// as its version number, intended operating system, original filename, etc.
///
/// More info: <https://learn.microsoft.com/windows/win32/menurc/versioninfo-resource>
#[derive(Debug, Default)]
pub struct VersionInfo {
    /// Fixed fields of the `VERSIONINFO` resource.
    pub fixed: FixedInfo,
    /// String and variable information block of the `VERSIONINFO` resource.
    pub block: BlockInfo,
}

impl VersionInfo {
    /// Creates a new `VERSIONINFO`.
    pub fn new() -> Self {
        Self::default()
    }

    /// Creates a new `VERSIONINFO` with the default values retrieved from Cargo's environment variables.
    pub fn from_env() -> Result<Self, ResError> {
        Ok(Self {
            fixed: FixedInfo::from_env()?,
            block: BlockInfo::from_env()?,
        })
    }

    /// Sets the Windows Language Code of the resource.
    ///
    /// Some possible values:
    /// * Language Netural: `0x0000`
    /// * English (`en`): `0x0009`
    /// * English - United States (`en-US`): `0x0409`
    ///
    /// More info about the accepted values:\
    /// <https://learn.microsoft.com/openspecs/windows_protocols/ms-lcid>
    pub fn with_language(mut self, language: u16) -> Self {
        self.block.language = language;
        self
    }
}

impl Resource for VersionInfo {
    fn write(&self, writer: &mut ResWriter) -> Result<(), ResError> {
        writer.line("1 VERSIONINFO");
        self.fixed.write(writer);
        self.block.write(writer);
        Ok(())
    }
}