pub(in state_migration) struct StateMigration<BS> {
migrations: CidHashMap<Arc<dyn ActorMigration<BS> + Send + Sync>>,
verifier: Option<Arc<dyn ActorMigrationVerifier<BS> + Send + Sync>>,
post_migrators: Vec<Arc<dyn PostMigrator<BS>>>,
post_migration_checks: Vec<Arc<dyn PostMigrationCheck<BS>>>,
}Expand description
Handles several cases of migration:
- nil migrations, essentially mapping one Actor to another,
- migrations where state upgrade is required,
- creating new actors that were not present in the prior network version.
Fields§
§migrations: CidHashMap<Arc<dyn ActorMigration<BS> + Send + Sync>>§verifier: Option<Arc<dyn ActorMigrationVerifier<BS> + Send + Sync>>Verifies correctness of the migration specification.
post_migrators: Vec<Arc<dyn PostMigrator<BS>>>Post migrator(s). This may include new actor creation.
post_migration_checks: Vec<Arc<dyn PostMigrationCheck<BS>>>Post migration checks. This is used to verify the correctness of the migration.
Implementations§
Source§impl<BS: Blockstore> StateMigration<BS>
impl<BS: Blockstore> StateMigration<BS>
pub(in state_migration) fn new( verifier: Option<Arc<dyn ActorMigrationVerifier<BS> + Send + Sync>>, ) -> Self
Sourcepub(in state_migration) fn add_migrator(
&mut self,
prior_cid: Cid,
migrator: Arc<dyn ActorMigration<BS> + Send + Sync>,
)
pub(in state_migration) fn add_migrator( &mut self, prior_cid: Cid, migrator: Arc<dyn ActorMigration<BS> + Send + Sync>, )
Inserts a new migrator into the migration specification.
Sourcepub(in state_migration) fn add_post_migrator(
&mut self,
post_migrator: Arc<dyn PostMigrator<BS>>,
)
pub(in state_migration) fn add_post_migrator( &mut self, post_migrator: Arc<dyn PostMigrator<BS>>, )
Inserts a new post migrator into the post migration specification.
Sourcepub(in state_migration) fn add_post_migration_check(
&mut self,
post_migration_check: Arc<dyn PostMigrationCheck<BS>>,
)
pub(in state_migration) fn add_post_migration_check( &mut self, post_migration_check: Arc<dyn PostMigrationCheck<BS>>, )
Inserts a new post migration check into the post migration checks specification.
Source§impl<BS: Blockstore + Send + Sync> StateMigration<BS>
impl<BS: Blockstore + Send + Sync> StateMigration<BS>
pub(in state_migration) fn migrate_state_tree( &self, store: &BS, prior_epoch: i64, actors_in: StateTree<BS>, actors_out: StateTree<BS>, ) -> Result<Cid>
Source§impl<BS: Blockstore + Send + Sync> StateMigration<BS>
impl<BS: Blockstore + Send + Sync> StateMigration<BS>
pub fn add_nv17_migrations( &mut self, store: &Arc<BS>, actors_in: &mut StateTree<BS>, new_manifest: &BuiltinActorManifest, prior_epoch: i64, chain: NetworkChain, ) -> Result<()>
Source§impl<BS: Blockstore> StateMigration<BS>
impl<BS: Blockstore> StateMigration<BS>
Source§impl<BS: Blockstore> StateMigration<BS>
impl<BS: Blockstore> StateMigration<BS>
Source§impl<BS: Blockstore> StateMigration<BS>
impl<BS: Blockstore> StateMigration<BS>
pub fn add_nv21_migrations( &mut self, store: &Arc<BS>, state: &Cid, new_manifest: &BuiltinActorManifest, chain_config: &ChainConfig, ) -> Result<()>
Source§impl<BS: Blockstore> StateMigration<BS>
impl<BS: Blockstore> StateMigration<BS>
pub fn add_nv21fix_migrations( &mut self, store: &Arc<BS>, state: &Cid, new_manifest: &BuiltinActorManifest, ) -> Result<()>
Source§impl<BS: Blockstore> StateMigration<BS>
impl<BS: Blockstore> StateMigration<BS>
pub fn add_nv21fix2_migrations( &mut self, store: &Arc<BS>, state: &Cid, new_manifest: &BuiltinActorManifest, ) -> Result<()>
Source§impl<BS: Blockstore> StateMigration<BS>
impl<BS: Blockstore> StateMigration<BS>
pub fn add_nv22_migrations( &mut self, store: &Arc<BS>, state: &Cid, new_manifest: &BuiltinActorManifest, chain_config: &ChainConfig, ) -> Result<()>
Source§impl<BS: Blockstore> StateMigration<BS>
impl<BS: Blockstore> StateMigration<BS>
pub fn add_nv22fix_migrations( &mut self, store: &Arc<BS>, state: &Cid, new_manifest: &BuiltinActorManifest, ) -> Result<()>
Source§impl<BS: Blockstore> StateMigration<BS>
impl<BS: Blockstore> StateMigration<BS>
pub fn add_nv23_migrations( &mut self, store: &Arc<BS>, state: &Cid, new_manifest: &BuiltinActorManifest, _chain_config: &ChainConfig, ) -> Result<()>
Source§impl<BS: Blockstore> StateMigration<BS>
impl<BS: Blockstore> StateMigration<BS>
pub fn add_nv24_migrations( &mut self, store: &Arc<BS>, state: &Cid, new_manifest: &BuiltinActorManifest, chain_config: &ChainConfig, ) -> Result<()>
Source§impl<BS: Blockstore> StateMigration<BS>
impl<BS: Blockstore> StateMigration<BS>
pub fn add_nv25_migrations( &mut self, store: &Arc<BS>, state: &Cid, new_manifest: &BuiltinActorManifest, ) -> Result<()>
Source§impl<BS: Blockstore> StateMigration<BS>
impl<BS: Blockstore> StateMigration<BS>
pub fn add_nv26fix_migrations( &mut self, store: &Arc<BS>, state: &Cid, new_manifest: &BuiltinActorManifest, ) -> Result<()>
Source§impl<BS: Blockstore> StateMigration<BS>
impl<BS: Blockstore> StateMigration<BS>
pub fn add_nv27_migrations( &mut self, store: &Arc<BS>, state: &Cid, new_manifest: &BuiltinActorManifest, ) -> Result<()>
Source§impl<BS: Blockstore> StateMigration<BS>
impl<BS: Blockstore> StateMigration<BS>
pub fn add_nv28_migrations( &mut self, store: &Arc<BS>, state: &Cid, new_manifest: &BuiltinActorManifest, ) -> Result<()>
Auto Trait Implementations§
impl<BS> Freeze for StateMigration<BS>
impl<BS> !RefUnwindSafe for StateMigration<BS>
impl<BS> Send for StateMigration<BS>
impl<BS> Sync for StateMigration<BS>
impl<BS> Unpin for StateMigration<BS>
impl<BS> UnsafeUnpin for StateMigration<BS>
impl<BS> !UnwindSafe for StateMigration<BS>
Blanket Implementations§
Source§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
Source§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
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
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,
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,
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,
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,
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,
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,
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,
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,
self to use its UpperHex implementation when
Debug-formatted.Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self with the foreground set to
value.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red() and
green(), which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg():
use yansi::{Paint, Color};
painted.fg(Color::White);Set foreground color to white using white().
use yansi::Paint;
painted.white();Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self with the background set to
value.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red() and
on_green(), which have the same functionality but
are pithier.
§Example
Set background color to red using fg():
use yansi::{Paint, Color};
painted.bg(Color::Red);Set background color to red using on_red().
use yansi::Paint;
painted.on_red();Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute value.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold() and
underline(), which have the same functionality
but are pithier.
§Example
Make text bold using attr():
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);Make text bold using using bold().
use yansi::Paint;
painted.bold();Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi Quirk value.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask() and
wrap(), which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk():
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);Enable wrapping using wrap().
use yansi::Paint;
painted.wrap();Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting() due to conflicts with Vec::clear().
The clear() method will be removed in a future release.
fn clear(&self) -> Painted<&T>
renamed to resetting() due to conflicts with Vec::clear().
The clear() method will be removed in a future release.
Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted only when both stdout and stderr are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);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,
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,
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,
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
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
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
self, then passes self.deref() into the pipe function.Source§impl<T> Pointable for T
impl<T> Pointable for T
Source§impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> PolicyExt for Twhere
T: ?Sized,
Source§impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
Source§fn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
self from the equivalent element of its
superset. Read moreSource§fn is_in_subset(&self) -> bool
fn is_in_subset(&self) -> bool
self is actually part of its subset T (and can be converted to it).Source§fn to_subset_unchecked(&self) -> SS
fn to_subset_unchecked(&self) -> SS
self.to_subset but without any property checks. Always succeeds.Source§fn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
self to the equivalent element of its superset.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
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
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
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
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
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
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
.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
.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
.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
.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
.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
.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
.tap_deref() only in debug builds, and is erased in release
builds.