cursor-api/patch/prost-0.14.1/src/name.rs

//! Support for associating type name information with a [`Message`].

use crate::Message;

#[cfg(not(feature = "std"))]
use alloc::{format, string::String};

/// Associate a type name with a [`Message`] type.
pub trait Name: Message {
    /// Simple name for this [`Message`].
    /// This name is the same as it appears in the source .proto file, e.g. `FooBar`.
    const NAME: &'static str;

    /// Package name this message type is contained in. They are domain-like
    /// and delimited by `.`, e.g. `google.protobuf`.
    const PACKAGE: &'static str;

    /// Fully-qualified unique name for this [`Message`].
    /// It's prefixed with the package name and names of any parent messages,
    /// e.g. `google.rpc.BadRequest.FieldViolation`.
    /// By default, this is the package name followed by the message name.
    /// Fully-qualified names must be unique within a domain of Type URLs.
    fn full_name() -> String {
        format!("{}.{}", Self::PACKAGE, Self::NAME)
    }

    /// Type URL for this [`Message`], which by default is the full name with a
    /// leading slash, but may also include a leading domain name, e.g.
    /// `type.googleapis.com/google.profile.Person`.
    /// This can be used when serializing into the `google.protobuf.Any` type.
    fn type_url() -> String {
        format!("/{}", Self::full_name())
    }
}