Struct SearchQuery 

pub struct SearchQuery {
    pub free_text: String,
    pub extensions: Vec<SearchExtension>,
}

Typed NIP-50 query: free text + zero or more extension tokens.

Fields

free_text: String

Whatever the relay’s search backend interprets as a natural language query. Whitespace is preserved as-is (the wire format does the same).

extensions: Vec<SearchExtension>

Spec-named or forward-compatible extension tokens, in the order they were inserted / parsed.

Implementations

impl SearchQuery

pub fn new(free_text: impl Into<String>) -> Self

Build a query with only free text.

pub fn with_extension(self, ext: SearchExtension) -> Self

Append one extension. Order is preserved on render.

pub fn render(&self) -> String

Render to the NIP-50 wire form. Extensions follow the free text, single-spaced.

pub fn parse(query: &str) -> Self

Parse a NIP-50 wire string into a typed query.

The parser is lenient: tokens that do not look like extensions flow into free_text, and unknown extension keys surface as SearchExtension::Other so a relay’s bespoke extension never lands in the free-text bucket by accident. The only token-level error is a malformed known extension (currently only nsfw:), which is silently dropped after emitting a tracing event so callers cannot lose the surrounding query.

Trait Implementations

impl Clone for SearchQuery

fn clone(&self) -> SearchQuery

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SearchQuery

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

Formats the value using the given formatter.

impl Default for SearchQuery

fn default() -> SearchQuery

Returns the “default value” for a type.

impl Eq for SearchQuery

impl PartialEq for SearchQuery

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