Struct NapUri 

pub struct NapUri {
    pub universe: String,
    pub entity_type: EntityType,
    pub entity_id: String,
    pub fragment: Option<String>,
}

A parsed NAP URI representing a narrative resource identity.

Examples

use nap_core::uri::NapUri;

let uri: NapUri = "nap://starwars/character/lukeskywalker#references.appears_in"
    .parse()
    .unwrap();

assert_eq!(uri.universe, "starwars");
assert_eq!(uri.entity_type, nap_core::types::EntityType::Character);
assert_eq!(uri.entity_id, "lukeskywalker");
assert_eq!(uri.fragment.as_deref(), Some("references.appears_in"));

Fields

universe: String

The fictional universe (repository). e.g., "starwars", "toystory".

entity_type: EntityType

The kind of entity being addressed.

entity_id: String

The entity’s identifier (slug). e.g., "lukeskywalker", "tatooine".

fragment: Option<String>

Optional fragment for subtree queries. e.g., "appearances.audienceVotes". Populated from the # portion of the URI.

Implementations

impl NapUri

pub fn new( universe: impl Into<String>, entity_type: EntityType, entity_id: impl Into<String>, ) -> Self

Construct a new NAP URI without a fragment.

pub fn with_fragment( universe: impl Into<String>, entity_type: EntityType, entity_id: impl Into<String>, fragment: impl Into<String>, ) -> Self

Construct a NAP URI with a fragment query path.

pub fn identity(&self) -> String

Returns the canonical URI string WITHOUT the fragment. This is the resource identity — fragments are query concerns.

pub fn manifest_path(&self) -> String

Returns the relative filesystem path for this entity’s manifest within a universe repository.

e.g., "characters/lukeskywalker.yaml" or "universe.yaml" for world.

Trait Implementations

impl Clone for NapUri

fn clone(&self) -> NapUri

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NapUri

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NapUri

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for NapUri

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

Formats the value using the given formatter.

impl Eq for NapUri

impl FromStr for NapUri

type Err = NapError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for NapUri

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for NapUri

fn eq(&self, other: &NapUri) -> 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 Serialize for NapUri

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for NapUri