evalexpr

chore: Release evalexpr version 13.1.0

Added

• Parse integers prefixed with 0b as binary and 0o as octal (#194)

Contributors

My warmhearted thanks goes to:

• Valentine Briese

chore: Release evalexpr version 13.0.0

Added

• Function remove_value to HashMapContext (#189)

Contributors

My warmhearted thanks goes to:

• Sudo Dios

Fixed

• Add serde support to DefaultNumericTypes (#185)

Contributors

My warmhearted thanks goes to:

• Gary Pennington

Fixed

• Link to ron format in documentation (#177)
• Use the correct Value construction functions in documentation (#178)
• Add hint about new licensing also to notes for contributors.
• Fixed copy-paste error with the Comments section in documentation.

Contributors

My warmhearted thanks goes to:

• Ryan Butler

Fixed

• Fixed the math_consts_context! macro that was broken by in 12.0.0 (#173)

Contributors

My warmhearted thanks goes to:

• jeffrey182

Changed

• evalexpr is now licensed under the GNU Affero General Public License Version 3
• Made the int and float types generic.

Fixed

• str::from does not add double quotes around strings anymore, except if those are inside a tuple (#169)

Contributors

My warmhearted thanks goes to:

• VianneyRousset

Added

• Builtin function str::substring (#158)

Changed

• The error type WrongFunctionArgumentAmount now expects a range of argument amounts instead of a single one (#159)

Fixed

• Minor error in README.
• Regex functions do not silently ignore superfluous arguments anymore.

Contributors

My warmhearted thanks goes to:

• Ophir LOJKINE

Added

• Functions clear, clear_variables and clear_functions to HashMapContext (#156)

Contributors

My warmhearted thanks goes to:

• Cake Tully

Added

• C-style comments (#148)

Contributors

My warmhearted thanks goes to:

• Alex Wei

Notes

This should have been a minor release instead of a patch.

Added

• Methods to mutably iterate over operators (Node::iter_operators_mut) and all types of identifiers (Node::iter_identifiers_mut, Node::iter_*_identifiers_mut) (#136)

Contributors

My warmhearted thanks goes to:

• Ben Weinstein-Raun

Notes

• Due to the introduction of GATs, the MSRV changes to 1.65.0 in this update.

Added

• Builtin function math::abs (#130)
• A CLI for evaluating expressions. Install via cargo install evalexpr. (#133)
• The ability to parse integers from hex literals (#131)

Changed

• The IterVariablesContext from using a lifetime parameter to GATs (#135)

Contributors

My warmhearted thanks goes to:

• Heki
• Kaspar Schleiser

Added

• Builtin functions can now be disabled (#129)

Contributors

My warmhearted thanks goes to:

• hexofyore

Added

• Builtin functions contains and contains_any (#127)

Contributors

My warmhearted thanks goes to:

• nickisyourfan

Fixed

• Taking numbers to negative powers gave unexpected results (#120)
• Update MSRV to 1.56.1 (2021 edition release) to allow builds with the latest versions of all dependencies.

Contributors

My warmhearted thanks goes to:

• Pham Nhat Huy

Added

• EvalExprError now derives Clone (#116)

Changed

• Occurrences of f64 and i64 have been replaced with the type aliases FloatType and IntType where applicable (#113)

Contributors

My warmhearted thanks goes to:

• Natan Freeman
• Claus Matzinger

Added

• Get all variables or variable/value pairs in a context via a new trait IterateVariablesContext (#108)
• Functions iter_(read/write)_variable_identifiers, which iterate over all ReadVariableIdentifiers or all WriteVariableIdentifiers in an operator tree (#110)

Contributors

My warmhearted thanks goes to:

• egel557
• Tobias Schmitt

Added

• Builtin functions to check for nan, infinity and subnormality in floats (#101)
• Builtin random function (#102)
• Implement TryFrom<Value> for all types a value can hold (#105)
• Split VariableIdentifier node into read and write variants (#106)

Contributors

My warmhearted thanks goes to:

• Ophir LOJKINE
• Joe Grund
• Luka Maljic

Added

• The builtin function if, which mimics the if-else construct existing in many programming languages.

Contributors

My warmhearted thanks goes to:

• Ophir LOJKINE

Fixed

• Set regex minimum version to 1.5.5, as the previous versions contains a security vulnerability. See https://groups.google.com/g/rustlang-security-announcements/c/NcNNL1Jq7Yw?pli=1. This vulnerability does not affect this crate as of now, but if we ever allow passing parameters to the regex engine, it might.

Added

• Bit shift functions shl and shr, same as Rust's shift functions on i64.

Contributors

My warmhearted thanks goes to

• Diane Sparks

Changed

• Updated the optional dependencies, and fixed them to a minimum tested version. For simplicity, I fixed them to the newest version, but since I export none of them, this is luckily not breaking.
• Updated the dev-dependencies.

Changed

• Made the EvalexprError enum non_exhaustive.

Fixed

• Expressions that have dangling parenthese expressions such as 4(5) now produce an error.

Contributors

My warmhearted thanks goes to

• dbr/Ben

Added

• Bitwise operators as builtin functions bitand, bitor, bitxor, bitnot (#88)
• Public immutable and mutable accessor functions to the operator and children of a Node.

Contributors

My warmhearted thanks goes to

• Michał Hanusek
• Kai Giebeler

Added

• Make Function::new able to accept closures (thanks to Jakub Dąbek)

Contributors

My warmhearted thanks goes to

• Jakub Dąbek
• LonnonjamesD

Notes

• Minimum supported Rust version (MSRV) increased to 1.46.0
• Increased test coverage by adding more test and ignoring untestable files

Added

• Allow scientific notation in float literals

Changed

• Made some functions const. This increased the MSRV

Fixed

• eval_number methods returned EvalexprError::ExpectedFloat before, now they correctly return EvalexprError::ExpectedNumber

Contributors

My warmhearted thanks goes to

• Dennis Marttinen

Added

• Implement more builtin math methods

Contributors

My warmhearted thanks goes to

• Magnus Ulimoen

Notes

• Increased test coverage

Added

• Implemented Clone for HashMapContext

Contributors

My warmhearted thanks goes to

• Magnus Ulimoen

Fixed

• Improved syntax of documentation

Added

• Macro math_consts_context adding all of Rust's f64 constants
• All common math functions implemented by Rust's f64 are now builtin
• Continuous integration and test coverage report

Contributors

My warmhearted thanks goes to

• Edwin

Added

• #![forbid(unsafe_code)]
• Made Function derive Clone
• Ensure that Function implements Send and Sync

Removed

• Cargo.lock

Changed

• Decomposed Context into Context, ContextWithMutableVariables and ContextWithMutableFunctions
• Replaced the get_function method of Context with a call_function method

Contributors

My warmhearted thanks goes to

• dvtomas

Added

• Make Node cloneable

Contributors

My warmhearted thanks goes to

• dvtomas

Fixed

• is-it-maintained badges had wrong repository definitions
• maintenance status was given wrongly
• move maintenance status to top

Added

• maintenance badge
• is-it-maintained badges

Fixed

• The != operator was wrongfully parsed as Token::Eq

Contributors

• slientgoat

Changed

• Removed target.bench.dev-dependencies completely, as they can be just listed under the normal dev-dependencies

Fixed

• Bench dependencies are now dev-dependencies so they are not listed on crates.io as normal dependencies anymore

Notes

Finally, 'Sanity' has been released, including a huge bunch of new features. Notably, and providing a reason for the name of this release, function call and tuple semantics have improved a lot. Functions now always take exactly one argument, but this can then be a tuple. It is now possible to construct tuples of tuples, such that mode complex values can be constructed. As of now there is no way to deconstruct them though.

A lot has been done on string processing, special thanks for that goes to bittrance. Specifically, under the feature flag regex_support two regex functions for strings are hiding now. Also, the operators + and comparison operators have been fitted to support strings.

Thanks to lovasoa, we now have a nice macro for context creation.

Thanks to Atul9, the crate is now Rust 2018 compliant.

Thanks to mestachs' request, we now have functions to iterate over identifiers within an expression.

Internally, the structure of the operator tree changed from being &dyn-based to being enum-based. Also, we have benchmarks now to observe performance changes in future releases.

Added

• Iterator over all identifiers within an expression, including duplicates
• Iterators over only variable or only function identifiers within an expression, including duplicates
• Overload the + operator to concatenate strings
• Overload <, <=, > and >= for strings using lexical ordering (Note: == and != compare strings as expected)
• Add len, str::regex_matches, str::regex_replace, str::to_lowercase, str::to_uppercase, str::trim functions for strings
• Add a macro for more convenient definition of contexts including the direct definition of static contexts
• Add API for value decomposition
• Allow using context operations in eval calls without context
• Operator assignment operators for each binary operation (+=, -=, ...)
• The Operator enum is now public for better error types
• Benchmarks for observing performance of future releases

Removed

• Function arguments are not decomposed anymore. The function implementation will receive exactly one argument now. This allows the function to be called on a tuple properly.

Changed

• Operators are an enum now instead of trait objects
• Update to Rust 2018
• Updated dependencies

Fixed

• Allow variable assignments in eval calls without context. A HashMapContext is created automatically now.
• The error string for ExpectedNumber was wrong
• Operators panicked when adding a number to a string
• Some documentation was not updated for the 4.x releases

Contributors

My warmhearted thanks goes to

• bittrance
• lovasoa
• Atul9
• mestachs

Added

• Export expect_function_argument_amount

Added

• String constants

Added

• Add serde support to HashMapContext
• Make HashMapContext derive Default and Debug

Changed

• Changed name of serde feature flag to serde_support

Notes

The 3.0.0 update transforms the expression evaluator evalexpr to a tiny scripting language. It allows assignments and chaining of expressions. Some changes in this update are breaking, hence the major release.

Added

• Methods Node::eval_<type>_with_context_mut and crate level eval_<type>_with_context_mut
• Empty type and corresponding shortcut methods. The empty type is emitted by empty expressions or empty subexpressions ().
• The assignment operator =
• The expression chaining operator ;

Removed

• Generic arguments from Context traits are now static to allow using trait objects of Context
• EvalexprError::EmptyExpression is not required anymore since empty expressions now evaluate to the empty type

Changed

• Merge ContextMut trait into Context trait

Notes

The 2.0.0 update is the first step to transform evalexpr to a tiny scripting language with support of at least variable assignment. The main change for now is that Configuration is called Context, which seems to be a more proper naming for a set of variables that can not only be read, but also manipulated via expressions. This update includes further renamings and some inconsistencies in the API were fixed. For more details, see the following subsections.

Added

• Add the ContextMut trait, that is a manipulable configuration/context
• Add ContextNotManipulable error variant for the EmptyContext
• Make the TupleType alias public
• Add the ValueType enum that represents the type of a value for easier comparisons and matchings
• Add EvalexprResult<T> type that uses the EvalexprError type (renamed from Error)
• Add Node::eval_number and Node::eval_number_with_context to evaluate to int or float and silently converting to float
• Add eval_number and eval_number_with_context crate methods to evaluate to int or float and silently converting to float

Changed

• Get rid of some unwraps to improve safety
• Rename Error to EvalexprError
• Rename Configuration to Context
• Rename HashMapConfiguration to HashMapContext and EmptyConfiguration to EmptyContext
• Rename Value::as_float to Value::as_number and add new Value::as_float that fails if value is an integer

Added

• Add serde feature
• Implement serde::de::Deserialize for Node
• Document serde usage
• Add custom error type with a String message

Changed

• Highlighting in documentation

Added

• Internal aliases IntType and FloatType used by the Value enum are now public
• Type alias TupleType used to represent tuples was added
• Error types like Error::ExpectedInt for expecting each value type were added
• Shortcut functions like eval_int or eval_int_with_configuration to evaluate directly into a value type were added
• Documentation for the shortcut functions was added
• Functions to decompose Values were added and documented

Removed

• Integration tests were removed from shipped crate

Fixed

• Wording of some documentation items was changed to improve readability