pub struct ModelRef {
pub model: String,
pub git_ref: GitRef,
}Expand description
Model reference with typed git references Examples: “llama3” -> model “llama3” with GitRef::DefaultBranch “llama3:main” -> model “llama3” with GitRef::Branch(“main”) “llama3:v2.0” -> model “llama3” with GitRef::Tag(“v2.0”) “llama3:abc123” -> model “llama3” with GitRef::Commit(oid) “llama3:HEAD~1” -> model “llama3” with GitRef::Revspec(“HEAD~1”)
Fields§
§model: Stringprefer at:// / did: federated ModelRefs (#395); use ModelRef::name() for read access
Local registry name of the model (e.g. Qwen3-0.6B).
§Deprecation notice (#395)
The name layer is being retired in favor of federated at:// / did:
ModelRefs (see services::model::ModelService::resolve_model_ref). New
code should treat a model’s identity as its content-addressed CID, not its
local registry name. Use ModelRef::name for read access — direct field
access is #[deprecated] to mark the direction without breaking callers.
The field itself stays pub (and the constructor / parser remain) so the
migration is opt-in: every existing caller keeps compiling. The name layer
dies when all callers have migrated to at://.
git_ref: GitRefImplementations§
Source§impl ModelRef
impl ModelRef
Sourcepub fn with_ref(model: String, git_ref: GitRef) -> Self
pub fn with_ref(model: String, git_ref: GitRef) -> Self
Create a new ModelRef with a specific git reference
Sourcepub fn name(&self) -> &str
pub fn name(&self) -> &str
Read the local registry name.
Non-deprecated accessor for the ModelRef::model field so internal
callers (registry lookup, worktree paths) don’t trip the field-level
#[deprecated] lint during the name-layer retirement (#395). External
consumers reading .model by name get the deprecation notice; this
accessor is the sanctioned read path until the name layer is removed.
Sourcepub fn git_ref_str(&self) -> Option<String>
pub fn git_ref_str(&self) -> Option<String>
Get the git reference as an option string (for compatibility)
Trait Implementations§
Source§impl<'de> Deserialize<'de> for ModelRef
impl<'de> Deserialize<'de> for ModelRef
Source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
impl Eq for ModelRef
impl StructuralPartialEq for ModelRef
Auto Trait Implementations§
impl Freeze for ModelRef
impl RefUnwindSafe for ModelRef
impl Send for ModelRef
impl Sync for ModelRef
impl Unpin for ModelRef
impl UnsafeUnpin for ModelRef
impl UnwindSafe for ModelRef
Blanket Implementations§
§impl<T> AnySync for T
impl<T> AnySync for T
§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
§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
§impl<T> CallHasher for T
impl<T> CallHasher for T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key and return true if they are equal.§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
Source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
Source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key and return true if they are equal.§impl<T> FutureExt for T
impl<T> FutureExt for T
§fn with_context(self, otel_cx: Context) -> WithContext<Self>
fn with_context(self, otel_cx: Context) -> WithContext<Self>
§fn with_current_context(self) -> WithContext<Self>
fn with_current_context(self) -> WithContext<Self>
§impl<T> Identity for Twhere
T: ?Sized,
impl<T> Identity for Twhere
T: ?Sized,
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§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> IntoRequest<T> for T
impl<T> IntoRequest<T> for T
Source§fn into_request(self) -> Request<T>
fn into_request(self) -> Request<T>
T in a tonic::Request§impl<T> JaggedSlice<T> for T
impl<T> JaggedSlice<T> for T
§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> PolicyExt for Twhere
T: ?Sized,
Source§impl<T> Serialize for T
impl<T> Serialize for T
fn erased_serialize(&self, serializer: &mut dyn Serializer) -> Result<Ok, Error>
§impl<T> ServiceExt for T
impl<T> ServiceExt for T
§fn map_response_body<F>(self, f: F) -> MapResponseBody<Self, F>where
Self: Sized,
fn map_response_body<F>(self, f: F) -> MapResponseBody<Self, F>where
Self: Sized,
§fn trace_for_http(self) -> Trace<Self, SharedClassifier<ServerErrorsAsFailures>>where
Self: Sized,
fn trace_for_http(self) -> Trace<Self, SharedClassifier<ServerErrorsAsFailures>>where
Self: Sized,
§fn trace_for_grpc(self) -> Trace<Self, SharedClassifier<GrpcErrorsAsFailures>>where
Self: Sized,
fn trace_for_grpc(self) -> Trace<Self, SharedClassifier<GrpcErrorsAsFailures>>where
Self: Sized,
§fn follow_redirects(self) -> FollowRedirect<Self>where
Self: Sized,
fn follow_redirects(self) -> FollowRedirect<Self>where
Self: Sized,
§impl<T> ToCompactString for Twhere
T: Display,
impl<T> ToCompactString for Twhere
T: Display,
§fn try_to_compact_string(&self) -> Result<CompactString, ToCompactStringError>
fn try_to_compact_string(&self) -> Result<CompactString, ToCompactStringError>
ToCompactString::to_compact_string()] Read more§fn to_compact_string(&self) -> CompactString
fn to_compact_string(&self) -> CompactString
CompactString]. Read more