Struct Fragment 

pub struct Fragment(/* private fields */);

A cached piece of HTML, from fragment or fragments.

It was rendered by an askama template, which escaped its values, so templates write it as is: {{ row }} needs no |safe (it implements askama’s HtmlSafe with feature html). Display writes the HTML.

Examples

use std::time::Duration;

use askama::Template;
use ocre::{Ctx, Result, cache::{self, Fragment}};

#[derive(Template)]
#[template(source = "<li>{{ title }}</li>", ext = "html")]
struct Row<'a> {
    title: &'a str,
}

async fn row(ctx: &Ctx) -> Result<Fragment> {
    let key = cache::key(&[&"posts", &12, &"2026-09-29 14:05:00", &"v1"]);
    cache::fragment(ctx, &key, Duration::from_secs(86_400), || Row { title: "Hello" }).await
}

Implementations

impl Fragment

pub fn as_str(&self) -> &str

The HTML.

Examples

let row = row(ctx).await?;
assert!(row.as_str().starts_with('<'));

pub fn into_string(self) -> String

The HTML as a String, e.g. for a realtime broadcast.

Examples

let html: String = row(ctx).await?.into_string();

Trait Implementations

impl Clone for Fragment

fn clone(&self) -> Fragment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Fragment

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

Formats the value using the given formatter.

impl Display for Fragment

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

Formats the value using the given formatter.

impl Eq for Fragment

impl HtmlSafe for Fragment

Available on crate feature html only.

Fragments are HTML rendered (and escaped) by askama templates.

impl PartialEq for Fragment

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