tera-1.20.0/.cargo_vcs_info.json 0000644 00000000136 00000000001 0012047 0 ustar {
"git": {
"sha1": "c05bff14ae74b3cd3970f64b87347949fe4150d4"
},
"path_in_vcs": ""
} tera-1.20.0/CHANGELOG.md 0000644 0000000 0000000 00000042351 10461020230 0012455 0 ustar 0000000 0000000 # Changelog
## 1.12.0 (unreleased)
- Support parenthesis in if statemetns
- Allow escaped newline and tab join separator
-
## 1.19.1 (2023-09-03)
- Minimum supported Rust version (MSRV) is now 1.63 due to transitive dependencies.
- Update crates.io metadata for the website
## 1.19.0 (2023-05-31)
- Revert change to glob path to not error if the path doesn't exist
- Allow macro definition in renderable template
## 1.18.1 (2023-03-15)
- Fix panic on invalid globs to Tera::new
## 1.18.0 (2023-03-08)
- Add `abs` filter
- Add `indent` filter
- Deprecate `get_json_pointer` in favour of `dotted_pointer`, a faster alternative
- Always canonicalize glob paths passed to Tera to workaround a globwalk bug
- Handle apostrophes in title case filter
- Some performance improvement
## 1.17.1 (2022-09-19)
- Make `get_random` use isize instead of i32 and bad error message
- Fix variables lookup when the evaluated key has a `.` or quotes
- Fix changed output of f64 from serde_json 1.0.85
## 1.17.0 (2022-08-14)
- Fix bug where operands in `in` operation were escaped before comparison
- Force chrono dep to be 0.4.20 minimum
- Better support for parenthesis in expression
## 1.16.0 (2022-06-10)
- Add a feature just for the urlencode builtin
- Fix bug in slice filter if start >= end
- Allow supplying a timezone to a timestamp for the date filter
## 1.15.0 (2021-11-03)
- Add `default` parameter to `get` filter
- `Tera::extend` now also copies over function
- Remove the new Context-local Tera function support, it was an accidental breaking change and will be added in v2 in some ways
instead
## 1.14.0 (2021-11-01) - YANKED as it added a generic to Context, a breaking change
- Ensure `Context` stays valid in Sync+Send, fixing an issue introduced in 1.13. 1.113 will be yanked.
## 1.13.0 (2021-10-17) - YANKED as it made Context not Send+Sync
- Add `default` parameter to `get` filter
- `Tera::extend` now also copies over function
- Add Context-local Tera functions
## 1.12.1 (2021-07-13)
- Remove unused feature of chrono
- Remove unwanted bloat in crate from accidental WASM files
## 1.12.0 (2021-06-29)
- Add `spaceless` filter from Django
## 1.11.0 (2021-06-14)
- Allow iterating on strings with `for`
## 1.10.0 (2021-05-21)
- Add `Tera::get_template_names`
## 1.9.0 (2021-05-16)
- Add `Context::remove`
## 1.8.0 (2021-04-21)
- Add `linebreaksbr` filter from Django
- Allow dots in context object key names
## 1.7.1 (2021-04-12)
- Fix parsing of filter arguments separated by whitespaces
## 1.7.0 (2021-03-07)
- Allow rendering to `std::io::Write`
- Follow symlinks in glob
- Allow including lists of templates
- Comment tags can now use whitespace control
## 1.6.1 (2020-12-29)
- Fix date filter sometimes panicking with some format input
## 1.6.0 (2020-12-19)
- Allow multiline function kwargs with trailing comma
- Add `Context::try_insert`
## 1.5.0 (2020-08-10)
- Add the concept of safe functions and filters
- Allow negative index on `slice` filter
## 1.4.0 (2020-07-24)
- Add `Context::get` and `Context::contains_key`
## 1.3.1 (2020-06-09)
- Fix `raw` tag swallowing all whitespace at beginning and end
- Make batch template sources generic
- Automatically add function/test/filter function name to their error message
## 1.3.0 (2020-05-16)
- Add a `urlencode_strict` filter
- Add more array literals feature in templates
- Make `filter` filter value argument optional
## 1.2.0 (2020-03-29)
- Add `trim_start`, `trim_end`, `trim_start_matches` and `trim_end_matches` filters
- Allow blocks in filter sections
## 1.1.0 (2020-03-08)
- Add Tera::render_str, like Tera::one_off but can use an existing Tera instance
## 1.0.2 (2020-01-13)
- Length filter now errors for things other than array, objects and strings. The fact that it was returning 0 before
for other types was something that should have been fixed before 1.0 but got forgotten and was considered a bug.
## 1.0.1 (2019-12-18)
- Fix filter sections not keeping whitespaces
- The filesizeformat filter now takes a usize instead of a i64: no changes to behaviour
## 1.0.0 (2019-12-07)
### Breaking changes
- Now requires Rust 1.34
- Removed error-chain errors and added rich Error enum instead
- Filter, Tester and Function are now traits and now take borrowed values instead of owned
- Updated for 2018 edition
- Require macros import to be at the top of the files along with `extends` as it is fairly cheap and
the code already only really look there.
- Enforce spacing in tags at the parser, before `ifsomething` was considered ok
- Pluralize filter now uses `singular` and `plural` arguments instead of `suffix`
- Add a test for checking whether a variable is an object
- Escaping now happens before inserting the final result of an expression: no need anymore to add `| safe` everywhere,
only at the last position
- Remove `safe` argument of the urlencode filter, `/` is still escaped by default
- The `compile_templates!` macro has been removed
### Others
- Tests can now use `value is not defined` order for negation (https://github.com/Keats/tera/issues/308)
- Add `nth` filter to get the nth value in an array
- You can now use glob patterns in `Tera::new`
- `default` filter now works on Null values
- Literal numbers in template overflowing i64/f64 will now be an error instead of panicking
- Allow arrays as test arguments
- Add the `in` operator to check if a left operand is contained in a right one. Also supports negation as `not in`
- Add `Context::from_value` to instantiate a `Context` from a serde_json `Value`
- Add `Context::from_serialize` to instantiate a `Context` from something that impl `Serialize`
- Make tests helper fns `number_args_allowed`, `value_defined` and `extract_string` public
- Add `else` clause to for loops
- Filters are now evaluated when checking if/elif conditions
- Allow `{{-` and `-}}` for whitespace management
- Add `xml_escape` filter
- Grave accent is no longer escaped in HTML, it is not really needed anymore
- Add a `builtins` default feature that gate all filters/functions requiring additional dependencies
- Add `unique` and `map` filter
- Add a `timezone` attribute to the `date` filter
- Add a `get_random` function to get a random number in a range
- Add a `get_env` function to get the value of an environment variable
## 0.11.20 (2018-11-14)
- Fix bugs in `filter` and `get` filters
## 0.11.19 (2018-10-31)
- Allow function calls in math expressions
- Allow string concatenation to start with a number
- Allow function calls in string concatenations
- Add a `concat` filter to concat arrays or push an element to an array
## 0.11.18 (2018-10-16)
- Allow concatenation of strings and numbers
## 0.11.17 (2018-10-09)
- Clear local context on each forloop iteration
- Fix variable lookup with `.` that was completely wrong
- Now requires Rust 1.26 because of some dependencies update
## 0.11.16 (2018-09-12)
- Fix `set`/`set_global` not working correctly in macros
- Deprecate `register_global_function` for `register_function`
## 0.11.15 (2018-09-09)
- Remove invalid `unreachable!` call causing panic in some combination or for loop and specific filters
- Fix macros loading in parent templates and using them in child ones
- Fix macros loading other macros not working when called in inheritance
- Mark `Context::add` as deprecated and do not display it in the docs anymore (aka TIL the `deprecated` attribute)
- Fix `__tera_context` not getting all the available context (`set`, `forloop` etc)
- Better error message when variable indexing fails
## 0.11.14 (2018-09-02)
- Remove stray println
## 0.11.13 (2018-09-02)
- Add `as_str` filter
- Way fewer allocations and significant speedup (2-5x) for templates with large objects/loops
- Checks that all macro files are accounted for at compile time and errors if it's not the case
## 0.11.12 (2018-08-04)
- `filter` filter was not properly registered (╯°□°)╯︵ ┻━┻
## 0.11.11 (2018-08-01)
- `truncate` filter now works correctly on multichar graphemes
## 0.11.10 (2018-08-01)
- Add a `throw` global function to fail rendering from inside a template
## 0.11.9 (2018-07-16)
- Add a `matching` tester
- Register `now` global function so it is available
- Update `error-chain`
## 0.11.8 (2018-06-20)
- Add `True` and `False` as boolean values to match Python
- Allow user to define their own escape function, if you want to generate JSON for example
- Add `end` argument to the `truncate` filter to override the default ellipsis
- Add a `group_by` filter
- Add a `filter` filter
- Add the `~` operator to concatenate strings
- Add a `now` global function to get local and UTC datetimes
- Add feature to enable the `preserve_order` feature of serde_json
- Less confusing behaviour with math arithmetics
## 0.11.7 (2018-04-24)
- Add array literal instantiation from inside Tera for set, set_global, kwargs
and for loop container
- Fix panic on truncate filter
## 0.11.6 (2018-03-25)
- Add `break` and `continue` to forloops
- Fix strings delimited by single quote and backtick not removing the delimiters
## 0.11.5 (2018-03-01)
- Re-export `serde_json::Number` as well
## 0.11.4 (2018-02-28)
- Re-export `serde_json::Map` as well
- You can now access inside a variable using index notation: `{{ arr[0] }}`, `{{ arr[idx] }}` etc
thanks to @bootandy
- Add `Context::insert` identical to `Context::add` to mirror Rust HashMap/BTreeMap syntax
## 0.11.3 (2018-02-15)
- Add a `slice` filter for arrays
- Fix macro files importing other macro files not loading properly
- Fix forloop container being allowed logic expressions
- Much improved parsing error messages
## 0.11.2 (2018-02-01)
- Fix regression when including templates that import macros
- Fix `pluralize` filter for real this time!
## 0.11.1 (2018-01-25)
- Fix regression with expressions in comparisons
## 0.11.0 (2018-01-22)
### Breaking changes
- Tests parentheses are now mandatory if there are arguments (`divisibleby 2` -> `divisibleby(2)`)
- Tests can be only used on variables now, not on expressions
- Escaping happens immediately now instead of waiting for the filters to be called, unless `safe` is first.
If you want the old behaviour you will need to start the a chain of filters with `| safe` as the first one
### Others
- Tests, global functions calls and macro calls are now expressions and can be combined like so: `if x is divisibleby(2) and x > 10`
- Add default arguments for macro arguments
- Add whitespace management similar to Liquid and Jinja2
- Add parentheses to expressions to remove ambiguities
- Block & macro end tag name are no longer mandatory and it doesn't error on mismatched names between
the start and end tag anymore
- Filters can now be applied to expressions
- Add modulo operator `%` for math expressions
- Allow comment tags before the extend tag
- Make `NaiveDateTime` work with the `date` filter
- `pluralize` filter now returns the plural suffix for 0 thing as it's apparently what English does
- Add a `set_global` tag that allows you to set something in the global context: meant to be used in forloops where
the normal `set` would put the value into the loop context
- Add `starting_with`, `ending_with` and `containing` tests
- Add `json_encode`, `default` and `sort` filters
- Strings can now also be contained in backticks and single quotes in templates
## 0.10.10 (2017-08-24)
- Add `Tera::parse` for some niche use-cases
## 0.10.9 (2017-08-02)
- Handle path to templates starting with "./"
- Fix loop and macro context overlaps
- Fix variables being escaped when given to `set` or as arguments to filters/macros/global fns
## 0.10.8 (2017-06-24)
- Update chrono
## 0.10.7 (2017-06-16)
- Fix not being able to use variables starting with `or`, `and` and `not`
- Fix `<=` and `>=` not being recognised properly
- Fix if/elif conditions falling through: only the first valid one will be rendered
- Handle NaN results in `{% set %}` instead of panicking
- Allow math node on if/elif conditions & fix f64 truthiness
## 0.10.6 (2017-05-23)
- Fix not being able to call global functions without arguments
- Fix multiple inheritance not rendering blocks as expected for nested blocks
- Allow filters on key/value for loop containers
## 0.10.5 (2017-05-13)
- Fix bug with `{% set %}` in forloops
## 0.10.4 (2017-05-09)
- Add `Send` to `GlobalFn` return type
## 0.10.3 (2017-05-09)
- Add global functions, see README
- Add set tag, see README
- Add get filter
## 0.10.2 (2017-05-03)
- Fix bug with section filter swallowing all content after the end tag
- Allow whitespace in function args
## 0.10.1 (2017-04-25)
- Fix bug with variable in loop using starting with the container name (#165)
- Allow whitespace in macros/filters params
## 0.10.0 (2017-04-21)
### Breaking changes
- Update Serde to 1.0.0
### Others
- Fix date filter converting everything to UTC
- Fix panic when using filters on forloop container
## 0.9.0 (2017-04-05)
### Breaking changes
- Fix bug in Windows where the glob path was not removed correctly
### Others
- `Tera::extend` now also copy filters and testers
## 0.8.1 (2017-03-15)
- Macro rendering perf improved and general code cleanup thanks to @Peternator7
- Fix bug in parser with floats
- Make `date` filter work with string input in `YYYY-MM-DD` format
- Big parsing improvement (~20-40%) for projects with macros and inheritance
- Add `Tera::extend` to extend another instance of Tera
- Add `Tera::full_reload` that will re-run the glob and parse all templates found.
- Make `Tera::add_raw_template{s}` and `Tera::add_template_file{s}` part of the public API
- Fix location in error message when erroring in a child template
## 0.8.0 (2017-03-03)
### Breaking changes
- Remove `value_render` and `value_one_off`, you can now use `render` and `one_off`
for both values and context
### Others
- Speed improvements on both parsing and rendering (~20-40% faster)
- Better error message on variable lookup failure in loops
- Can now iterate on maps/struct using the `{% for key, val in my_object %}` construct
## 0.7.2 (2017-02-18)
- Update chrono version
- Make variable block like `{{ "hey" }}` render correctly
## 0.7.1 (2017-02-05)
- Support filter sections
- Fix path prefix trimming on Windows
## 0.7.0 (2017-02-01)
### Breaking changes
- `Tera::add_template` -> `Tera::add_raw_template`
- `Tera::add_templates` -> `Tera::add_raw_templates`
### Others
- Performance improvement thanks to @clarcharr
- Better error message for `value_render`. Thanks to @SilverWingedSeraph for the report
- Hide `add_raw_template` and `add_raw_templates` from docs, they were meant for internal use
- Exported macros now use the `$crate` variable, which means you don't need to import anything from Tera to have
them working
- Expose AST (not covered by semver)
- Add a `Context::extend` method to merge a context object into another one
## 0.6.2 (2017-01-08)
- Performance improvements thanks to @wdv4758h
- Correctly register `date` filter and make it work on a RFC3339 string as well thanks to @philwhineray
## 0.6.1 (2016-12-28)
- Added `Tera::value_one_off` to parse and render a single template using a
Json value as context
## 0.6.0 (2016-12-26)
### BREAKING CHANGES
- `not` is now a Tera keyword
### Others
- Added `#![deny(missing_docs)]` to the crate
- Added `Tera::one_off` to parse and render a single template
- Added `not` operator in conditions to mean falsiness (equivalent to `!` in Rust)
- Remove specific error message when using `||` or `&&`
- Improved performances for parsing and rendering (~5-20%)
- Added `precision` arg to `round` filter
- Added `date` filter to format a timestamp to a date(time) string
## 0.5.0 (2016-12-19)
A few breaking changes in this one
### BREAKING CHANGES
- Tera no longer panics when parsing templates, it returns an error instead
- Tester fn signature changes from `fn(&str, Option just a small \n example link to a webpage See: 'é is an apostrophe followed by e acute b
{% for user in users %}
```
It does not aim to be 100% compatible with them but has many of the Jinja2/Django filters and testers.
## Documentation
API documentation is available on [docs.rs](https://docs.rs/crate/tera/).
Tera documentation is available on its [site](http://keats.github.io/tera/docs).
## SemVer
This project follows SemVer only for the public API, public API here meaning functions appearing in the docs.
Some features, like accessing the AST, are also available but breaking changes in them can happen in any versions.
tera-1.20.0/src/builtins/filters/array.rs 0000644 0000000 0000000 00000065103 10461020230 0016420 0 ustar 0000000 0000000 /// Filters operating on array
use std::collections::HashMap;
use crate::context::{dotted_pointer, ValueRender};
use crate::errors::{Error, Result};
use crate::filter_utils::{get_sort_strategy_for_type, get_unique_strategy_for_type};
use crate::utils::render_to_string;
use serde_json::value::{to_value, Map, Value};
/// Returns the nth value of an array
/// If the array is empty, returns empty string
pub fn nth(value: &Value, args: &HashMap
`).
///
/// Example: The input "Hello\nWorld" turns into "Hello
World".
pub fn linebreaksbr(value: &Value, _: &HashMap
").replace('\n', "
")).unwrap())
}
/// Indents a string by the specified width.
///
/// # Arguments
///
/// * `value` - The string to indent.
/// * `args` - A set of key/value arguments that can take the following
/// keys.
/// * `prefix` - The prefix used for indentation. The default value is 4 spaces.
/// * `first` - True indents the first line. The default is false.
/// * `blank` - True indents blank lines. The default is false.
///
pub fn indent(value: &Value, args: &HashMap
").unwrap());
let result = replace(&to_value("Animal Alphabets\nB is for Bee-Eater").unwrap(), &args);
assert!(result.is_ok());
assert_eq!(result.unwrap(), to_value("Animal Alphabets
B is for Bee-Eater").unwrap());
}
#[test]
fn test_replace_missing_arg() {
let mut args = HashMap::new();
args.insert("from".to_string(), to_value("Hello").unwrap());
let result = replace(&to_value("Hello world!").unwrap(), &args);
assert!(result.is_err());
assert_eq!(
result.err().unwrap().to_string(),
"Filter `replace` expected an arg called `to`"
);
}
#[test]
fn test_capitalize() {
let tests = vec![("CAPITAL IZE", "Capital ize"), ("capital ize", "Capital ize")];
for (input, expected) in tests {
let result = capitalize(&to_value(input).unwrap(), &HashMap::new());
assert!(result.is_ok());
assert_eq!(result.unwrap(), to_value(expected).unwrap());
}
}
#[test]
fn test_addslashes() {
let tests = vec![
(r#"I'm so happy"#, r#"I\'m so happy"#),
(r#"Let "me" help you"#, r#"Let \"me\" help you"#),
(r#"'"#, r#"\'"#),
(
r#""double quotes" and \'single quotes\'"#,
r#"\"double quotes\" and \\\'single quotes\\\'"#,
),
(r#"\ : backslashes too"#, r#"\\ : backslashes too"#),
];
for (input, expected) in tests {
let result = addslashes(&to_value(input).unwrap(), &HashMap::new());
assert!(result.is_ok());
assert_eq!(result.unwrap(), to_value(expected).unwrap());
}
}
#[cfg(feature = "builtins")]
#[test]
fn test_slugify() {
// slug crate already has tests for general slugification so we just
// check our function works
let tests =
vec![(r#"Hello world"#, r#"hello-world"#), (r#"Hello 世界"#, r#"hello-shi-jie"#)];
for (input, expected) in tests {
let result = slugify(&to_value(input).unwrap(), &HashMap::new());
assert!(result.is_ok());
assert_eq!(result.unwrap(), to_value(expected).unwrap());
}
}
#[cfg(feature = "urlencode")]
#[test]
fn test_urlencode() {
let tests = vec![
(
r#"https://www.example.org/foo?a=b&c=d"#,
r#"https%3A//www.example.org/foo%3Fa%3Db%26c%3Dd"#,
),
(
r#"https://www.example.org/apples-&-oranges/"#,
r#"https%3A//www.example.org/apples-%26-oranges/"#,
),
(r#"https://www.example.org/"#, r#"https%3A//www.example.org/"#),
(r#"/test&"/me?/"#, r#"/test%26%22/me%3F/"#),
(r#"escape/slash"#, r#"escape/slash"#),
];
for (input, expected) in tests {
let args = HashMap::new();
let result = urlencode(&to_value(input).unwrap(), &args);
assert!(result.is_ok());
assert_eq!(result.unwrap(), to_value(expected).unwrap());
}
}
#[cfg(feature = "urlencode")]
#[test]
fn test_urlencode_strict() {
let tests = vec![
(
r#"https://www.example.org/foo?a=b&c=d"#,
r#"https%3A%2F%2Fwww%2Eexample%2Eorg%2Ffoo%3Fa%3Db%26c%3Dd"#,
),
(
r#"https://www.example.org/apples-&-oranges/"#,
r#"https%3A%2F%2Fwww%2Eexample%2Eorg%2Fapples%2D%26%2Doranges%2F"#,
),
(r#"https://www.example.org/"#, r#"https%3A%2F%2Fwww%2Eexample%2Eorg%2F"#),
(r#"/test&"/me?/"#, r#"%2Ftest%26%22%2Fme%3F%2F"#),
(r#"escape/slash"#, r#"escape%2Fslash"#),
];
for (input, expected) in tests {
let args = HashMap::new();
let result = urlencode_strict(&to_value(input).unwrap(), &args);
assert!(result.is_ok());
assert_eq!(result.unwrap(), to_value(expected).unwrap());
}
}
#[test]
fn test_title() {
let tests = vec![
("foo bar", "Foo Bar"),
("foo\tbar", "Foo\tBar"),
("foo bar", "Foo Bar"),
("f bar f", "F Bar F"),
("foo-bar", "Foo-Bar"),
("FOO\tBAR", "Foo\tBar"),
("foo (bar)", "Foo (Bar)"),
("foo (bar) ", "Foo (Bar) "),
("foo {bar}", "Foo {Bar}"),
("foo [bar]", "Foo [Bar]"),
("foo
\ntest\r\n
", ""), ("", ""), ("", ""), ("