opencv 0.76.3

Rust bindings for OpenCV
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

use std::ffi::OsStr;
use std::path::Path;
use std::{env, fs};

use crate::{files_with_extension, MANIFEST_DIR, OUT_DIR};

pub enum GenerateFullBindings {
	Stop,
	Proceed,
}

pub fn handle_running_in_docsrs() -> GenerateFullBindings {
	if env::var_os("DOCS_RS").is_some() {
		let docs_dir = MANIFEST_DIR.join("docs");
		// fake setup for docs.rs
		println!(r#"cargo:rustc-cfg=ocvrs_opencv_branch_4"#);
		transfer_bindings_from_docs(&docs_dir, &OUT_DIR);
		for path in files_with_extension(&docs_dir.join("hub"), "rs").expect("Can't read hub dir") {
			if let Some(module) = path.file_stem().and_then(OsStr::to_str) {
				println!("cargo:rustc-cfg=ocvrs_has_module_{module}");
			}
		}
		GenerateFullBindings::Stop
	} else {
		GenerateFullBindings::Proceed
	}
}

/// Copies files from docs/ to OUT_DIR, for building in docs.rs
pub fn transfer_bindings_from_docs(src_dir: &Path, out_dir: &Path) {
	let target_dir = out_dir.join("opencv");
	let target_hub_dir = target_dir.join("hub");
	fs::create_dir_all(&target_hub_dir).expect("Can't create target directory");
	let hub_rs = fs::read_to_string(src_dir.join("hub.rs")).expect("Can't read hub.rs");
	let hub_rs = hub_rs.replace("$[OUT_DIR]", out_dir.to_str().expect("Can't convert OUT_DIR to str"));
	fs::write(target_dir.join("hub.rs"), hub_rs).expect("Can't write hub.rs");
	for path in files_with_extension(&src_dir.join("hub"), "rs").expect("Can't read hub dir") {
		let file_name = path.file_name().expect("Can't get file name");
		fs::copy(&path, target_hub_dir.join(file_name))
			.unwrap_or_else(|e| panic!("Can't copy module file: {}, error: {e}", path.display()));
	}
}

/// Copies files from OUT_DIR to docs/ for generating files for docs.rs
pub fn transfer_bindings_to_docs(out_dir: &Path, target_dir: &Path) {
	let src_dir = out_dir.join("opencv");
	let target_hub_dir = target_dir.join("hub");
	fs::create_dir_all(&target_hub_dir).expect("Can't create target directory");
	let hub_rs = fs::read_to_string(src_dir.join("hub.rs")).expect("Can't read hub.rs");
	let hub_rs = hub_rs.replace(out_dir.to_str().expect("Can't convert OUT_DIR to str"), "$[OUT_DIR]");
	fs::write(target_dir.join("hub.rs"), hub_rs).expect("Can't write hub.rs");
	for path in files_with_extension(&target_hub_dir, "rs").expect("Can't read target hub directory") {
		let _ = fs::remove_file(path);
	}
	for path in files_with_extension(&src_dir.join("hub"), "rs").expect("Can't read hub dir") {
		let file_name = path.file_name().expect("Can't get file name");
		fs::copy(&path, target_hub_dir.join(file_name))
			.unwrap_or_else(|e| panic!("Can't copy module file: {}, error: {e}", path.display()));
	}
}