Struct Container 

pub struct Container { /* private fields */ }

Application service container

Holds shared services initialized during application bootstrap. Services are wrapped in Arc<T> for thread-safe shared ownership across the application.

Example

use std::path::Path;
use torrust_tracker_deployer_lib::bootstrap::container::Container;
use torrust_tracker_deployer_lib::presentation::cli::views::VerbosityLevel;

let working_dir = Path::new(".");
let container = Container::new(VerbosityLevel::Normal, working_dir);
let user_output = container.user_output();
user_output.lock().borrow_mut().success("Operation completed");

Implementations

impl Container

pub fn new(verbosity_level: VerbosityLevel, working_dir: &Path) -> Self

Create a new container with initialized services

Initializes all services with specified verbosity level and working directory:

• UserOutput with provided verbosity_level
• FileRepositoryFactory with DEFAULT_LOCK_TIMEOUT
• EnvironmentRepository using working_dir/data as base directory
• SystemClock for time operations

Arguments

• verbosity_level - Controls how verbose the user output will be
• working_dir - Base working directory for the application (repository uses working_dir/data)

Examples

use std::path::Path;
use torrust_tracker_deployer_lib::bootstrap::container::Container;
use torrust_tracker_deployer_lib::presentation::cli::views::VerbosityLevel;

// For normal application use
let container = Container::new(VerbosityLevel::Normal, Path::new("."));

// For completely silent testing
let container = Container::new(VerbosityLevel::Silent, Path::new("/tmp/test"));

pub fn user_output(&self) -> Arc<ReentrantMutex<RefCell<UserOutput>>>

Get shared reference to user output service

Returns an Arc<ReentrantMutex<RefCell<UserOutput>>> that can be safely cloned and shared across threads and function calls. Use the reentrant lock to acquire access, then borrow_mut() to get mutable access to the user output. The reentrant mutex prevents deadlocks when the same thread needs to acquire the lock multiple times.

Example

use std::path::Path;
use torrust_tracker_deployer_lib::bootstrap::container::Container;
use torrust_tracker_deployer_lib::presentation::cli::views::VerbosityLevel;

let container = Container::new(VerbosityLevel::Normal, Path::new("."));
let user_output = container.user_output();
user_output.lock().borrow_mut().success("Operation completed");

pub fn file_repository_factory(&self) -> Arc<FileRepositoryFactory>

Get shared reference to repository factory service

Returns an Arc<FileRepositoryFactory> that can be cheaply cloned and shared across threads and function calls.

Example

use std::path::Path;
use torrust_tracker_deployer_lib::bootstrap::container::Container;
use torrust_tracker_deployer_lib::presentation::cli::views::VerbosityLevel;

let container = Container::new(VerbosityLevel::Normal, Path::new("."));
let file_repository_factory = container.file_repository_factory();
// Use file_repository_factory to create repositories

pub fn repository_provider(&self) -> Arc<dyn RepositoryProvider>

Get shared reference to repository provider

Returns an Arc<dyn RepositoryProvider> that can be passed to application-layer handlers without exposing the concrete infrastructure type.

pub fn repository(&self) -> Arc<dyn EnvironmentRepository + Send + Sync>

Get shared reference to environment repository

Returns an Arc<dyn EnvironmentRepository> that can be cheaply cloned and shared across threads and function calls. The repository is initialized with the application’s base data directory during container creation.

Example

use std::path::Path;
use torrust_tracker_deployer_lib::bootstrap::container::Container;
use torrust_tracker_deployer_lib::presentation::cli::views::VerbosityLevel;

let container = Container::new(VerbosityLevel::Normal, Path::new("."));
let repository = container.repository();
// Use repository to load/save environment state

pub fn clock(&self) -> Arc<dyn Clock>

Get shared reference to clock service

Returns an Arc<dyn Clock> that can be cheaply cloned and shared across threads and function calls.

Example

use std::path::Path;
use torrust_tracker_deployer_lib::bootstrap::container::Container;
use torrust_tracker_deployer_lib::presentation::cli::views::VerbosityLevel;

let container = Container::new(VerbosityLevel::Normal, Path::new("."));
let clock = container.clock();
// Use clock for time operations

pub fn create_environment_controller( &self, ) -> CreateEnvironmentCommandController

Create a new CreateEnvironmentCommandController

pub fn create_template_controller(&self) -> CreateTemplateCommandController

Create a new CreateTemplateCommandController

pub fn create_schema_controller(&self) -> CreateSchemaCommandController

Create a new CreateSchemaCommandController

pub fn create_docs_controller(&self) -> DocsCommandController

Create a new DocsCommandController

pub fn create_provision_controller(&self) -> ProvisionCommandController

Create a new ProvisionCommandController

pub fn create_destroy_controller(&self) -> DestroyCommandController

Create a new DestroyCommandController

pub fn create_purge_controller(&self) -> PurgeCommandController

Create a new PurgeCommandController

pub fn create_configure_controller(&self) -> ConfigureCommandController

Create a new ConfigureCommandController

pub fn create_test_controller(&self) -> TestCommandController

Create a new TestCommandController

pub fn create_validate_controller(&self) -> ValidateCommandController

Create a new ValidateCommandController

pub fn create_register_controller(&self) -> RegisterCommandController

Create a new RegisterCommandController

pub fn create_release_controller(&self) -> ReleaseCommandController

Create a new ReleaseCommandController

pub fn create_render_controller(&self) -> RenderCommandController

Create a new RenderCommandController

pub fn create_run_controller(&self) -> RunCommandController

Create a new RunCommandController

pub fn create_show_controller(&self) -> ShowCommandController

Create a new ShowCommandController

pub fn create_exists_controller(&self) -> ExistsCommandController

Create a new ExistsCommandController

pub fn create_list_controller(&self) -> ListCommandController

Create a new ListCommandController

pub fn data_directory(&self) -> Arc<Path>

Get shared reference to data directory path

Returns an Arc<Path> pointing to the data directory where environment state files are stored.

Trait Implementations

impl Clone for Container

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Container

fn default() -> Self

Returns the “default value” for a type.