-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'master' into sessions/error-format
- Loading branch information
Showing
229 changed files
with
8,594 additions
and
1,387 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,72 @@ | ||
# kbn-tinymath | ||
|
||
kbn-tinymath is a tiny arithmetic and function evaluator for simple numbers and arrays. Named properties can be accessed from an optional scope parameter. | ||
It's available as an expression function called `math` in Canvas, and the grammar/AST structure is available | ||
for use by Kibana plugins that want to use math. | ||
|
||
See [Function Documentation](/docs/functions.md) for details on built-in functions available in Tinymath. | ||
|
||
```javascript | ||
const { evaluate } = require('@kbn/tinymath'); | ||
|
||
// Simple math | ||
evaluate('10 + 20'); // 30 | ||
evaluate('round(3.141592)') // 3 | ||
|
||
// Named properties | ||
evaluate('foo + 20', {foo: 5}); // 25 | ||
|
||
// Arrays | ||
evaluate('bar + 20', {bar: [1, 2, 3]}); // [21, 22, 23] | ||
evaluate('bar + baz', {bar: [1, 2, 3], baz: [4, 5, 6]}); // [5, 7, 9] | ||
evaluate('multiply(bar, baz) / 10', {bar: [1, 2, 3], baz: [4, 5, 6]}); // [0.4, 1, 1.8] | ||
``` | ||
|
||
### Adding Functions | ||
|
||
Functions can be injected, and built in function overwritten, via the 3rd argument to `evaluate`: | ||
|
||
```javascript | ||
const { evaluate } = require('@kbn/tinymath'); | ||
|
||
evaluate('plustwo(foo)', {foo: 5}, { | ||
plustwo: function(a) { | ||
return a + 2; | ||
} | ||
}); // 7 | ||
``` | ||
|
||
### Parsing | ||
|
||
You can get to the parsed AST by importing `parse` | ||
|
||
```javascript | ||
const { parse } = require('@kbn/tinymath'); | ||
|
||
parse('1 + random()') | ||
/* | ||
{ | ||
"name": "add", | ||
"args": [ | ||
1, | ||
{ | ||
"name": "random", | ||
"args": [] | ||
} | ||
] | ||
} | ||
*/ | ||
``` | ||
|
||
#### Notes | ||
|
||
* Floating point operations have the normal Javascript limitations | ||
|
||
### Building kbn-tinymath | ||
|
||
This package is rebuilt when running `yarn kbn bootstrap`, but can also be build directly | ||
using `yarn build` from the `packages/kbn-tinymath` directory. | ||
### Running tests | ||
|
||
To test `@kbn/tinymath` from Kibana, run `yarn run jest --watch packages/kbn-tinymath` from | ||
the top level of Kibana. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,19 @@ | ||
/* | ||
* Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one | ||
* or more contributor license agreements. Licensed under the Elastic License | ||
* and the Server Side Public License, v 1; you may not use this file except in | ||
* compliance with, at your election, the Elastic License or the Server Side | ||
* Public License, v 1. | ||
*/ | ||
|
||
module.exports = { | ||
env: { | ||
web: { | ||
presets: ['@kbn/babel-preset/webpack_preset'], | ||
}, | ||
node: { | ||
presets: ['@kbn/babel-preset/node_preset'], | ||
}, | ||
}, | ||
ignore: ['**/*.test.ts', '**/*.test.tsx'], | ||
}; |
Oops, something went wrong.