Struct SourceCodeInfo 

#[non_exhaustive]
pub struct SourceCodeInfo {
    pub location: Vec<Location>,
    /* private fields */
}

Encapsulates information about the original source file from which a FileDescriptorProto was generated.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

location: Vec<Location>

A Location identifies a piece of source code in a .proto file which corresponds to a particular definition. This information is intended to be useful to IDEs, code indexers, documentation generators, and similar tools.

For example, say we have a file like: message Foo { optional string foo = 1; } Let’s look at just the field definition: optional string foo = 1; ^ ^^ ^^ ^ ^^^ a bc de f ghi We have the following locations: span path represents [a,i) [ 4, 0, 2, 0 ] The whole field definition. [a,b) [ 4, 0, 2, 0, 4 ] The label (optional). [c,d) [ 4, 0, 2, 0, 5 ] The type (string). [e,f) [ 4, 0, 2, 0, 1 ] The name (foo). [g,h) [ 4, 0, 2, 0, 3 ] The number (1).

Notes:

• A location may refer to a repeated field itself (i.e. not to any particular index within it). This is used whenever a set of elements are logically enclosed in a single code segment. For example, an entire extend block (possibly containing multiple extension definitions) will have an outer location whose path refers to the “extensions” repeated field without an index.
• Multiple locations may have the same path. This happens when a single logical declaration is spread out across multiple places. The most obvious example is the “extend” block again – there may be multiple extend blocks in the same scope, each of which will have the same path.
• A location’s span is not always a subset of its parent’s span. For example, the “extendee” of an extension declaration appears at the beginning of the “extend” block and is shared by all extensions within the block.
• Just because a location’s span is a subset of some other location’s span does not mean that it is a descendant. For example, a “group” defines both a type and a field in a single declaration. Thus, the locations corresponding to the type and field and their components will overlap.
• Code which tries to interpret locations should probably be designed to ignore those that it doesn’t understand, as more types of locations could be recorded in the future.

Implementations

impl SourceCodeInfo

pub fn new() -> Self

pub fn set_location<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<Location>,

Sets the value of location.

Example

use google_cloud_wkt::source_code_info::Location;
let x = SourceCodeInfo::new()
    .set_location([
        Location::default()/* use setters */,
        Location::default()/* use (different) setters */,
    ]);

Trait Implementations

impl Clone for SourceCodeInfo

fn clone(&self) -> SourceCodeInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SourceCodeInfo

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

Formats the value using the given formatter.

impl Default for SourceCodeInfo

fn default() -> SourceCodeInfo

Returns the “default value” for a type.

impl Message for SourceCodeInfo

fn typename() -> &'static str

The typename of this message.

impl PartialEq for SourceCodeInfo

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

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

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 StructuralPartialEq for SourceCodeInfo