pub struct Replication { /* private fields */ }Expand description
Replicates the configured sources and delivers committed changes to handlers.
There is no default handler. Register at least one before starting, to avoid
advancing checkpoints without a consumer. Use with_runtime to register
custom source plugins or version adapters.
Implementations§
Source§impl Replication
impl Replication
Sourcepub fn new(config: AppConfig) -> Result<Self>
pub fn new(config: AppConfig) -> Result<Self>
Examples found in repository?
examples/listen.rs (line 10)
5fn main() -> Result<()> {
6 let Some(path) = std::env::args().nth(1) else {
7 eprintln!("usage: cargo run -p mysql-replication --example listen -- CONFIG.toml");
8 return Ok(());
9 };
10 let mut replication = Replication::new(AppConfig::read(Path::new(&path))?)?;
11 replication.add_handle(|event: Event<'_>| {
12 for change in event.changes {
13 println!(
14 "{} {}.{} {:?} {:?} {:?}",
15 event.source_id,
16 change.table.schema,
17 change.table.table,
18 change.operation,
19 change.pk,
20 change.changed_names().collect::<Vec<_>>()
21 );
22 }
23 Ok(())
24 });
25 replication.run()
26}Sourcepub fn with_runtime(config: AppConfig, runtime: Runtime) -> Result<Self>
pub fn with_runtime(config: AppConfig, runtime: Runtime) -> Result<Self>
Examples found in repository?
examples/custom_version.rs (line 45)
38fn main() -> Result<()> {
39 let Some(path) = std::env::args().nth(1) else {
40 eprintln!("usage: cargo run -p mysql-replication --example custom_version -- CONFIG.toml");
41 return Ok(());
42 };
43 let mut runtime = Runtime::default();
44 runtime.versions.register(Arc::new(CustomMysql))?;
45 let mut replication = Replication::with_runtime(AppConfig::read(Path::new(&path))?, runtime)?;
46 let output = JsonLinesSink::new(BufWriter::new(std::io::stdout()));
47 replication.add_handle(move |event: Event<'_>| {
48 output.commit(event.source_id, event.checkpoint, event.changes)
49 });
50 replication.run()
51}Sourcepub fn add_handle(&mut self, handler: impl EventHandler + 'static) -> &mut Self
pub fn add_handle(&mut self, handler: impl EventHandler + 'static) -> &mut Self
Registers a handler or a Fn(Event<'_>) -> Result<()> closure.
Examples found in repository?
examples/custom_version.rs (lines 47-49)
38fn main() -> Result<()> {
39 let Some(path) = std::env::args().nth(1) else {
40 eprintln!("usage: cargo run -p mysql-replication --example custom_version -- CONFIG.toml");
41 return Ok(());
42 };
43 let mut runtime = Runtime::default();
44 runtime.versions.register(Arc::new(CustomMysql))?;
45 let mut replication = Replication::with_runtime(AppConfig::read(Path::new(&path))?, runtime)?;
46 let output = JsonLinesSink::new(BufWriter::new(std::io::stdout()));
47 replication.add_handle(move |event: Event<'_>| {
48 output.commit(event.source_id, event.checkpoint, event.changes)
49 });
50 replication.run()
51}More examples
examples/listen.rs (lines 11-24)
5fn main() -> Result<()> {
6 let Some(path) = std::env::args().nth(1) else {
7 eprintln!("usage: cargo run -p mysql-replication --example listen -- CONFIG.toml");
8 return Ok(());
9 };
10 let mut replication = Replication::new(AppConfig::read(Path::new(&path))?)?;
11 replication.add_handle(|event: Event<'_>| {
12 for change in event.changes {
13 println!(
14 "{} {}.{} {:?} {:?} {:?}",
15 event.source_id,
16 change.table.schema,
17 change.table.table,
18 change.operation,
19 change.pk,
20 change.changed_names().collect::<Vec<_>>()
21 );
22 }
23 Ok(())
24 });
25 replication.run()
26}Sourcepub fn check(&self) -> Result<()>
pub fn check(&self) -> Result<()>
Validates the upstream settings and whitelist without consuming events.
Sourcepub fn initialize(self) -> Result<()>
pub fn initialize(self) -> Result<()>
Creates initial checkpoints without consuming events.
Sourcepub fn run(self) -> Result<()>
pub fn run(self) -> Result<()>
Consumes continuously until a source or handler fails.
Examples found in repository?
examples/custom_version.rs (line 50)
38fn main() -> Result<()> {
39 let Some(path) = std::env::args().nth(1) else {
40 eprintln!("usage: cargo run -p mysql-replication --example custom_version -- CONFIG.toml");
41 return Ok(());
42 };
43 let mut runtime = Runtime::default();
44 runtime.versions.register(Arc::new(CustomMysql))?;
45 let mut replication = Replication::with_runtime(AppConfig::read(Path::new(&path))?, runtime)?;
46 let output = JsonLinesSink::new(BufWriter::new(std::io::stdout()));
47 replication.add_handle(move |event: Event<'_>| {
48 output.commit(event.source_id, event.checkpoint, event.changes)
49 });
50 replication.run()
51}More examples
examples/listen.rs (line 25)
5fn main() -> Result<()> {
6 let Some(path) = std::env::args().nth(1) else {
7 eprintln!("usage: cargo run -p mysql-replication --example listen -- CONFIG.toml");
8 return Ok(());
9 };
10 let mut replication = Replication::new(AppConfig::read(Path::new(&path))?)?;
11 replication.add_handle(|event: Event<'_>| {
12 for change in event.changes {
13 println!(
14 "{} {}.{} {:?} {:?} {:?}",
15 event.source_id,
16 change.table.schema,
17 change.table.table,
18 change.operation,
19 change.pk,
20 change.changed_names().collect::<Vec<_>>()
21 );
22 }
23 Ok(())
24 });
25 replication.run()
26}Auto Trait Implementations§
impl !RefUnwindSafe for Replication
impl !UnwindSafe for Replication
impl Freeze for Replication
impl Send for Replication
impl Sync for Replication
impl Unpin for Replication
impl UnsafeUnpin for Replication
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> FmtForward for T
impl<T> FmtForward for T
Source§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
Causes
self to use its Binary implementation when Debug-formatted.Source§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
Causes
self to use its Display implementation when
Debug-formatted.Source§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
Causes
self to use its LowerExp implementation when
Debug-formatted.Source§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
Causes
self to use its LowerHex implementation when
Debug-formatted.Source§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
Causes
self to use its Octal implementation when Debug-formatted.Source§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
Causes
self to use its Pointer implementation when
Debug-formatted.Source§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
Causes
self to use its UpperExp implementation when
Debug-formatted.Source§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
Causes
self to use its UpperHex implementation when
Debug-formatted.Source§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
Source§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
Pipes by value. This is generally the method you want to use. Read more
Source§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
Borrows
self and passes that borrow into the pipe function. Read moreSource§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
Mutably borrows
self and passes that borrow into the pipe function. Read moreSource§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
Source§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
Source§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
Borrows
self, then passes self.as_ref() into the pipe function.Source§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
Mutably borrows
self, then passes self.as_mut() into the pipe
function.Source§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
Borrows
self, then passes self.deref() into the pipe function.Source§impl<T> Tap for T
impl<T> Tap for T
Source§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Immutable access to the
Borrow<B> of a value. Read moreSource§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
Mutable access to the
BorrowMut<B> of a value. Read moreSource§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
Immutable access to the
AsRef<R> view of a value. Read moreSource§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
Mutable access to the
AsMut<R> view of a value. Read moreSource§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Immutable access to the
Deref::Target of a value. Read moreSource§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Mutable access to the
Deref::Target of a value. Read moreSource§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
Calls
.tap() only in debug builds, and is erased in release builds.Source§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
Calls
.tap_mut() only in debug builds, and is erased in release
builds.Source§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
Calls
.tap_borrow() only in debug builds, and is erased in release
builds.Source§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
Calls
.tap_borrow_mut() only in debug builds, and is erased in release
builds.Source§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
Calls
.tap_ref() only in debug builds, and is erased in release
builds.Source§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
Calls
.tap_ref_mut() only in debug builds, and is erased in release
builds.Source§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
Calls
.tap_deref() only in debug builds, and is erased in release
builds.