Struct History 

pub struct History {
    pub version: u32,
    pub projects: HashMap<PathBuf, ProjectHistory>,
}

Global history storage.

Fields

version: u32

Version of the history format.

projects: HashMap<PathBuf, ProjectHistory>

History per project path.

Implementations

impl History

pub const VERSION: u32 = 1u32

Current history format version.

pub fn new() -> Self

Create a new history.

pub fn file_path() -> Option<PathBuf>

Get the history file path.

pub fn load() -> Result<Self>

Load history from the default location.

Handles missing files gracefully (returns empty history). Handles corrupt files by backing up and returning empty history.

pub fn save(&self) -> Result<()>

Save history to the default location.

pub fn get_project(&self, project_dir: &Path) -> Option<&ProjectHistory>

Get history for a project.

pub fn get_project_mut( &mut self, project_dir: &Path, ) -> Option<&mut ProjectHistory>

Get mutable history for a project.

pub fn get_or_create_project( &mut self, project_dir: &Path, ) -> &mut ProjectHistory

Get or create history for a project.

pub fn record_run( &mut self, project_dir: &Path, script: &str, args: Option<String>, )

Record a script execution.

pub fn get_last_script( &self, project_dir: &Path, ) -> Option<(String, Option<String>)>

Get the last executed script for a project with its arguments.

pub fn get_script_stats( &self, project_dir: &Path, script: &str, ) -> Option<&ScriptHistory>

Get statistics for a specific script in a project.

pub fn get_sorted_by_recent<'a>( &self, project_dir: &Path, scripts: &'a [Script], ) -> Vec<&'a Script>

Sort scripts by recent usage (most recently/frequently used first).

Scripts with history are sorted by score, scripts without history are placed at the end in their original order.

pub fn get_sorted_by_recent_at<'a>( &self, project_dir: &Path, scripts: &'a [Script], now: DateTime<Utc>, ) -> Vec<&'a Script>

Sort scripts by recent usage at a specific time (for testing).

pub fn cleanup(&mut self, config: &HistoryConfig)

Enforce max_projects and max_scripts limits using LRU eviction.

pub fn cleanup_with_limits(&mut self, max_projects: usize, max_scripts: usize)

Cleanup with specific limits.

Trait Implementations

impl Clone for History

fn clone(&self) -> History

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for History

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for History

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for History

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for History

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.