Add |titlecase as alias for |title

Author: Kijewski

askama/src/filters/alloc.rs

@@ -820,6 +820,31 @@ fn flush_title(dest: &mut (impl fmt::Write + ?Sized), s: &str) -> fmt::Result {
     Ok(())
 }
 
+/// Return a title cased version of the value. Alias for the [`|title`](title) filter.
+///
+/// ```
+/// # #[cfg(feature = "code-in-doc")] {
+/// # use askama::Template;
+/// /// ```jinja
+/// /// <div>{{ example|titlecase }}</div>
+/// /// ```
+/// #[derive(Template)]
+/// #[template(ext = "html", in_doc = true)]
+/// struct Example<'a> {
+///     example: &'a str,
+/// }
+///
+/// assert_eq!(
+///     Example { example: "hello WORLD" }.to_string(),
+///     "<div>Hello World</div>"
+/// );
+/// # }
+/// ```
+#[inline]
+pub fn titlecase<S: fmt::Display>(source: S) -> Result<Title<S>, Infallible> {
+    title(source)
+}
+
 /// A prefix usable for indenting [prettified JSON data](super::json::json_pretty) and
 /// [`|indent`](indent)
 ///

askama/src/filters/mod.rs

@@ -25,7 +25,7 @@ mod urlencode;
 #[cfg(feature = "alloc")]
 pub use self::alloc::{
     AsIndent, capitalize, fmt, format, indent, linebreaks, linebreaksbr, lower, lowercase,
-    paragraphbreaks, title, trim, upper, uppercase, wordcount,
+    paragraphbreaks, title, titlecase, trim, upper, uppercase, wordcount,
 };
 pub use self::builtin::{PluralizeCount, center, join, pluralize, truncate};
 pub use self::escape::{

askama_derive/src/generator/filter.rs

@@ -918,6 +918,7 @@ const BUILTIN_FILTERS_ALLOC: &[&str] = &[
     "lower",
     "lowercase",
     "title",
+    "titlecase",
     "trim",
     "upper",
     "uppercase",

book/src/filters.md

@@ -488,8 +488,8 @@ Output:
 <p>I'm Safe</p>
 ```
 
-### title
-[#title]: #title
+### title | titlecase
+[#title]: #title--titlecase
 
 <blockquote class="right" style="padding:0.5ex 1ex; margin:0 0 1ex 1ex; font-size:80%">
 enabled by <code>"alloc"</code><br/>
@@ -498,6 +498,7 @@ enabled by <code>"default"</code>
 
 ```jinja
 {{ text_to_convert | title }}
+{{ text_to_convert | titlecase }}
 ```
 
 <hr style="clear:both; border:0; border-bottom:1pt solid currentColor">