From e70ffc81399f0f90f71fd269f4ba2ee90ca20c4a Mon Sep 17 00:00:00 2001
From: 魏曹先生 <1992414357@qq.com>
Date: Tue, 18 Aug 2026 02:23:13 +0800
Subject: chore!: simplify DirectoryEnvironmentSetup to unit struct

Remove the generic parameter `C` from `DirectoryEnvironmentSetup`,
making it a unit struct that no longer requires `::<C>::default()` for
construction. Update the `ProgramSetup` impl and the `setup` method
signature accordingly, and improve the doc comments.
---
 mingling/src/setups/dirs.rs | 70 ++++++++++++++++++++++++++++-----------------
 1 file changed, 43 insertions(+), 27 deletions(-)

(limited to 'mingling/src')

diff --git a/mingling/src/setups/dirs.rs b/mingling/src/setups/dirs.rs
index ea7f282..65196c2 100644
--- a/mingling/src/setups/dirs.rs
+++ b/mingling/src/setups/dirs.rs
@@ -1,37 +1,53 @@
-// Doc Not Optimize
-use std::marker::PhantomData;
-
-use mingling_core::{ProgramCollect, setup::ProgramSetup};
+use mingling_core::{Program, ProgramCollect, setup::ProgramSetup};
 
 use crate::res::{ResCurrentDir, ResCurrentExe, ResHomeDir, ResTempDir};
 
-/// Provides the ability to set up commonly used directory resources for the program.
-///
-/// This setup item registers the following directory resources in the program:
-/// - `ResCurrentDir`: Current working directory
-/// - `ResCurrentExe`: Directory containing the executable
-/// - `ResHomeDir`: User's home directory
-/// - `ResTempDir`: Temporary directory
-pub struct DirectoryEnvironmentSetup<C> {
-    _collect: PhantomData<C>,
-}
-
-impl<C> Default for DirectoryEnvironmentSetup<C>
-where
-    C: ProgramCollect<Enum = C> + 'static,
-{
-    fn default() -> Self {
-        Self {
-            _collect: PhantomData,
-        }
-    }
-}
+/// `Directory Environment` Setup for managing common directory resources
+///
+/// This Setup registers commonly used directory resources into the program's
+/// resource store. It provides the current working directory, the executable's
+/// directory, the user's home directory, and the system's temporary directory,
+/// so that these paths can be retrieved from the resource store without
+/// recomputing them each time.
+///
+/// # Usage
+///
+/// This Setup can be registered using the
+/// [`Program`](https://docs.rs/mingling/latest/mingling/struct.Program.html)
+/// `with_setup` method, for example:
+///
+/// ```rust
+/// # use mingling::MockProgramCollect as ThisProgram;
+/// use mingling::Program;
+/// use mingling::setup::DirectoryEnvironmentSetup;
+///
+/// let mut program = Program::<ThisProgram>::new();
+/// program.with_setup(DirectoryEnvironmentSetup);
+/// ```
+///
+/// # Behavior
+///
+/// - Registers an [`ResCurrentDir`] resource containing the current working
+///   directory.
+/// - Registers an [`ResCurrentExe`] resource containing the directory of the
+///   currently running executable.
+/// - Registers an [`ResHomeDir`] resource containing the user's home directory.
+/// - Registers an [`ResTempDir`] resource containing the system's temporary
+///   directory.
+///
+/// # Notes
+///
+/// - All directory values are resolved at setup time and stored in the
+///   resource store.
+/// - These resources can be retrieved later using the program's `resource`
+///   accessor with the corresponding resource type.
+pub struct DirectoryEnvironmentSetup;
 
-impl<C> ProgramSetup<C> for DirectoryEnvironmentSetup<C>
+impl<C> ProgramSetup<C> for DirectoryEnvironmentSetup
 where
     C: ProgramCollect<Enum = C> + 'static,
 {
-    fn setup(self, program: &mut crate::Program<C>) {
+    fn setup(self, program: &mut Program<C>) {
         program.with_resource(ResCurrentDir::default());
         program.with_resource(ResCurrentExe::default());
         program.with_resource(ResHomeDir::default());
-- 
cgit