Struct FixtureDatabase 

pub struct FixtureDatabase {
    pub definitions: Arc<DashMap<String, Vec<FixtureDefinition>>>,
    pub file_definitions: Arc<DashMap<PathBuf, HashSet<String>>>,
    pub usages: Arc<DashMap<PathBuf, Vec<FixtureUsage>>>,
    pub file_cache: Arc<DashMap<PathBuf, Arc<String>>>,
    pub undeclared_fixtures: Arc<DashMap<PathBuf, Vec<UndeclaredFixture>>>,
    pub imports: Arc<DashMap<PathBuf, HashSet<String>>>,
    pub canonical_path_cache: Arc<DashMap<PathBuf, PathBuf>>,
    pub line_index_cache: Arc<DashMap<PathBuf, (u64, Arc<Vec<usize>>)>>,
    pub ast_cache: Arc<DashMap<PathBuf, (u64, Arc<Mod>)>>,
}

The central database for fixture definitions and usages.

Uses DashMap for lock-free concurrent access during workspace scanning.

Fields

definitions: Arc<DashMap<String, Vec<FixtureDefinition>>>

Map from fixture name to all its definitions (can be in multiple conftest.py files).

file_definitions: Arc<DashMap<PathBuf, HashSet<String>>>

Reverse index: file path -> fixture names defined in that file. Used for efficient cleanup when a file is re-analyzed.

usages: Arc<DashMap<PathBuf, Vec<FixtureUsage>>>

Map from file path to fixtures used in that file.

file_cache: Arc<DashMap<PathBuf, Arc<String>>>

Cache of file contents for analyzed files (uses Arc for efficient sharing).

undeclared_fixtures: Arc<DashMap<PathBuf, Vec<UndeclaredFixture>>>

Map from file path to undeclared fixtures used in function bodies.

imports: Arc<DashMap<PathBuf, HashSet<String>>>

Map from file path to imported names in that file.

canonical_path_cache: Arc<DashMap<PathBuf, PathBuf>>

Cache of canonical paths to avoid repeated filesystem calls.

line_index_cache: Arc<DashMap<PathBuf, (u64, Arc<Vec<usize>>)>>

Cache of line indices (byte offsets) for files to avoid recomputation. Stores (content_hash, line_index) to invalidate when content changes.

ast_cache: Arc<DashMap<PathBuf, (u64, Arc<Mod>)>>

Cache of parsed AST for files to avoid re-parsing. Stores (content_hash, ast) to invalidate when content changes.

Implementations

impl FixtureDatabase

pub fn analyze_file(&self, file_path: PathBuf, content: &str)

Analyze a Python file for fixtures and usages. This is the public API - it cleans up previous definitions before analyzing.

impl FixtureDatabase

pub fn print_fixtures_tree( &self, root_path: &Path, skip_unused: bool, only_unused: bool, )

Print fixtures as a tree structure

impl FixtureDatabase

pub fn find_fixture_definition( &self, file_path: &Path, line: u32, character: u32, ) -> Option<FixtureDefinition>

Find fixture definition for a given position in a file

pub fn get_definition_at_line( &self, file_path: &Path, line: usize, fixture_name: &str, ) -> Option<FixtureDefinition>

Public method to get the fixture definition at a specific line and name

pub fn find_fixture_at_position( &self, file_path: &Path, line: u32, character: u32, ) -> Option<String>

Find the fixture name at a given position (either definition or usage)

pub fn extract_word_at_position( &self, line: &str, character: usize, ) -> Option<String>

Extract the word at a given character position in a line

pub fn find_fixture_references(&self, fixture_name: &str) -> Vec<FixtureUsage>

Find all references (usages) of a fixture by name

pub fn find_references_for_definition( &self, definition: &FixtureDefinition, ) -> Vec<FixtureUsage>

Find all references that resolve to a specific fixture definition

pub fn get_undeclared_fixtures( &self, file_path: &Path, ) -> Vec<UndeclaredFixture>

Get all undeclared fixture usages for a file

pub fn get_available_fixtures(&self, file_path: &Path) -> Vec<FixtureDefinition>

Get all available fixtures for a given file

pub fn get_completion_context( &self, file_path: &Path, line: u32, character: u32, ) -> Option<CompletionContext>

Get the completion context for a given position

pub fn get_function_param_insertion_info( &self, file_path: &Path, function_line: usize, ) -> Option<ParamInsertionInfo>

Get information about where to insert a new parameter in a function signature

pub fn is_inside_function( &self, file_path: &Path, line: u32, character: u32, ) -> Option<(String, bool, Vec<String>)>

Check if a position is inside a test or fixture function (parameter or body) Returns Some((function_name, is_fixture, declared_params)) if inside a function

impl FixtureDatabase

pub fn scan_workspace(&self, root_path: &Path)

Scan a workspace directory for test files and conftest.py files.

impl FixtureDatabase

pub fn new() -> Self

Create a new empty fixture database.

pub fn cleanup_file_cache(&self, file_path: &Path)

Remove all cached data for a file. Called when a file is closed or deleted to prevent unbounded cache growth.

Trait Implementations

impl Debug for FixtureDatabase

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

Formats the value using the given formatter.

impl Default for FixtureDatabase

fn default() -> Self

Returns the “default value” for a type.