Add function to allow overriding the summary filename

Author: svix-mman

src/generator.rs

@@ -1,8 +1,8 @@
-use std::{io::BufWriter, str::FromStr};
+use std::str::FromStr;
 
 use anyhow::{Context as _, bail};
 use camino::{Utf8Path, Utf8PathBuf};
-use fs_err::{self as fs, File};
+use fs_err as fs;
 use heck::{ToLowerCamelCase, ToSnakeCase as _, ToUpperCamelCase as _};
 use minijinja::{Template, context};
 use serde::Deserialize;
@@ -184,12 +184,15 @@ impl Generator<'_> {
             (None, _) => "summary".to_owned(),
         };
 
-        let file_path = self.output_dir.join(format!("{basename}.{tpl_file_ext}"));
-        generated_paths.push(file_path.clone());
+        let (rendered_data, state) = self.tpl.render_and_return_state(ctx)?;
 
-        let out_file = BufWriter::new(File::create(&file_path)?);
+        let file_path = match state.get_temp("summary_filename") {
+            Some(summary_filename) => self.output_dir.join(summary_filename.as_str().unwrap()),
+            None => self.output_dir.join(format!("{basename}.{tpl_file_ext}")),
+        };
 
-        let state = self.tpl.render_to_write(ctx, out_file)?;
+        generated_paths.push(file_path.clone());
+        fs::write(&file_path, rendered_data)?;
 
         if let Some(extra_generated_file) = state.get_temp("extra_generated_file") {
             let extra_generated_filepath =

src/template.rs

@@ -176,6 +176,14 @@ pub(crate) fn env(tpl_dir: &Utf8Path) -> Result<minijinja::Environment<'static>,
         },
     );
 
+    env.add_function(
+        // allows overriding the summary filename
+        "set_summary_filename",
+        |state: &State, filename: Cow<'_, str>| {
+            state.set_temp("summary_filename", filename.into());
+        },
+    );
+
     env.add_function(
         // For java lib we need to create extra files.
         "generate_extra_file",