From c5736152b0adeef17349265c4b9277ba17b8bcfd Mon Sep 17 00:00:00 2001
From: 魏曹先生 <1992414357@qq.com>
Date: Sat, 11 Jul 2026 14:44:17 +0800
Subject: feat: require renderers to return RenderResult instead of mutating
 one

BREAKING CHANGE: The `render` method on `Renderer`, `HelpRequest`, and
`ProgramCollect` now returns `RenderResult` instead of taking
`&mut RenderResult`. The `r_print!` and `r_println!` macros have been
removed in favor of using `std::io::Write` directly on `RenderResult`.
---
 mling/src/cli.rs | 29 ++++++++++++++---------------
 1 file changed, 14 insertions(+), 15 deletions(-)

(limited to 'mling/src/cli.rs')

diff --git a/mling/src/cli.rs b/mling/src/cli.rs
index 3000645..bfe602c 100644
--- a/mling/src/cli.rs
+++ b/mling/src/cli.rs
@@ -8,13 +8,13 @@ use crate::{
 };
 use colored::Colorize;
 use mingling::{
-    Groupped, Program,
+    Groupped, Program, RenderResult,
     hook::ProgramHook,
-    macros::{chain, help, pack, program_setup, r_println, renderer},
+    macros::{chain, help, pack, program_setup, renderer},
     res::ResExitCode,
     setup::{ExitCodeSetup, HelpFlagSetup, QuietFlagSetup, StructuralRendererSetup},
 };
-use std::{env::current_dir, path::PathBuf, process::exit, str::FromStr};
+use std::{env::current_dir, io::Write, path::PathBuf, process::exit, str::FromStr};
 
 pub fn run() {
     #[cfg(windows)]
@@ -167,21 +167,20 @@ pub fn handle_error_dispatcher_not_found(err: ErrorDispatcherNotFound) -> Next {
 }
 
 #[renderer]
-pub fn render_mling_help(_prev: ResultMlingHelp, ec: &mut ResExitCode) {
-    r_println!("{}", markdown(include_str!("helps/mling_help.txt")));
+pub fn render_mling_help(_prev: ResultMlingHelp, ec: &mut ResExitCode) -> RenderResult {
+    let mut result = RenderResult::default();
+    writeln!(result, "{}", markdown(include_str!("helps/mling_help.txt"))).ok();
     ec.exit_code = 0;
+    result
 }
 
 #[renderer]
-pub fn render_unknown_command(prev: ResultUnknownCommand, ec: &mut ResExitCode) {
-    r_println!(
-        "{}",
-        eformat_cargo!("no such command: `{}`", prev.bright_yellow().bold())
-    );
-    r_println!();
-    r_println!(
-        "{}",
-        hformat_cargo!("view all commands with `cargo help mling`")
-    );
+pub fn render_unknown_command(prev: ResultUnknownCommand, ec: &mut ResExitCode) -> RenderResult {
+    let mut result = RenderResult::default();
+    writeln!(result, "{}", eformat_cargo!("no such command: `{}`", prev.bright_yellow().bold())).ok();
+    writeln!(result).ok();
+    writeln!(result, "{}", hformat_cargo!("view all commands with `cargo help mling`"))
+        .ok();
     ec.exit_code = 101;
+    result
 }
-- 
cgit