garage/src/util/lib.rs

//! Crate containing common functions and types used in Garage

#[macro_use]
extern crate tracing;

pub mod async_hash;
pub mod background;
pub mod config;
pub mod crdt;
pub mod data;
pub mod encode;
pub mod error;
pub mod forwarded_headers;
pub mod metrics;
pub mod migrate;
pub mod persister;
pub mod time;
pub mod tranquilizer;
pub mod version;
document util crate 2021-03-20 20:38:44 +01:00			`//! Crate containing common functions and types used in Garage`

Split code for modular compilation 2020-04-24 10:10:01 +00:00			`#[macro_use]`
Add tracing integration with opentelemetry 2022-02-17 23:28:23 +01:00			`extern crate tracing;`
Split code for modular compilation 2020-04-24 10:10:01 +00:00
Compute hashes on dedicated threads 2022-07-18 17:18:47 +02:00			`pub mod async_hash;`
Split code for modular compilation 2020-04-24 10:10:01 +00:00			`pub mod background;`
			`pub mod config;`
Improve how node roles are assigned in Garage - change the terminology: the network configuration becomes the role table, the configuration of a nodes becomes a node's role - the modification of the role table takes place in two steps: first, changes are staged in a CRDT data structure. Then, once the user is happy with the changes, they can commit them all at once (or revert them). - update documentation - fix tests - implement smarter partition assignation algorithm This patch breaks the format of the network configuration: when migrating, the cluster will be in a state where no roles are assigned. All roles must be re-assigned and commited at once. This migration should not pose an issue. 2021-11-09 12:24:04 +01:00			`pub mod crdt;`
Split code for modular compilation 2020-04-24 10:10:01 +00:00			`pub mod data;`
Make it explicit when using nonversioned encoding 2023-01-03 15:27:36 +01:00			`pub mod encode;`
Split code for modular compilation 2020-04-24 10:10:01 +00:00			`pub mod error;`
util/forwarded_headers.rs: Generalized handle_forwarded_for_headers() here. 2023-02-09 13:48:48 +00:00			`pub mod forwarded_headers;`
Refactor how durations are measured 2022-02-22 13:53:59 +01:00			`pub mod metrics;`
Refactor how things are migrated 2023-01-03 14:44:47 +01:00			`pub mod migrate;`
Improve bootstraping: do it regularly; persist peer list 2021-04-05 19:55:53 +02:00			`pub mod persister;`
Time and metadata improvements 2021-03-15 16:21:41 +01:00			`pub mod time;`
Add tranquilizer mechanism to improve on token bucket mechanism 2021-11-03 18:28:43 +01:00			`pub mod tranquilizer;`
Configure structopt to report the right version By default, structopt reports the value provided by the env var CARGO_PKG_VERSION, feeded by Cargo when reading Cargo.toml. However for Garage we use a versioning based on git, so we often report a version that is behind the real version. In this commit, we create garage_util::version::garage() that reports the right version and configure all structopt subcommands to call this function instead of using the env var. 2022-08-10 12:18:44 +02:00			`pub mod version;`