Implemented display_some and display_some_or

askama/src/filters/mod.rs

@@ -350,6 +350,11 @@ where
     }
 }
 
+/// See [`display_some` in the Askama book] for more information.
+///
+/// See also [`display_some_or`].
+///
+/// [`display_some` in the Askama book]: https://djc.github.io/askama/filters.html#display_some
 pub fn display_some<T>(value: &Option<T>) -> Result<DisplaySome<'_, T>>
 where
     T: fmt::Display,
@@ -373,6 +378,11 @@ where
     }
 }
 
+/// See [`display_some_or` in the Askama book] for more information.
+///
+/// See also [`display_some`].
+///
+/// [`display_some_or` in the Askama book]: https://djc.github.io/askama/filters.html#display_some_or
 pub fn display_some_or<'a, T, U>(
     value: &'a Option<T>,
     otherwise: U,

book/src/filters.md

@@ -24,6 +24,8 @@ Enable it with Cargo features (see below for more information).
   [`as_ref`][#as_ref],
   [`capitalize`][#capitalize],
   [`center`][#center],
+  [`display_some`][#display_some],
+  [`display_some_or`][#display_some_or],
   [`escape|e`][#escape],
   [`filesizeformat`][#filesizeformat],
   [`fmt`][#fmt],
@@ -108,6 +110,46 @@ Output:
 -  a  -
 ```
 
+### display_some
+
+[#display_some]: #display_some
+
+The `display_some` filter is essentially a shorthand for:
+
+```text
+{% if let Some(value) = value %}{{ value }}{% endif %}
+```
+
+It can be used like this:
+
+```text
+<title>{{ title|display_some }}</title>
+```
+
+Where `title` can be any `Option<T>` as long as `T` implements [`fmt::Display`].
+
+### display_some_or
+
+[#display_some_or]: #display_some_or
+
+The `display_some_or` filter is similar to `display_some`, but allows providing
+a default value to render for `None`. In short, instead of the following:
+
+```text
+{% if let Some(value) = value %}{{ value }}{% else %}My default title{% endif %}
+```
+
+Then `display_some_or` can be used like this:
+
+```text
+<title>{{ title|display_some_or("My default title") }}</title>
+```
+
+Where `title` can be any `Option<T>` as long as `T` implements [`fmt::Display`].
+While the `default` value can be any `U` implementing [`fmt::Display`].
+
+[`fmt::Display`]: https://doc.rust-lang.org/std/fmt/trait.Display.html
+
 ### escape | e
 [#escape]: #escape--e
 

book/src/template_syntax.md

@@ -464,6 +464,20 @@ mirror Rust's [`if let` expressions]:
 {% endif %}
 ```
 
+See also the [`display_some`] and [`display_some_or`] filters, which
+can be used to simplify _"render `Some` or nothing/default"_.
+
+```text
+<title>{{ title|display_some }}</title>
+
+<title>{{ title|display_some_or("My default title") }}</title>
+```
+
+_Assuming `title` is `Option<String>`._
+
+[`display_some`]: filters.html#display_some
+[`display_some_or`]: filters.html#display_some_or
+
 [`if let` expressions]: https://doc.rust-lang.org/reference/expressions/if-expr.html#if-let-expressions
 
 ### Match