Struct fluent_bundle::FluentResource

source ·
pub struct FluentResource(/* private fields */);
Expand description

A resource containing a list of localization messages.

FluentResource wraps an Abstract Syntax Tree produced by the parser and provides an access to a list of its entries.

A good mental model for a resource is a single FTL file, but in the future there’s nothing preventing a resource from being stored in a data base, pre-parsed format or in some other structured form.

§Example

use fluent_bundle::FluentResource;

let source = r#"

hello-world = Hello World!

"#;

let resource = FluentResource::try_new(source.to_string())
    .expect("Errors encountered while parsing a resource.");

assert_eq!(resource.entries().count(), 1);

§Ownership

A resource owns the source string and the AST contains references to the slices of the source.

Implementations§

source§

impl FluentResource

source

pub fn try_new(source: String) -> Result<Self, (Self, Vec<ParserError>)>

A fallible constructor of a new FluentResource.

It takes an encoded Fluent Translation List string, parses it and stores both, the input string and the AST view of it, for runtime use.

§Example
use fluent_bundle::FluentResource;

let source = r#"

hello-world = Hello, { $user }!

"#;

let resource = FluentResource::try_new(source.to_string());

assert!(resource.is_ok());
§Errors

The method will return the resource irrelevant of parse errors encountered during parsing of the source, but in case of errors, the Err variant will contain both the structure and a vector of errors.

source

pub fn source(&self) -> &str

Returns a reference to the source string that was used to construct the FluentResource.

§Example
use fluent_bundle::FluentResource;

let source = "hello-world = Hello, { $user }!";

let resource = FluentResource::try_new(source.to_string())
    .expect("Failed to parse FTL.");

assert_eq!(
    resource.source(),
    "hello-world = Hello, { $user }!"
);
source

pub fn entries(&self) -> impl Iterator<Item = &Entry<&str>>

Returns an iterator over entries of the FluentResource.

§Example
use fluent_bundle::FluentResource;
use fluent_syntax::ast;

let source = r#"

hello-world = Hello, { $user }!

"#;

let resource = FluentResource::try_new(source.to_string())
    .expect("Failed to parse FTL.");

assert_eq!(
    resource.entries().count(),
    1
);
assert!(matches!(resource.entries().next(), Some(ast::Entry::Message(_))));
source

pub fn get_entry(&self, idx: usize) -> Option<&Entry<&str>>

Returns an Entry at the given index out of the FluentResource.

§Example
use fluent_bundle::FluentResource;
use fluent_syntax::ast;

let source = r#"

hello-world = Hello, { $user }!

"#;

let resource = FluentResource::try_new(source.to_string())
    .expect("Failed to parse FTL.");

assert!(matches!(resource.get_entry(0), Some(ast::Entry::Message(_))));

Trait Implementations§

source§

impl Debug for FluentResource

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.