https://github.com/dreambo8563/vue-lazy-calc
simple calculation lib with lazy feature 🎲➕➖➗✖️
https://github.com/dreambo8563/vue-lazy-calc
calculator chaining lazy-evaluation typescript vue
Last synced: about 2 months ago
JSON representation
simple calculation lib with lazy feature 🎲➕➖➗✖️
- Host: GitHub
- URL: https://github.com/dreambo8563/vue-lazy-calc
- Owner: dreambo8563
- License: mit
- Created: 2019-03-14T07:35:39.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-10-17T23:34:02.000Z (about 1 year ago)
- Last Synced: 2024-10-20T10:53:25.115Z (about 1 year ago)
- Topics: calculator, chaining, lazy-evaluation, typescript, vue
- Language: TypeScript
- Homepage:
- Size: 2.83 MB
- Stars: 9
- Watchers: 3
- Forks: 4
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-vue - vue-lazy-calc - A simple calculation plugin in lazy && chaining way with strong typed. (Components & Libraries / Utilities)
- awesome-vue - vue-lazy-calc - A simple calculation plugin in lazy && chaining way with strong typed. (Utilities / Printing)
- awesome-vue - vue-lazy-calc - simple calculation lib with lazy feature ` 📝 a year ago ` (Utilities [🔝](#readme))
README
[](https://codecov.io/gh/dreambo8563/vue-lazy-calc)
[](https://app.codacy.com/app/dreambo8563/vue-lazy-calc?utm_source=github.com&utm_medium=referral&utm_content=dreambo8563/vue-lazy-calc&utm_campaign=Badge_Grade_Dashboard)
[](#contributors)
[](https://travis-ci.com/dreambo8563/vue-lazy-calc) [](https://greenkeeper.io/)
[](https://snyk.io/test/github/dreambo8563/vue-lazy-calc?targetFile=package.json)
[](https://opensource.org/licenses/MIT)
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fdreambo8563%2Fvue-lazy-calc?ref=badge_shield)
# vue-lazy-calc
this is a simple calculation plugin in lazy way.
(inspired by lodash)
**features**
- vue friendly
- strong typed
- lazy evaluation
- chaining methods
- code coverage 100%
### TODO:
- [x] seperate simple lazy class from base class
- [x] support more operator in stream api
### Install
```cmd
npm install vue-lazy-calc --save
```
### Quick Start
```js
import lzCalc from "vue-lazy-calc"
Vue.use(lzCalc)
```
### Methods
- this.\$lzCalc in Component context.
- Vue.\$lzCalc in global.
### API list
#### base
```ts
export declare class LazyBase {
lazy(init?: number): LazyCalc
stream(s?: LazyCalc): LazyStream
}
```
- lazy => init a new instance with optional initValue
- stream => init a stream to operate between multiple lazy instance with optional init instantce
#### simple
```ts
export declare class LazyCalc {
add(y: number): LazyCalc
divide(y: number): LazyCalc
subtract(y: number): LazyCalc
multiply(y: number): LazyCalc
do(fn: operatorFunc): LazyCalc
ceil(precision?: number): LazyCalc
floor(precision?: number): LazyCalc
round(precision?: number): LazyCalc
default(fallback: any): LazyCalc
value(): any
}
```
- add/subtract/divide/multiple => + - \* / (simple calculation) between numbers
- round/floor/ceil => deal with precision of the float number
- value => excute the declared method chain
- default => set default value if previous operations get NaN
- do => accept a custormized function for the number
### Examples
(1+3)\*2/3 with precision 2
```js
const result = this.$lzCalc
.lazy(1)
.add(3)
.multiply(2)
.divide(3)
.round(2)
console.log(result.value()) // 2.67
const addThree = result.add(3)
console.log(addThree.value()) // 2.67+ 3 =>5.67
```
#### Stream
```ts
declare class LazyStream {
add(y: LazyCalc): LazyStream
subtract(y: LazyCalc): LazyStream
multiply(y: LazyCalc): LazyStream
divide(y: LazyCalc): LazyStream
round(precision?: number): LazyStream
ceil(precision?: number): LazyStream
floor(precision?: number): LazyStream
do(fn: operatorFunc): LazyStream
default(fallback: any): LazyStream
value(): any
}
```
```js
const result = this.$lzCalc
.lazy(1)
.add(3)
.multiply(2)
.divide(3)
.round(2)
const tmp = this.$lzCalc.lazy(2).add(3)
const s = this.$lzCalc.stream(result).add(tmp)
console.log(s.value()) // 2.67 + 5 => 7.67
```
1. when declare the result variable, no calculation excuted until value()
2. you can reuse the declare variable
## License
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fdreambo8563%2Fvue-lazy-calc?ref=badge_large)
## Contributors
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
