Struct SourceManager

pub struct SourceManager { /* private fields */ }

Holds a list of Source objects and selects one to use when loading a package

Implementations

impl SourceManager

pub fn new() -> SourceManager

Constructs a new, empty SourceManager

Examples found in repository

examples/basic.rs (line 58)

fn main()
{
    println!("Listing items in mypackage/text:");
    
    let mut source = FilesystemSource::new("examples", TrustLevel::TrustedSource);
    let iter = source.iter_entries("mypackage", "text");
    
    for entry in iter
    {
        match entry
        {
            Ok(pathname) => println!("{}", pathname),
            Err(error) => println!("Error: {}", error)
        }
    }
    
    println!("Loading files from mypackage/text...");
    
    let source_manager = Rc::new(RefCell::new(SourceManager::new()));
    source_manager.borrow_mut().add_source(Box::new(source));
    
    let mut store = DataStore::<TextData>::new(source_manager);
    
    store.load_package("mypackage").expect("Failed to load package.");
    
    for name in &["emoji.txt", "missingfile.txt", "loremipsum.txt"]
    {
        match store.get_id("mypackage", name)
        {
            Ok(id) =>
            {
                println!("Contents of {}:", name);
                match store.get(id)
                {
                    Some(data) => println!("{}", data.text),
                    None => println!("(not found)"),
                }
            }
            Err(error) =>
            {
                println!("Error for {}:\n{}", name, error);
            }
        }
        
        println!("");
    }
}

pub fn add_source(&mut self, source: Box<dyn Source>) -> SourceId

Adds the given Source to the end of the list.

Examples found in repository

examples/basic.rs (line 59)

fn main()
{
    println!("Listing items in mypackage/text:");
    
    let mut source = FilesystemSource::new("examples", TrustLevel::TrustedSource);
    let iter = source.iter_entries("mypackage", "text");
    
    for entry in iter
    {
        match entry
        {
            Ok(pathname) => println!("{}", pathname),
            Err(error) => println!("Error: {}", error)
        }
    }
    
    println!("Loading files from mypackage/text...");
    
    let source_manager = Rc::new(RefCell::new(SourceManager::new()));
    source_manager.borrow_mut().add_source(Box::new(source));
    
    let mut store = DataStore::<TextData>::new(source_manager);
    
    store.load_package("mypackage").expect("Failed to load package.");
    
    for name in &["emoji.txt", "missingfile.txt", "loremipsum.txt"]
    {
        match store.get_id("mypackage", name)
        {
            Ok(id) =>
            {
                println!("Contents of {}:", name);
                match store.get(id)
                {
                    Some(data) => println!("{}", data.text),
                    None => println!("(not found)"),
                }
            }
            Err(error) =>
            {
                println!("Error for {}:\n{}", name, error);
            }
        }
        
        println!("");
    }
}

pub fn source(&mut self, id: SourceId) -> Option<&mut Box<dyn Source>>

Returns a reference to the Source of the given ID.

pub fn package_source_id(&self, package_name: &str) -> SourceId

Returns the SourceId of the Source that has the given package, going in reverse order of when they were added. If no suitable Source is available, returns a “null” ID.

pub fn package_source( &mut self, package_name: &str, ) -> Option<&mut Box<dyn Source>>

Retrieves a mutable reference to a Source that has the given package, going in reverse order of when they were added. If no suitable Source is available, returns None.

pub fn clear(&mut self)

Removes all sources from the manager. Existing source IDs are invalidated.