Module holochain::conductor::conductor

A Conductor is a dynamically changing group of Cells.

A Conductor can be managed:

• externally, via an AppInterfaceApi
• from within a Cell, via CellConductorApi

In normal use cases, a single Holochain user runs a single Conductor in a single process. However, there’s no reason we can’t have multiple Conductors in a single process, simulating multiple users in a testing environment.

async fn async_main () {
use holochain_state::test_utils::test_db_dir;
use holochain::conductor::{Conductor, ConductorBuilder};
let env_dir = test_db_dir();
let conductor: Conductor = ConductorBuilder::new()
   .test(env_dir.path(), &[])
   .await
   .unwrap();

// conductors are cloneable
let conductor2 = conductor.clone();

assert_eq!(conductor.list_dnas(), vec![]);
conductor.shutdown();

Modules

• __mock_MockAppStoreService
• __mock_MockAppStoreService_AppStoreService
• __mock_MockDpkiService
• __mock_MockDpkiService_DpkiService
• share
  A sync RwLock that uses closures to avoid deadlocks.

Structs

• AppStoreBuiltin
  The built-in implementation of the app store service, which runs a DNA
• Conductor
  A Conductor is a group of Cells
• ConductorBuilder
  A configurable Builder for Conductor and sometimes ConductorHandle
• ConductorServiceCells
  Initialized for ConductorService: just the CellIds that are used for each service
• ConductorServices
  The set of all Conductor Services available to the conductor
• DeepkeyBuiltin
  The built-in implementation of the DPKI service contract, which runs a DNA
• MockAppStoreService
  Interface for the AppStore service
• MockDpkiService
  Interface for the DPKI service
• RwShare
  A clonable thread safe read write lock designed to make it hard to create dead locks or hold long long lived locks.

Enums

• AppHash
  This doesn’t exist yet. We need to define it.
• AppStoreServiceError
  The errors which can be produced by the AppStoreService
• CellStatus
  The status of an installed Cell, which captures different phases of its lifecycle
• DpkiServiceError
  The errors which can be produced by DPKI
• PendingJoinReason
  The reason why a cell is waiting to join the network.

Traits

• AppStoreService
  Interface for the AppStore service
• DpkiService
  Interface for the DPKI service
• DpkiServiceExt
  Some more helpful methods built around the methods provided by the service

Functions

• full_integration_dump
  Dump the full integration json state. Careful! This will return a lot of data.
• integration_dump
  Dump the integration json state.
• mock_app_store
  Create a minimal usable mock of the app store
• mock_dpki
  Create a minimal usable mock of DPKI

Type Aliases

• AppStoreServiceResult
  Alias
• CellStartupErrors
  A list of Cells which failed to start, and why
• CellStatusFilter
  Declarative filter for CellStatus
• ConductorHandle
  Cloneable reference to a Conductor
• DpkiServiceResult
  Alias