brokk-bifrost-python 0.15.2

Python language knowledge for brokk-bifrost: module identity, declarations, imports, and usage-graph resolution
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

//! Legacy usage-index source layered over the surviving Python source helpers.

pub use crate::source_support::*;
use crate::usage_index::PythonUsageIndex;
use brokk_bifrost_core::analyzer::ProjectFile;
use std::sync::Arc;

/// [`PythonSource`] plus the built usage index. Everything reached from
/// the export/importer walks needs it; the index build itself must not.
pub trait PythonUsageSource: PythonSource {
    fn usage_index(&self) -> Arc<PythonUsageIndex>;
    fn module_binding_timeline(
        &self,
        file: &ProjectFile,
        build: &mut dyn FnMut() -> crate::usage_index::ModuleBindingTimeline,
    ) -> Arc<crate::usage_index::ModuleBindingTimeline>;
    fn scope_facts(
        &self,
        file: &ProjectFile,
        build: &mut dyn FnMut() -> Option<crate::usage_index::PythonScopeFacts>,
    ) -> Option<Arc<crate::usage_index::PythonScopeFacts>>;

    /// A cancelled initialization publishes no partial index.
    fn usage_index_with_cancellation(
        &self,
        cancellation: &brokk_bifrost_core::CancellationToken,
    ) -> Option<Arc<PythonUsageIndex>>;
}