//! Helper functions for handling the Windows console from a GUI context.

//!

//! Windows subsystem applications must explicitly attach to an existing console

//! before stdio works, and if not available, create their own if they wish to

//! print anything.

//!

//! These functions enable that, primarily for the purposes of displaying Rust

//! panics.

use std::result::Result;

use merc_utilities::MercError;

#[cfg(windows)]

use winapi::um::consoleapi::AllocConsole;

#[cfg(windows)]

use winapi::um::wincon::ATTACH_PARENT_PROCESS;

#[cfg(windows)]

use winapi::um::wincon::AttachConsole;

#[cfg(windows)]

use winapi::um::wincon::FreeConsole;

#[cfg(windows)]

use winapi::um::wincon::GetConsoleWindow;

pub struct Console {

    #[cfg(windows)]

    attached: bool,

}

/// Initialises the console. On Windows this either attaches to the

    #[cfg(windows)]

    unsafe {

        // SAFETY: Only unsafe because we use the winapi crate to call Windows API functions.

        // Check if we're attached to an existing Windows console

        if GetConsoleWindow().is_null() {

            // Try to attach to an existing Windows console.

            //

            // It's normally a no-brainer to call this - it just makes println! and friends

            // work as expected, without cluttering the screen with a console in the general

            // case.

            if AttachConsole(ATTACH_PARENT_PROCESS) == 0 {

                // Try to attach to a console, and if not, allocate ourselves a new one.

                if AllocConsole() != 0 {

                    Ok(Console { attached: false })

                } else {

                    Err("Failed to attach to a console, and to create one".into())

                }

            } else {

                // We attached to an existing console.

                Ok(Console { attached: true })

            }

        } else {

            // The program was started with a console attached.

            Ok(Console { attached: true })

        }

    }

    #[cfg(not(windows))]

    {

    }

impl Drop for Console {

        // Free the allocated console, when it was not attached.

        #[cfg(windows)]

        if !self.attached {

            unsafe { FreeConsole() };

        }

}