Method insert_usage_import_statement

src/modules/function/declaration.rs:525–558

(
        &self,
        meta: &ParserMetadata,
        mut comment_text: String,
    )

impl FunctionDeclaration {
    fn insert_usage_import_statement(
        &self,
        meta: &ParserMetadata,
        mut comment_text: String,
    ) -> String {
        if meta.doc_usage {
            let lib_name = meta
                .context
                .path
                .as_ref()
                .map(Path::new)
                .and_then(Path::file_name)
                .and_then(OsStr::to_str)
                .map(|s| s.trim_end_matches(".ab"))
                .map(String::from)
                .unwrap_or_default();
            let import_stmt = format!("import {{ {} }} from \"std/{}\"\n", self.name, lib_name);

            let usage_pattern = regex::Regex::new(r"#\s*Usage\s+```ab").unwrap();
            if usage_pattern.is_match(&comment_text) {
                // Insert import statement after "# Usage"
                return usage_pattern
                    .replace(&comment_text, |caps: &regex::Captures| {
                        format!("{}\n{}", &caps[0], import_stmt)
                    })
                    .to_string();
            } else {
                comment_text += "```ab\n";
                comment_text += &import_stmt;
                comment_text += "```";
            }
        }
        comment_text
    }
}