https://github.com/exoticknight/rust-option
brings Option / Result / match from Rust to Javascript
https://github.com/exoticknight/rust-option
javascript option result rust rust-option typescript
Last synced: 29 days ago
JSON representation
brings Option / Result / match from Rust to Javascript
- Host: GitHub
- URL: https://github.com/exoticknight/rust-option
- Owner: exoticknight
- License: mit
- Created: 2018-12-10T14:42:44.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-01-05T18:28:57.000Z (over 2 years ago)
- Last Synced: 2025-05-03T14:03:58.047Z (about 1 month ago)
- Topics: javascript, option, result, rust, rust-option, typescript
- Language: TypeScript
- Homepage:
- Size: 396 KB
- Stars: 24
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# rust-option
[](https://travis-ci.org/exoticknight/rust-option)
[](https://codecov.io/gh/exoticknight/rust-option)
brings Option / Result / match from Rust to Javascript
## Install
```bash
npm i -S rust-option
```
## Usage
Nearly all methods are similar to the [Option][option] and [Result][result]
> this lib will not implement all methods from Rust's Option and Result, see [Note](#Note)
```javascript
import {
Some,
None,
Ok,
Err,
match,
} from 'rust-option'
let x = Some(2)
let y = None
let z = Ok(1)
let w = Err('error')
// Note: matches are exhaustive
let ret = match(x, [
[Some(2), theX => 'match and get the 2'],
[None, () => 'should not match None'],
[Ok, () => 'should not match Ok'],
[Err('error'), () => 'should not match Err(\'error\')'],
// function is not a must
[Some(2), 'something'],
// the 'default' match must be function
(arg) => 'should not match default',
])
// ret is 'match and get the Some(2)'
```
See more examples in [Test][test] and [Examples][examples].
[option]: https://doc.rust-lang.org/std/option/enum.Option.html
[result]: https://doc.rust-lang.org/std/result/enum.Result.html
[test]: https://github.com/exoticknight/rust-option/tree/master/test
[Examples]: #examples
## Test
```bash
npm test
```
## The `match` function
`match` function provides match syntax similar to Rust, but in JavaScript way.
equal(===) considered to be match
```javascript
match(1, [
[1, () => console.log('match')],
() => console.log('not match ')
])
```
handle type match
```javascript
match(1, [
[Number, (x) => console.log(x)],
() => console.log('not match ')
])
```
more matches
**value**|**match**
-----|-----
1|1, Number
NaN|NaN, Number
'yeah'|'yeah', 'ea', String
false|false, Boolean
function f(){}|Function
new Date('2000-01-01')|new Date('2000-01-01'), Date
[1,2,4]|Array
/foo/|RegExp
new Set|Set
new Map|Map
new WeakMap|WeakMap
new WeakSet|WeakSet
Symbol.iterator|Symbol
arguments|Arguments
new Error|Error
{a:1, b:2 }|object, {a: 1}, {a: Number}
Some(1)|Some(1),Some
Ok(1)|Ok(1),Ok
Err(1)|Err(1),Err
None|None
Some({a:1, b:2 })|Some(object),Some({a: 1}),Some
**given**|**value**|**match**
-----|-----|-----
class A {}|new A|A
class B extends A {}|new B|A,B
non-exhaustive match throws Error
```javascript
// this will throws 'non-exhaustive patterns' Error
match(x, [
[None, () => console.log('not match None')],
])
```
default branch can get the matchee
```javascript
match(x, [
m => console.log('default match get Some(2) as parameter')
])
```
handle nested match
```javascript
let z = Ok(x)
let w = Err('error')
match(z, [
[Ok(Some(2)), () => console.log('match and get Some(2)')],
[w, () => console.log('not match Err')],
// the 'default' match
() => console.log('not match default'),
])
```
## the ?
use `.$` instead of ?
```javascript
Ok(1).$ === 1 // similar to Ok(1).unwrap() and Ok(1)?
try {
Err('I am Err').$
} catch (err) {
err.message === 'I am Err'
}
Some(1).$ === 1 // similar to Some(1).unwrap() and Some(1)?
try {
None.$
} catch (err) {
err instanceof NoneError
}
```
## more helper functions
### makeMatch
```typescript
makeMatch(branches:(((x:any)=>T) | [any, T | ((x?:any)=>T)])[], deep:boolean=false):(opt:any)=>T;
```
actually,
```javascript
match(x, [
() => 'x'
])
```
is
```javascript
makeMatch([
() => 'x'
])(x)
```
### equal
so you can not just use `===` or `==` to compare Option and Result, but the Option and Result itself provides an API call 'equal' for that.
```javascript
// equal
Some(1).equal(Some(1))
// deepEqual
Ok({a: 1}).equal(Ok({a: 1}), true)
```
### optionify / resultify
await a function and make its output or Error to be Option or Result.
```javascript
const content = await resultify(() => Promise.resolve('content'))()
match(content, [
[Ok, c => c],
[Err, 'nothing']
])
```
### optionifySync / resultifySync
wrap a function and make its output or Error to be Option or Result.
```javascript
const content = resultifySync(fs.statSync)('./f')
match(content, [
[Ok, c => c],
[Err, 'nothing']
])
```
## deepEqual
deepEqual in Javascript is not a piece of cake.
deepEqual in this lib is provided by [lodash.isequal][lodash.isequal].
```javascript
import {
Some
} from 'rust-option'
let ox = Some({foo: 1})
let oy = Some({foo: 1})
ox.equal(oy) // false
ox.equal(oy, true) // true
```
[lodash.isequal]: https://www.npmjs.com/package/lodash.isequal
an [examples](https://stackblitz.com/edit/react-ts-6xdhsg?file=index.tsx) with React on StackBlitz.
Unlike Rust, JavaScript doesn't have the 'Ownership' feature, so some API like 'as_ref ' is not necessary.
## implement for Option
- [x] isSome
- [x] isNone
- [x] expect
- [x] unwrap
- [x] unwrapOr
- [x] unwrapOrElse
- [x] map
- [x] mapOr
- [x] mapOrElse
- [x] okOr
- [x] okOrElse
- [x] and
- [x] andThen
- [x] filter
- [x] or
- [x] orElse
- [x] xor
- [x] transpose
- [x] ?
## not implement for Option
```text
as_ref
as_mut
as_pin_ref
as_pin_mut
iter
iter_mut
get_or_insert
get_or_insert_with
take
replace
cloned
unwrap_or_default
deref
```
## implement for Result
- [x] isOk
- [x] isErr
- [x] ok
- [x] err
- [x] map
- [x] mapOrElse
- [x] mapErr
- [x] and
- [x] andThen
- [x] or
- [x] orElse
- [x] unwrapOr
- [x] unwrapOrElse
- [x] unwrap
- [x] expect
- [x] unwrapErr
- [x] expectErr
- [x] transpose
- [x] ?
## not implement for Result
```text
as_ref
as_mut
iter
iter_mut
unwrap_or_default
deref_ok
deref_err
deref
```
## License
MIT