timecat 1.33.4

A NNUE-based chess engine that implements the Negamax algorithm and can be integrated into any project as a library. It features move generation, advanced position evaluation through NNUE, and move searching capabilities.
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

pub type Result<T> = std::result::Result<T, Box<dyn std::error::Error>>;

#[cfg(feature = "inbuilt_nnue")]
mod nnue_features {
    use super::*;
    pub use std::fs::File;
    pub use std::io::Write;
    pub use std::path::{Path, PathBuf};

    pub const NNUE_FILE_NAME: &str = "nn-62ef826d1a6d.nnue";
    // pub const NNUE_FILE_NAME: &str = "nn-f7d87b7a1789.nnue";
    // const NNUE_FILE_NAME: &str = "nn-c3ca321c51c9.nnue";

    pub fn remove_nnue_file(nnue_path: &Path) -> Result<()> {
        if nnue_path.is_file() {
            let err_msg = format!(
                "Could not delete file {}!",
                nnue_path.to_str().ok_or("NNUE Path not found")?
            );
            std::fs::remove_file(nnue_path).map_err(|_| err_msg)?;
        }
        Ok(())
    }

    pub fn nnue_downloaded_correctly(nnue_path: &Path) -> Result<bool> {
        if !nnue_path.is_file() {
            return Ok(false);
        }
        let expected_hash_start = NNUE_FILE_NAME
            .strip_prefix("nn-")
            .unwrap()
            .strip_suffix(".nnue")
            .unwrap();
        let nnue_data = std::fs::read(nnue_path)?;
        let hash = sha256::digest(nnue_data.as_slice());
        Ok(hash.starts_with(expected_hash_start))
    }

    pub fn generate_nnue_file(nnue_file: &mut File) -> Result<()> {
        let url = format!("https://tests.stockfishchess.org/api/nn/{}", NNUE_FILE_NAME);
        let response = minreq::get(url).send()?;
        if response.status_code == 200 {
            nnue_file
                .write_all(response.as_bytes())
                .map_err(|_| "Could not copy NNUE file data to the nnue file!")?;
            Ok(())
        } else {
            Err(format!("Could not download NNUE file! Check your internet connection! Got response status code {}", response.status_code).into())
        }
    }

    pub fn check_and_download_nnue(nnue_dir: &PathBuf) -> Result<()> {
        if !nnue_dir.is_dir() {
            std::fs::create_dir_all(nnue_dir.clone())?;
        }
        let nnue_path = nnue_dir.join("nn.nnue");
        if !nnue_downloaded_correctly(&nnue_path)? {
            remove_nnue_file(&nnue_path)?;
            let mut nnue_file = File::create(nnue_path.clone())
                .map_err(|_| format!("Failed to create file at {:?}", nnue_dir))?;
            println!("cargo:rerun-if-env-changed=DOCS_RS");
            println!("cargo:rerun-if-env-changed=NNUE_DOWNLOAD");
            if std::env::var("DOCS_RS").is_ok()
                || std::env::var("NNUE_DOWNLOAD") == Ok("PAUSE".to_string())
            {
                return Ok(());
            }
            match generate_nnue_file(&mut nnue_file) {
                Ok(_) => {
                    println!("cargo:rerun-if-changed={:?}", nnue_path);
                }
                Err(err) => {
                    remove_nnue_file(&nnue_path)?;
                    return Err(err);
                }
            }
            if !nnue_downloaded_correctly(&nnue_path)? {
                return Err("File not downloaded correctly!".into());
            }
        }
        Ok(())
    }
}

#[cfg(feature = "inbuilt_nnue")]
fn main() -> Result<()> {
    use nnue_features::*;

    let output_dir = std::env::var("OUT_DIR")?;
    let output_nnue_dir = Path::new(&output_dir).join("nnue_dir");
    // Backing up nnue file in local cache directory to prevent downloading it multiple times
    let nnue_dir = dirs::cache_dir()
        .map(|path| path.join("timecat").join("nnue_dir"))
        .unwrap_or(output_nnue_dir.clone());
    match check_and_download_nnue(&nnue_dir) {
        Ok(_) => {
            if nnue_dir != output_nnue_dir {
                std::fs::create_dir_all(output_nnue_dir.clone())?;
                std::fs::copy(nnue_dir.join("nn.nnue"), output_nnue_dir.join("nn.nnue"))?;
            }
        }
        Err(err) => {
            if nnue_dir == output_nnue_dir {
                return Err(err);
            } else {
                check_and_download_nnue(&output_nnue_dir)?;
            }
        }
    }
    Ok(())
}

#[cfg(not(feature = "inbuilt_nnue"))]
fn main() -> Result<()> {
    Ok(())
}