Struct FilePattern 

pub struct FilePattern { /* private fields */ }

A file_patterns entry: either an optional directory part followed by a final segment of the form *.EXT, or the bare name of an extensionless file written as NAME or **/NAME.

The extension or name is the only part mcpls reads, so the directory part of an extension pattern (such as **/) is kept for display and ignored for routing. A name pattern admits no directory part other than **/, so it never claims every file of that name below one directory. Every other form (brace expansion, character classes, ?, dotted names, dotfiles, single files below a directory) has nothing to map and is rejected rather than dropped silently. Self::parse is the only constructor, so the config validator and the language-map builder cannot disagree on what is supported.

Examples

use std::assert_matches;

use mcpls_core::config::{FilePattern, PatternTarget};

let pattern = FilePattern::parse("**/*.rs").unwrap();
assert_matches!(pattern.target(), PatternTarget::Extension(e) if e == "rs");
assert_eq!(pattern.as_str(), "**/*.rs");

let makefile = FilePattern::parse("**/Makefile").unwrap();
assert_matches!(makefile.target(), PatternTarget::Name(n) if n == "Makefile");

assert!(FilePattern::parse("**/*.{cpp,h}").is_err());
assert!(FilePattern::parse("src/main.rs").is_err());
assert!(FilePattern::parse("docs/Makefile").is_err());
assert!(FilePattern::parse("/Makefile").is_err());

Implementations

impl FilePattern

pub fn parse(pattern: &str) -> Result<Self, UnsupportedFilePattern>

Parses pattern.

Errors

Returns UnsupportedFilePattern if the final path segment (after the last /) is neither *.EXT with a valid FileExtension nor a valid FileName reached through no directory part but **/.

pub fn from_static(pattern: &'static str) -> Self

Parses a literal known to be supported, such as a built-in default.

Panics

Panics if pattern is not a supported form.

pub fn as_str(&self) -> &str

The pattern text as configured.

pub const fn target(&self) -> &PatternTarget

The extension or file name this pattern maps.

Trait Implementations

impl Clone for FilePattern

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FilePattern

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

Formats the value using the given formatter.

impl Display for FilePattern

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

Formats the value using the given formatter.

impl Eq for FilePattern

impl From<FilePattern> for String

fn from(pattern: FilePattern) -> Self

Converts to this type from the input type.

impl Hash for FilePattern

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 FilePattern

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<&str> for FilePattern

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<str> for FilePattern

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for FilePattern

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 FilePattern