Lib.rs

Cargo Features

[dependencies]
holochain = { version = "0.5.0-rc.1", default-features = false, features = ["metrics_influxive", "test_utils", "fuzzing", "slow_tests", "glacial_tests", "build_wasms", "only_check_wasms", "sqlite-encrypted", "sqlite", "wasmer_debug_memory", "wasmer_sys", "wasmer_wamr", "chc", "unstable-dpki", "unstable-migration", "unstable-warrants", "unstable-sharding", "sweettest", "deepkey-wasm-cache", "instrument", "unstable-functions", "unstable-countersigning"] }

default = metrics_influxive, sqlite-encrypted, wasmer_sys

These default features are set whenever holochain is added without default-features = false somewhere in the dependency tree.

metrics_influxive default

Use the "Influxive" opentelemetry metrics binding to write metrics to an InfluxDB time series database.

Enables influxive of holochain_metrics

test_utils sweettest? = async-once-cell, contrafact, deepkey-wasm-cache, diff, fixt, get_if_addrs, holochain_test_wasm_common, holochain_wasm_test_utils, kitsune2_bootstrap_srv, matches, unwrap_to

Exposes additional functionality only needed for integration tests.
This feature should be turned off for production builds.

Enables test_utils of hdk, fixturators of holo_hash, test_utils of holochain_cascade, test-utils of holochain_conductor_api, test_utils of holochain_conductor_services, mock_network of holochain_p2p, test_utils of holochain_sqlite, holochain_state, holochain_types, and holochain_zome_types

Affects holochain::fixt…

fuzzing

slow_tests

Wasm ribosome tests take > 60 seconds - let's only run them in CI

glacial_tests

What's slower than slow? We may choose to not run these tests in CI to speed things up.

build_wasms

Includes the wasm build script, which we don't need when not building wasms

Enables build of holochain_wasm_test_utils

only_check_wasms

Enables only_check of holochain_wasm_test_utils

sqlite-encrypted default

Enables at-rest encryption of the SQLite database.
Incompatible with "sqlite".

Enables bundled-sqlcipher-vendored-openssl of rusqlite ^0.32.1, sqlite-encrypted of holo_hash, holochain_cascade, holochain_conductor_api, holochain_keystore, holochain_p2p, holochain_sqlite, holochain_state, holochain_types, and holochain_zome_types

sqlite sweettest?

Compile SQLite from source rather than depending on a library.
Incompatible with "sqlite-encrypted"

Enables bundled of rusqlite ^0.32.1, sqlite of holo_hash, holochain_cascade, holochain_conductor_api, holochain_keystore, holochain_p2p, holochain_sqlite, holochain_state, holochain_types, and holochain_zome_types

wasmer_debug_memory

Extremely verbose wasm memory read/write logging

Enables debug_memory of holochain_wasmer_host

wasmer_sys default

Enable wasm compiler
Incompatible with "wasmer_wamr"

Enables wasmer and wasmer-middlewares, wasmer_sys_dev of holochain_wasmer_host

wasmer_wamr

Enable wasm interpreter (experimental)
Incompatible with "wasmer_sys"

Enables wasmer_wamr of holochain_wasmer_host, wamr of wasmer

chc

Enable chain head coordination

Enables reqwest, http of holochain_chc, chc of holochain_conductor_api and holochain_conductor_config and bytes

chc deps

Affects conductor::chc…

unstable-dpki = unstable-migration

Enable unstable DPKI feature.

Enables unstable-dpki of holochain_conductor_api, holochain_conductor_config, holochain_wasm_test_utils, and holochain_zome_types

unstable-migration unstable-dpki?

Enable the unstable migration feature

Enables unstable-migration of holochain_conductor_api and holochain_types

unstable-warrants

Enables unstable warrants feature.

Enables unstable-warrants of holochain_cascade and holochain_state

unstable-sharding

Enable sharding for networks. This is currently considered an unstable feature and with the feature disabled you will only be able to configure nodes that have a full or empty arc.

sweettest = sqlite, test_utils

deepkey-wasm-cache test_utils?

instrument

Enables tracing instrumentation
(we experience segfaults in some tests if there is too much instrumentation)

unstable-functions

Enables unstable-functions of hdk, holochain_wasm_test_utils, and holochain_zome_types

Affects tests::agent_lineage…

unstable-countersigning

Enables unstable-countersigning of hdk, holochain_conductor_api, and holochain_zome_types

Affects api_cell::CellConductorReadHandleT.accept_countersigning_session…

Features from optional dependencies

In crates that don't use the dep: syntax, optional dependencies automatically become Cargo features. These features may have been created by mistake, and this functionality may be removed in the future.

reminder - do not use workspace deps

fixt test_utils?

Enables fixt

Dependencies for test_utils / other optional deps

contrafact test_utils?

diff test_utils?

hdk test_utils? unstable-countersigning? unstable-functions?

matches test_utils?

holochain_wasm_test_utils build_wasms? only_check_wasms? test_utils? unstable-dpki? unstable-functions?

holochain_test_wasm_common test_utils?

unwrap_to test_utils?

kitsune2_bootstrap_srv test_utils?

async-once-cell test_utils?

get_if_addrs test_utils?