From dc501290f7b25b72edf8c67555b5604ac5fc8a59 Mon Sep 17 00:00:00 2001
From: 魏曹先生 <1992414357@qq.com>
Date: Sat, 11 Apr 2026 22:28:26 +0800
Subject: Add dev tools to generate example documentation

---
 dev_tools/src/bin/refresh-examples.rs | 139 ++++++++++++++++++++++++++++++++++
 1 file changed, 139 insertions(+)
 create mode 100644 dev_tools/src/bin/refresh-examples.rs

(limited to 'dev_tools/src/bin/refresh-examples.rs')

diff --git a/dev_tools/src/bin/refresh-examples.rs b/dev_tools/src/bin/refresh-examples.rs
new file mode 100644
index 0000000..9fdc7b5
--- /dev/null
+++ b/dev_tools/src/bin/refresh-examples.rs
@@ -0,0 +1,139 @@
+use std::path::PathBuf;
+
+use just_fmt::snake_case;
+use just_template::{Template, tmpl};
+
+const EXAMPLE_ROOT: &str = "./examples/";
+const OUTPUT_PATH: &str = "./mingling/src/example_docs.rs";
+
+const TEMPLATE_CONTENT: &str = include_str!("../../../mingling/src/example_docs.rs.tmpl");
+
+struct ExampleContent {
+    name: String,
+    header: String,
+    code: String,
+    cargo_toml: String,
+}
+
+impl ExampleContent {
+    pub fn read(name: &str) -> Self {
+        let repo = find_git_repo().unwrap();
+        let cargo_toml = Self::read_cargo_toml(&repo, name);
+        let (header, code) = Self::read_header_and_code(&repo, name);
+
+        let cargo_toml = cargo_toml
+            .lines()
+            .map(|line| format!("/// {}", line))
+            .collect::<Vec<_>>()
+            .join("\n");
+
+        let header = header
+            .lines()
+            .map(|line| format!("/// {}", line))
+            .collect::<Vec<_>>()
+            .join("\n");
+
+        let code = code
+            .lines()
+            .map(|line| format!("/// {}", line))
+            .collect::<Vec<_>>()
+            .join("\n");
+
+        ExampleContent {
+            name: name.to_string(),
+            header,
+            code,
+            cargo_toml,
+        }
+    }
+
+    fn read_header_and_code(repo: &PathBuf, name: &str) -> (String, String) {
+        let file_path = repo
+            .join(EXAMPLE_ROOT)
+            .join(name)
+            .join("src")
+            .join("main.rs");
+        let content = std::fs::read_to_string(&file_path).unwrap_or_default();
+        let mut lines = content.lines();
+        let mut header = String::new();
+        let mut code = String::new();
+
+        // Collect header lines (starting with //!)
+        while let Some(line) = lines.next() {
+            if line.trim_start().starts_with("//!") {
+                let trimmed = line.trim_start_matches("//!").trim();
+                header.push_str(trimmed);
+                header.push('\n');
+            } else {
+                // First non-header line found, start collecting code
+                code.push_str(line);
+                code.push('\n');
+                break;
+            }
+        }
+
+        // Collect remaining code lines
+        for line in lines {
+            code.push_str(line);
+            code.push('\n');
+        }
+
+        (header.trim().to_string(), code.trim().to_string())
+    }
+
+    fn read_cargo_toml(repo: &PathBuf, name: &str) -> String {
+        let file_path = repo.join(EXAMPLE_ROOT).join(name).join("Cargo.toml");
+        let content = std::fs::read_to_string(&file_path).unwrap_or_default();
+        content
+    }
+}
+
+fn main() {
+    let mut template = Template::from(TEMPLATE_CONTENT);
+    let repo_root = find_git_repo().unwrap();
+    let example_root = repo_root.join(EXAMPLE_ROOT);
+    let mut examples = Vec::new();
+    if let Ok(entries) = std::fs::read_dir(&example_root) {
+        for entry in entries.flatten() {
+            if let Ok(file_type) = entry.file_type() {
+                if file_type.is_dir() {
+                    let example_name = entry.file_name().to_string_lossy().to_string();
+                    let example_content = ExampleContent::read(&example_name);
+                    examples.push(example_content);
+                }
+            }
+        }
+    }
+
+    for example in examples {
+        tmpl!(template += {
+            examples {
+                (
+                    example_header = example.header,
+                    example_import = example.cargo_toml,
+                    example_code = example.code,
+                    example_name = snake_case!(example.name)
+                )
+            }
+        });
+    }
+
+    std::fs::write(repo_root.join(OUTPUT_PATH), template.to_string()).unwrap();
+}
+
+fn find_git_repo() -> Option<std::path::PathBuf> {
+    let mut current_dir = std::env::current_dir().ok()?;
+
+    loop {
+        let git_dir = current_dir.join(".git");
+        if git_dir.exists() && git_dir.is_dir() {
+            return Some(current_dir);
+        }
+
+        if !current_dir.pop() {
+            break;
+        }
+    }
+
+    None
+}
-- 
cgit