Struct ProjectIndex 

pub struct ProjectIndex {
    pub projects: HashMap<String, Project>,
    pub last_sync: DateTime<Utc>,
    pub version: u32,
}

Project index with caching and sync capabilities

Fields

projects: HashMap<String, Project>

All discovered projects, keyed by absolute path

last_sync: DateTime<Utc>

Last sync timestamp

version: u32

Schema version for future migrations

Implementations

impl ProjectIndex

pub fn new() -> Self

Create a new empty project index

pub fn load() -> Result<Self>

Load index from cache file (~/.cache/px/projects.json)

If the cache file doesn’t exist or can’t be read, returns a new empty index. This makes the first run seamless - users just run px sync to populate.

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

Save index to cache file

Creates the cache directory if it doesn’t exist.

pub fn sync(&mut self, scan_dirs: &[PathBuf]) -> Result<usize>

Sync/rebuild the project index by scanning configured directories

This is the core indexing operation that:

1. Scans all configured directories for git repositories
2. Extracts metadata for each project
3. Preserves frecency data for existing projects
4. Saves the updated index to disk

Returns the number of projects found.

pub fn record_access(&mut self, project_path: &str) -> Result<()>

Record project access for frecency tracking

Updates access_count, last_accessed, and recalculates frecency_score. Changes are persisted to disk immediately.

pub fn sorted_projects(&self) -> Vec<&Project>

Get projects as a sorted vector (by frecency)

Trait Implementations

impl Debug for ProjectIndex

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

Formats the value using the given formatter.

impl Default for ProjectIndex

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ProjectIndex

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ProjectIndex

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

where __S: Serializer,

Serialize this value into the given Serde serializer.