Add Enter/LeaveAlternateScreen commands

[zrzka]

• Internal refactoring (no breaking changes)
  • Just to follow the -cursor, etc. code style/structure
• New commands introduced EnterAlternateScreen, LeaveAlternateScreen
• Tested
  • Tested on macOS -> AnsiAlternateScreen
  • Didn't test on Windows -> WinApiAlternateScreen -> @TimonPost please test on Windows

---

Tested with ...

use std::io::{stdout, Write};
use std::thread::sleep;
use std::time::Duration;

use crossterm_screen::{
    execute, AlternateScreen, EnterAlternateScreen, LeaveAlternateScreen, Result,
};

macro_rules! pause {
    () => {
        sleep(Duration::from_secs(2));
    };
}

fn test_commands() -> Result<()> {
    execute!(stdout(), EnterAlternateScreen)?;
    println!("test_commands: Alternate");
    pause!();
    execute!(stdout(), LeaveAlternateScreen)?;
    println!("test_commands: Left alternate");
    Ok(())
}

fn test_struct() -> Result<()> {
    let _alternate = AlternateScreen::to_alternate(false)?;
    println!("test_struct: Alternate");
    pause!();
    Ok(())
}

fn test_struct_raw() -> Result<()> {
    let _alternate = AlternateScreen::to_alternate(true)?;
    println!("test_struct_raw: Alternate");
    println!("Type something, shouldn't be echoed");
    pause!();
    Ok(())
}

fn main() -> Result<()> {
    println!("Main");
    pause!();
    test_commands()?;
    println!("Back on main after test_commands");
    pause!();
    test_struct()?;
    println!("Back on main after test_struct");
    pause!();
    test_struct_raw()?;
    println!("Back on main after test_struct_raw");
    Ok(())
}

[zrzka]

@TimonPost please, test this properly on Windows. I didn't install all the tools on my Windows 10 inside VMware yet.

@Canop just FYI ^ (first comment)

[TimonPost]

Where is Screen, if you removed it, can you add it to the changelog as well?

[zrzka]

Which Screen? Didn't remove it, just comments about non existent Screen.

[TimonPost]

I tested it on windows, and it works. I Meen the Screen type, I can't find it. I think you have renamed it to AlternateScreen instead.

[zrzka]

Thanks for the Windows tests!

Check the diff. I didn't rename anything. There wasn't the Screen type. This doesn't even exist in the old versions, for example 0.2.5 https://docs.rs/crossterm_screen/0.2.5/crossterm_screen/.

[zrzka]

The Screen type was available in the 0.1.0 (https://docs.rs/crossterm_screen/0.1.0/crossterm_screen/) and removed in the 0.2.0 (https://docs.rs/crossterm_screen/0.2.0/crossterm_screen/).

[TimonPost]

Yea I went for a search, I forgot that I've already eliminated it because it wasn't needed anymore. Sorry for the confusion. My dependencies in my brain were not updated yet.