From 4e88fa97307a49bf21e6edcec54c6695c45bcb1e Mon Sep 17 00:00:00 2001 From: Udo Klimaschewski Date: Wed, 12 Oct 2022 12:41:16 +0200 Subject: [PATCH] prepare release 3.0.1 (#332) --- README.md | 32 ++++++++++++++++++++++++ docs/.gitignore | 7 ++++++ docs/README.md | 9 +++++++ docs/_config.yml | 6 ++--- docs/concepts/changes.md | 2 +- docs/index.md | 48 +++++++++++++++++++++++++++++++++++- docs/references/operators.md | 4 +-- pom.xml | 4 +-- 8 files changed, 103 insertions(+), 9 deletions(-) create mode 100644 docs/.gitignore diff --git a/README.md b/README.md index 575fc79a..7b517ea0 100644 --- a/README.md +++ b/README.md @@ -49,6 +49,30 @@ You can download the binaries, source code and JavaDoc jars from You will find there also copy/paste templates for including EvalEx in your project with build systems like Maven or Gradle. +### Maven + +To include it in your Maven project, add the dependency to your pom. For example: + +```xml + + + com.ezylang + EvalEx + 3.0.1 + + +``` + +### Gradle + +If you're using gradle add the dependencies to your project's app build.gradle: + +```gradle +dependencies { + compile 'com.ezylang:EvalEx:3.0.1' +} +``` + ## Examples ### A simple example, that shows how it works in general: @@ -140,6 +164,14 @@ BigDecimal result = expression.evaluate().getNumberValue(); System.out.println(result); // prints 44.85 ``` +## EvalEx-big-math + +[Big-math](https://github.com/eobermuhlner/big-math) is a library by Eric Obermühlner. It provides +advanced Java BigDecimal math functions using an arbitrary precision. + +[EvalEx-big-math](https://github.com/ezylang/EvalEx-big-math) adds the advanced math functions from +big-math to EvalEx. + ## Author and License Copyright 2012-2022 by Udo Klimaschewski diff --git a/docs/.gitignore b/docs/.gitignore new file mode 100644 index 00000000..1321e07b --- /dev/null +++ b/docs/.gitignore @@ -0,0 +1,7 @@ +_site +.sass-cache +.jekyll-cache +.jekyll-metadata +vendor +Gemfile +Gemfile.lock diff --git a/docs/README.md b/docs/README.md index 57ea0bd9..f4b232d8 100644 --- a/docs/README.md +++ b/docs/README.md @@ -17,3 +17,12 @@ https://ezylang.github.io/EvalEx/ ## Using _JustTheDocs_ template: https://just-the-docs.github.io/just-the-docs/ + +## Install Jekyll locally (for testing the site locally) + +https://jekyllrb.com/docs/installation/ + +## Testing locally + +https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll + diff --git a/docs/_config.yml b/docs/_config.yml index 95c39154..b5052d5d 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -2,9 +2,9 @@ remote_theme: just-the-docs/just-the-docs title: EvalEx Documentation aux_links: "View on GitHub": - - "//github.com/ezylang/EvalEx" + - "https://github.com/ezylang/EvalEx" "Download from Maven Central": - - "//search.maven.org/search?q=a:%22EvalEx%22" + - "https://search.maven.org/search?q=a:%22EvalEx%22" "Release Notes": - - "//github.com/ezylang/EvalEx/releases" + - "https://github.com/ezylang/EvalEx/releases" footer_content: "Copyright © 2012-2022 Udo Klimaschewski" diff --git a/docs/concepts/changes.md b/docs/concepts/changes.md index 50741718..6b4b2a7b 100644 --- a/docs/concepts/changes.md +++ b/docs/concepts/changes.md @@ -106,7 +106,7 @@ See chapter [Data Access](../customization/data_access.html) for details. Adding custom operators is now easier, but has changed significantly. See chapter [Custom Operators](../customization/custom_operators.html) for details. -### Custom function +### Custom functions Adding custom functions is now easier, but has changed significantly. See chapter [Custom Functions](../customization/custom_functions.html) for details. diff --git a/docs/index.md b/docs/index.md index 8c35a08d..b256abf5 100644 --- a/docs/index.md +++ b/docs/index.md @@ -9,7 +9,9 @@ nav_order: 1 EvalEx is a handy expression evaluator for Java, that allows to parse and evaluate expression strings. -_Version 3 of EvalEx is a complete rewrite of the popular expression evaluator. See [Major Changes](https://ezylang.github.io/EvalEx/concepts/changes.html) for an overview of the changes._ +_Version 3 of EvalEx is a complete rewrite of the popular expression evaluator. +See [Major Changes](https://ezylang.github.io/EvalEx/concepts/changes.html) for an overview of the +changes._ ## Key Features: @@ -29,6 +31,42 @@ _Version 3 of EvalEx is a complete rewrite of the popular expression evaluator. x-y) - Lazy evaluation of function parameters (see the IF function) and support of sub-expressions. +## Discussion + +For announcements, questions and ideas visit +the [Discussions area](https://github.com/ezylang/EvalEx/discussions). + +## Download / Including + +You can download the binaries, source code and JavaDoc jars from +[Maven Central](https://search.maven.org/search?q=a:%22EvalEx%22).\ +You will find there also copy/paste templates for including EvalEx in your project with build +systems like Maven or Gradle. + +### Maven + +To include it in your Maven project, add the dependency to your pom. For example: + +```xml + + + com.ezylang + EvalEx + 3.0.1 + + +``` + +### Gradle + +If you're using gradle add the dependencies to your project's app build.gradle: + +```gradle +dependencies { + compile 'com.ezylang:EvalEx:3.0.1' +} +``` + ## Examples A simple example, that shows how it works in general: @@ -115,6 +153,14 @@ BigDecimal result = expression.evaluate().getNumberValue(); System.out.println(result); // prints 44.85 ``` +## EvalEx-big-math + +[Big-math](https://github.com/eobermuhlner/big-math) is a library by Eric Obermühlner. It provides +advanced Java BigDecimal math functions using an arbitrary precision. + +[EvalEx-big-math](https://github.com/ezylang/EvalEx-big-math) adds the advanced math functions from +big-math to EvalEx. + ## Author and License Copyright 2012-2022 by Udo Klimaschewski diff --git a/docs/references/operators.md b/docs/references/operators.md index 1181c774..368d8fa9 100644 --- a/docs/references/operators.md +++ b/docs/references/operators.md @@ -11,7 +11,7 @@ Available through the _ExpressionConfiguration.StandardOperatorsDictionary_ cons ### Arithmetic operators -| Name | Value | +| Name | Description | |------|-----------------------------------------| | - | The prefix minus operator, like in "-2" | | + | The prefix minus operator, like in "+2" | @@ -24,7 +24,7 @@ Available through the _ExpressionConfiguration.StandardOperatorsDictionary_ cons ### Boolean operators -| Name | Value | +| Name | Description | |--------------|-------------------------------------| | =, == | The equals operator | | !=, <> | The not equals operator | diff --git a/pom.xml b/pom.xml index 389f1441..1d001872 100644 --- a/pom.xml +++ b/pom.xml @@ -5,7 +5,7 @@ com.ezylang EvalEx - 3.0.1-SNAPSHOT + 3.0.1 EvalEx @@ -94,7 +94,7 @@ org.mockito mockito-core - 4.6.1 + 4.8.0 test