Skip to main content

StagingStrategy

ta_submit::config

Enum StagingStrategy

pub enum StagingStrategy {
    Full,
    Smart,
    RefsCow,
    ProjFs,
}

Expand description

How the staging workspace copies the source project (v0.13.13).

Configured in workflow.toml under [staging]:

[staging]
strategy = "smart"   # "full" | "smart" | "refs-cow"

Full (default): byte-for-byte copy, always works, may be slow for large workspaces.
Smart: symlinks .taignore/protected_paths entries instead of copying them — near-zero staging cost for large ignored directories (e.g., node_modules/, UE Content/).
RefsCow: Windows ReFS Dev Drive only — instant zero-cost clone via FSCTL_DUPLICATE_EXTENTS_TO_FILE; auto-falls back to smart on NTFS.

Variants§

Full

Byte-for-byte copy of the source project. Always works; may be slow for large workspaces.

Smart

Symlink excluded directories instead of copying. Fast for large workspaces with many ignored dirs.

RefsCow

Windows ReFS CoW clone. Auto-falls back to smart on non-ReFS volumes.

ProjFs

Windows Projected File System — zero-disk-cost virtual workspace (v0.15.8).

Files appear in staging instantly; reads hydrate from source on demand. Writes land in .projfs-scratch/. Auto-falls back to smart when Client-ProjFS is not installed (requires Windows 10 1809+).

Implementations§

impl StagingStrategy

pub fn as_str(&self) -> &'static str

Trait Implementations§

impl Clone for StagingStrategy

fn clone(&self) -> StagingStrategy

Returns a duplicate of the value. Read more

1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

impl Debug for StagingStrategy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

impl Default for StagingStrategy

fn default() -> StagingStrategy

Returns the “default value” for a type. Read more

impl<'de> Deserialize<'de> for StagingStrategy

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

impl PartialEq for StagingStrategy

fn eq(&self, other: &StagingStrategy) -> bool

Tests for self and other values to be equal, and is used by ==.

1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for StagingStrategy

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
where S: Serializer,

Serialize this value into the given Serde serializer. Read more

impl Eq for StagingStrategy

impl StructuralPartialEq for StagingStrategy

Auto Trait Implementations§

impl Freeze for StagingStrategy

impl RefUnwindSafe for StagingStrategy

impl Send for StagingStrategy

impl Sync for StagingStrategy

impl Unpin for StagingStrategy

impl UnsafeUnpin for StagingStrategy

impl UnwindSafe for StagingStrategy

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)

Performs copy-assignment from self to dest. Read more

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> PolicyExt for T
where T: ?Sized,

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more

impl<T> Same for T

type Output = T

Should always be Self

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,