Enum ImportingFile 

pub enum ImportingFile<'db> {
    ResolverFile(ResolverFile<'db>),
    File(File, ResolverEnvironment<'db>),
}

The file from which an import is resolved.

Most absolute imports only need the resolver environment. Creating a ResolverFile for each such import would unnecessarily intern the file and environment together, even though that combined identity is never used:

resolve_module(ImportingFile::File(shared.py, environment), "dependency")
    -> resolve using environment; no ResolverFile needed

Relative imports, on the other hand, need the importing file’s module identity and therefore require a ResolverFile:

from .dependency import value
    -> importing_file.resolver_file(db)
    -> ResolverFile(shared.py, environment)

ImportingFile::File defers interning until such a code path actually calls ImportingFile::resolver_file. Callers that already have an interned resolver file can pass ImportingFile::ResolverFile to reuse it directly.

Variants

ResolverFile(ResolverFile<'db>)

An already-interned resolver key that can be reused without materialization.

File(File, ResolverEnvironment<'db>)

An importing file and resolver environment whose combined key is materialized lazily.

Implementations

impl<'db> ImportingFile<'db>

pub fn file(self, db: &dyn Db) -> File

pub fn resolver_environment(self, db: &'db dyn Db) -> ResolverEnvironment<'db>

pub fn python_version(self, db: &'db dyn Db) -> PythonVersion

pub fn resolver_file(self, db: &'db dyn Db) -> ResolverFile<'db>

Returns the existing resolver key or materializes one when required.

Trait Implementations

impl<'db> Clone for ImportingFile<'db>

fn clone(&self) -> ImportingFile<'db>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'db> Copy for ImportingFile<'db>