vector_core/
lib.rs

1//! The Vector Core Library
2//!
3//! The Vector Core Library are the foundational pieces needed to make a vector
4//! and is not vector with pieces missing. While this library is obviously
5//! tailored to the needs of vector it is written in such a way to make
6//! experimentation and testing _in the library_ cheap and demonstrative.
7//!
8//! This library was extracted from the top-level project package, discussed in
9//! RFC 7027.
10
11#![deny(warnings)]
12#![deny(clippy::all)]
13#![deny(clippy::pedantic)]
14#![deny(unreachable_pub)]
15#![deny(unused_allocation)]
16#![deny(unused_extern_crates)]
17#![deny(unused_assignments)]
18#![deny(unused_comparisons)]
19#![allow(clippy::cast_possible_wrap)]
20#![allow(clippy::cast_sign_loss)]
21#![allow(clippy::default_trait_access)] // triggers on generated prost code
22#![allow(clippy::float_cmp)]
23#![allow(clippy::match_wildcard_for_single_variants)]
24#![allow(clippy::module_name_repetitions)]
25#![allow(clippy::must_use_candidate)] // many false positives in this package
26#![allow(clippy::non_ascii_literal)] // using unicode literals is a-okay in vector
27#![allow(clippy::unnested_or_patterns)] // nightly-only feature as of 1.51.0
28#![allow(clippy::type_complexity)] // long-types happen, especially in async code
29
30pub mod config;
31pub mod event;
32pub mod fanout;
33pub mod ipallowlist;
34pub mod metrics;
35pub mod partition;
36pub mod schema;
37pub mod serde;
38pub mod sink;
39pub mod source;
40pub mod source_sender;
41pub mod tcp;
42#[cfg(test)]
43mod test_util;
44pub mod time;
45pub mod tls;
46pub mod transform;
47#[cfg(feature = "vrl")]
48pub mod vrl;
49
50use std::path::PathBuf;
51
52pub use event::EstimatedJsonEncodedSizeOf;
53use float_eq::FloatEq;
54
55#[cfg(feature = "vrl")]
56pub use crate::vrl::compile_vrl;
57
58#[macro_use]
59extern crate tracing;
60
61pub fn default_data_dir() -> Option<PathBuf> {
62    Some(PathBuf::from("/var/lib/vector/"))
63}
64
65pub(crate) use vector_common::{Error, Result};
66
67pub(crate) fn float_eq(l_value: f64, r_value: f64) -> bool {
68    (l_value.is_nan() && r_value.is_nan()) || l_value.eq_ulps(&r_value, &1)
69}
70
71// These macros aren't actually usable in lib crates without some `vector_lib` shenanigans.
72#[macro_export]
73macro_rules! emit {
74    ($event:expr) => {
75        vector_lib::internal_event::emit($event)
76    };
77}
78
79#[macro_export]
80macro_rules! register {
81    ($event:expr) => {
82        vector_lib::internal_event::register($event)
83    };
84}
vector_core/lib.rs

vector_core/
lib.rs
