# Enum cargo::core::resolver::resolve::ResolveVersion

source ·

    pub enum ResolveVersion {
        V1,
        V2,
        V3,
        V4,
        V5,
    }

Expand description

A version to indicate how a `Cargo.lock` should be serialized.

When creating a new lockfile, the version in `ResolveVersion::default` is used. If an old version of lockfile already exists, it will stay as-is.

It’s important that if a new version is added that this is not updated until at least the support for the version is in the stable release of Rust.

This resolve version will be used for all new lock files, for example those generated by `cargo update` (update everything) or building after a `cargo new` (where no lock file previously existed). This is also used for updated lock files such as when a dependency is added or when a version requirement changes. In this situation Cargo’s updating the lock file anyway so it takes the opportunity to bump the lock file version forward.

It’s theorized that we can add more here over time to track larger changes to the `Cargo.lock` format, but we’ve yet to see how that strategy pans out.

## Variants§

§

### V1

Historical baseline for when this abstraction was added.

§

### V2

A more compact format, more amenable to avoiding source-control merge conflicts. The `dependencies` arrays are compressed and checksums are listed inline.

- Introduced in 2019 in version 1.38.
- New lockfiles use V2 by default from 1.41 to 1.52.

§

### V3

A format that explicitly lists a `version` at the top of the file as well as changing how git dependencies are encoded. Dependencies with `branch = "master"` are no longer encoded the same way as those without branch specifiers.

- Introduced in 2020 in version 1.47.
- New lockfiles use V3 by default starting in 1.53.

§

### V4

SourceId URL serialization is aware of URL encoding. For example, `?branch=foo bar` is now encoded as `?branch=foo+bar` and can be decoded back and forth correctly.

- Introduced in 2024 in version 1.78.

§

### V5

Unstable. Will collect a certain amount of changes and then go.

Changes made:

## Implementations§

source§

### impl ResolveVersion

source

#### fn default() -> ResolveVersion

Gets the default lockfile version.

This is intended to be private. You shall use `ResolveVersion::with_rust_version` always.

Update this and the description of enum variants of `ResolveVersion` when we’re changing the default lockfile version.

source

#### pub fn max_stable() -> ResolveVersion

The maximum version of lockfile made into the stable channel.

Any version larger than this needs `-Znext-lockfile-bump` to enable.

Update this when you’re going to stabilize a new lockfile format.

source

#### pub fn with_rust_version(rust_version: Option<&RustVersion>) -> Self

Gets the default lockfile version for the given Rust version.

## Trait Implementations§

source§

### impl Clone for ResolveVersion

source§

#### fn clone(&self) -> ResolveVersion

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from `source`. Read more
source§

### impl Debug for ResolveVersion

source§

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

Formats the value using the given formatter. Read more
source§

### impl Ord for ResolveVersion

source§

#### fn cmp(&self, other: &ResolveVersion) -> Ordering

This method returns an `Ordering` between `self` and `other`. Read more
1.21.0 · source§

#### fn max(self, other: Self) -> Self
where Self: Sized,

Compares and returns the maximum of two values. Read more
1.21.0 · source§

#### fn min(self, other: Self) -> Self
where Self: Sized,

Compares and returns the minimum of two values. Read more
1.50.0 · source§

#### fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized + PartialOrd,

Restrict a value to a certain interval. Read more
source§

### impl PartialEq for ResolveVersion

source§

#### fn eq(&self, other: &ResolveVersion) -> 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.
source§

### impl PartialOrd for ResolveVersion

source§

#### fn partial_cmp(&self, other: &ResolveVersion) -> Option<Ordering>

This method returns an ordering between `self` and `other` values if one exists. Read more
1.0.0 · source§

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

Tests less than (for `self` and `other`) and is used by the `<` operator. Read more
1.0.0 · source§

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

Tests less than or equal to (for `self` and `other`) and is used by the `<=` operator. Read more
1.0.0 · source§

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

Tests greater than (for `self` and `other`) and is used by the `>` operator. Read more
1.0.0 · source§

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

Tests greater than or equal to (for `self` and `other`) and is used by the `>=` operator. Read more
source§

### impl Copy for ResolveVersion

source§

### impl Eq for ResolveVersion

source§

### impl StructuralPartialEq for ResolveVersion

## Auto Trait Implementations§

§

### impl Freeze for ResolveVersion

§

### impl RefUnwindSafe for ResolveVersion

§

### impl Send for ResolveVersion

§

### impl Sync for ResolveVersion

§

### impl Unpin for ResolveVersion

§

### impl UnwindSafe for ResolveVersion

## Blanket Implementations§

source§

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

source§

#### fn type_id(&self) -> TypeId

Gets the `TypeId` of `self`. Read more
source§

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

source§

#### fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

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

source§

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

Mutably borrows from an owned value. Read more
source§

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

source§

#### unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (`clone_to_uninit`)
Performs copy-assignment from `self` to `dst`. Read more
§

### impl<Q, K> Comparable<K> for Q
where Q: Ord + ?Sized, K: Borrow<Q> + ?Sized,

§

#### fn compare(&self, key: &K) -> Ordering

Compare self to `key` and return their ordering.
§

### 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.
source§

### impl<T> From<T> for T

source§

#### 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
source§

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

source§

#### fn into(self) -> U

Calls `U::from(self)`.

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

source§

### impl<T> IntoEither for T

source§

#### fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts `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 more
source§

#### fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts `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 more
§

### impl<T> Pointable for T

§

#### const ALIGN: usize = _

The alignment of pointer.
§

#### type Init = T

The type for initializers.
§

#### unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

#### unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

#### unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

#### unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

### impl<T> Same for T

source§

#### type Output = T

Should always be `Self`
source§

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

source§

#### type Owned = T

The resulting type after obtaining ownership.
source§

#### fn to_owned(&self) -> T

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

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

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

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

source§

#### type Error = Infallible

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

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

source§

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

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
§

### impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

#### fn vzip(self) -> V

§

### 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

## Layout§

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain `repr(...)` attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 1 byte

Size for each variant:

- `V1`: 0 bytes
- `V2`: 0 bytes
- `V3`: 0 bytes
- `V4`: 0 bytes
- `V5`: 0 bytes