happy-rusty 1.3.2 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -15,10 +15,9 @@ The type parameter is set to `never` because `None` does not hold a value.
15
15
 
16
16
  ## Properties
17
17
 
18
- | Property | Modifier | Type | Description | Overrides | Inherited from | Defined in |
19
- | ------ | ------ | ------ | ------ | ------ | ------ | ------ |
20
- | `[OptionKindSymbol]` | `readonly` | `"None"` | When using `None` alone, the following overrides can make type inference more accurate. | `Option.[OptionKindSymbol]` | - | [prelude.ts:15](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L15) |
21
- | `[toStringTag]` | `public` | `"Option"` | [object Option]. | - | [`Option`](Option.md).`[toStringTag]` | [core.ts:30](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/core.ts#L30) |
18
+ | Property | Modifier | Type | Description | Overrides | Defined in |
19
+ | ------ | ------ | ------ | ------ | ------ | ------ |
20
+ | `[OptionKindSymbol]` | `readonly` | `"None"` | When using `None` alone, the following overrides can make type inference more accurate. | `Option.[OptionKindSymbol]` | [prelude.ts:15](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L15) |
22
21
 
23
22
  ## Methods
24
23
 
@@ -55,7 +54,7 @@ This is sometimes called "and then" because it is similar to a logical AND opera
55
54
 
56
55
  #### Defined in
57
56
 
58
- [prelude.ts:30](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L30)
57
+ [prelude.ts:42](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L42)
59
58
 
60
59
  ***
61
60
 
@@ -92,7 +91,41 @@ The result of `fn` if `this` is `Some`, otherwise `None`.
92
91
 
93
92
  #### Defined in
94
93
 
95
- [prelude.ts:31](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L31)
94
+ [prelude.ts:43](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L43)
95
+
96
+ ***
97
+
98
+ ### andThenAsync()
99
+
100
+ ```ts
101
+ andThenAsync<U>(fn): Promise<None>
102
+ ```
103
+
104
+ Asynchronous version of `andThen`.
105
+
106
+ #### Type Parameters
107
+
108
+ | Type Parameter |
109
+ | ------ |
110
+ | `U` |
111
+
112
+ #### Parameters
113
+
114
+ | Parameter | Type |
115
+ | ------ | ------ |
116
+ | `fn` | (`value`) => [`AsyncOption`](../type-aliases/AsyncOption.md)\<`U`\> |
117
+
118
+ #### Returns
119
+
120
+ `Promise`\<[`None`](None.md)\>
121
+
122
+ #### Overrides
123
+
124
+ [`Option`](Option.md).[`andThenAsync`](Option.md#andthenasync)
125
+
126
+ #### Defined in
127
+
128
+ [prelude.ts:44](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L44)
96
129
 
97
130
  ***
98
131
 
@@ -129,7 +162,7 @@ This method can be used for comparing `Option` instances in a value-sensitive ma
129
162
 
130
163
  #### Defined in
131
164
 
132
- [prelude.ts:36](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L36)
165
+ [prelude.ts:52](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L52)
133
166
 
134
167
  ***
135
168
 
@@ -155,13 +188,13 @@ Returns the contained `Some` value, with a provided error message if the value i
155
188
 
156
189
  Throws an error with the provided message if the Option is a `None`.
157
190
 
158
- #### Inherited from
191
+ #### Overrides
159
192
 
160
193
  [`Option`](Option.md).[`expect`](Option.md#expect)
161
194
 
162
195
  #### Defined in
163
196
 
164
- [core.ts:76](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/core.ts#L76)
197
+ [prelude.ts:22](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L22)
165
198
 
166
199
  ***
167
200
 
@@ -191,7 +224,7 @@ Returns `None` if the Option is `None`, otherwise calls predicate with the wrapp
191
224
 
192
225
  #### Defined in
193
226
 
194
- [prelude.ts:22](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L22)
227
+ [prelude.ts:32](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L32)
195
228
 
196
229
  ***
197
230
 
@@ -215,7 +248,7 @@ Converts from `Option<Option<T>>` to `Option<T>`.
215
248
 
216
249
  #### Defined in
217
250
 
218
- [prelude.ts:23](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L23)
251
+ [prelude.ts:33](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L33)
219
252
 
220
253
  ***
221
254
 
@@ -240,64 +273,64 @@ This is primarily for side effects and does not transform the `Option`.
240
273
 
241
274
  `this`, unmodified, for chaining additional methods.
242
275
 
243
- #### Inherited from
276
+ #### Overrides
244
277
 
245
278
  [`Option`](Option.md).[`inspect`](Option.md#inspect)
246
279
 
247
280
  #### Defined in
248
281
 
249
- [core.ts:263](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/core.ts#L263)
282
+ [prelude.ts:50](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L50)
250
283
 
251
284
  ***
252
285
 
253
286
  ### isNone()
254
287
 
255
288
  ```ts
256
- isNone(): boolean
289
+ isNone(): true
257
290
  ```
258
291
 
259
292
  Returns `true` if the Option is a `None` value.
260
293
 
261
294
  #### Returns
262
295
 
263
- `boolean`
296
+ `true`
264
297
 
265
- #### Inherited from
298
+ #### Overrides
266
299
 
267
300
  [`Option`](Option.md).[`isNone`](Option.md#isnone)
268
301
 
269
302
  #### Defined in
270
303
 
271
- [core.ts:55](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/core.ts#L55)
304
+ [prelude.ts:18](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L18)
272
305
 
273
306
  ***
274
307
 
275
308
  ### isSome()
276
309
 
277
310
  ```ts
278
- isSome(): boolean
311
+ isSome(): false
279
312
  ```
280
313
 
281
314
  Returns `true` if the Option is a `Some` value.
282
315
 
283
316
  #### Returns
284
317
 
285
- `boolean`
318
+ `false`
286
319
 
287
- #### Inherited from
320
+ #### Overrides
288
321
 
289
322
  [`Option`](Option.md).[`isSome`](Option.md#issome)
290
323
 
291
324
  #### Defined in
292
325
 
293
- [core.ts:50](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/core.ts#L50)
326
+ [prelude.ts:17](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L17)
294
327
 
295
328
  ***
296
329
 
297
330
  ### isSomeAnd()
298
331
 
299
332
  ```ts
300
- isSomeAnd(predicate): boolean
333
+ isSomeAnd(predicate): false
301
334
  ```
302
335
 
303
336
  Returns `true` if the Option is a `Some` value and the predicate returns `true` for the contained value.
@@ -310,15 +343,43 @@ Returns `true` if the Option is a `Some` value and the predicate returns `true`
310
343
 
311
344
  #### Returns
312
345
 
313
- `boolean`
346
+ `false`
314
347
 
315
- #### Inherited from
348
+ #### Overrides
316
349
 
317
350
  [`Option`](Option.md).[`isSomeAnd`](Option.md#issomeand)
318
351
 
319
352
  #### Defined in
320
353
 
321
- [core.ts:61](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/core.ts#L61)
354
+ [prelude.ts:19](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L19)
355
+
356
+ ***
357
+
358
+ ### isSomeAndAsync()
359
+
360
+ ```ts
361
+ isSomeAndAsync(predicate): Promise<false>
362
+ ```
363
+
364
+ Asynchronous version of `isSomeAnd`.
365
+
366
+ #### Parameters
367
+
368
+ | Parameter | Type |
369
+ | ------ | ------ |
370
+ | `predicate` | (`value`) => `Promise`\<`boolean`\> |
371
+
372
+ #### Returns
373
+
374
+ `Promise`\<`false`\>
375
+
376
+ #### Overrides
377
+
378
+ [`Option`](Option.md).[`isSomeAndAsync`](Option.md#issomeandasync)
379
+
380
+ #### Defined in
381
+
382
+ [prelude.ts:20](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L20)
322
383
 
323
384
  ***
324
385
 
@@ -352,7 +413,7 @@ Maps an `Option<T>` to `Option<U>` by applying a function to a contained value.
352
413
 
353
414
  #### Defined in
354
415
 
355
- [prelude.ts:24](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L24)
416
+ [prelude.ts:34](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L34)
356
417
 
357
418
  ***
358
419
 
@@ -381,13 +442,13 @@ Maps an `Option<T>` to `U` by applying a function to the contained value (if any
381
442
 
382
443
  `U`
383
444
 
384
- #### Inherited from
445
+ #### Overrides
385
446
 
386
447
  [`Option`](Option.md).[`mapOr`](Option.md#mapor)
387
448
 
388
449
  #### Defined in
389
450
 
390
- [core.ts:159](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/core.ts#L159)
451
+ [prelude.ts:35](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L35)
391
452
 
392
453
  ***
393
454
 
@@ -416,13 +477,13 @@ Maps an `Option<T>` to `U` by applying a function to a contained value (if any),
416
477
 
417
478
  `U`
418
479
 
419
- #### Inherited from
480
+ #### Overrides
420
481
 
421
482
  [`Option`](Option.md).[`mapOrElse`](Option.md#maporelse)
422
483
 
423
484
  #### Defined in
424
485
 
425
- [core.ts:167](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/core.ts#L167)
486
+ [prelude.ts:36](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L36)
426
487
 
427
488
  ***
428
489
 
@@ -450,13 +511,13 @@ Transforms the `Option<T>` into a `Result<T, E>`, mapping `Some(v)` to `Ok(v)` a
450
511
 
451
512
  [`Result`](Result.md)\<`never`, `E`\>
452
513
 
453
- #### Inherited from
514
+ #### Overrides
454
515
 
455
516
  [`Option`](Option.md).[`okOr`](Option.md#okor)
456
517
 
457
518
  #### Defined in
458
519
 
459
- [core.ts:109](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/core.ts#L109)
520
+ [prelude.ts:28](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L28)
460
521
 
461
522
  ***
462
523
 
@@ -484,13 +545,13 @@ Transforms the `Option<T>` into a `Result<T, E>`, mapping `Some(v)` to `Ok(v)` a
484
545
 
485
546
  [`Result`](Result.md)\<`never`, `E`\>
486
547
 
487
- #### Inherited from
548
+ #### Overrides
488
549
 
489
550
  [`Option`](Option.md).[`okOrElse`](Option.md#okorelse)
490
551
 
491
552
  #### Defined in
492
553
 
493
- [core.ts:116](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/core.ts#L116)
554
+ [prelude.ts:29](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L29)
494
555
 
495
556
  ***
496
557
 
@@ -527,7 +588,7 @@ This can be used for providing a fallback `Option`.
527
588
 
528
589
  #### Defined in
529
590
 
530
- [prelude.ts:32](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L32)
591
+ [prelude.ts:45](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L45)
531
592
 
532
593
  ***
533
594
 
@@ -564,7 +625,41 @@ This method can be used for lazy fallbacks, as `fn` is only evaluated if `this`
564
625
 
565
626
  #### Defined in
566
627
 
567
- [prelude.ts:33](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L33)
628
+ [prelude.ts:46](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L46)
629
+
630
+ ***
631
+
632
+ ### orElseAsync()
633
+
634
+ ```ts
635
+ orElseAsync<T>(fn): AsyncOption<T>
636
+ ```
637
+
638
+ Asynchronous version of `orElse`.
639
+
640
+ #### Type Parameters
641
+
642
+ | Type Parameter |
643
+ | ------ |
644
+ | `T` |
645
+
646
+ #### Parameters
647
+
648
+ | Parameter | Type |
649
+ | ------ | ------ |
650
+ | `fn` | () => [`AsyncOption`](../type-aliases/AsyncOption.md)\<`T`\> |
651
+
652
+ #### Returns
653
+
654
+ [`AsyncOption`](../type-aliases/AsyncOption.md)\<`T`\>
655
+
656
+ #### Overrides
657
+
658
+ [`Option`](Option.md).[`orElseAsync`](Option.md#orelseasync)
659
+
660
+ #### Defined in
661
+
662
+ [prelude.ts:47](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L47)
568
663
 
569
664
  ***
570
665
 
@@ -586,7 +681,7 @@ Custom `toString` implementation that uses the `Option`'s contained value.
586
681
 
587
682
  #### Defined in
588
683
 
589
- [core.ts:280](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/core.ts#L280)
684
+ [core.ts:302](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/core.ts#L302)
590
685
 
591
686
  ***
592
687
 
@@ -612,7 +707,7 @@ Transposes an `Option` of a `Result` into a `Result` of an `Option`.
612
707
 
613
708
  #### Defined in
614
709
 
615
- [prelude.ts:20](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L20)
710
+ [prelude.ts:30](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L30)
616
711
 
617
712
  ***
618
713
 
@@ -632,13 +727,13 @@ Returns the contained `Some` value.
632
727
 
633
728
  Throws an error if the value is a `None`.
634
729
 
635
- #### Inherited from
730
+ #### Overrides
636
731
 
637
732
  [`Option`](Option.md).[`unwrap`](Option.md#unwrap)
638
733
 
639
734
  #### Defined in
640
735
 
641
- [core.ts:82](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/core.ts#L82)
736
+ [prelude.ts:23](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L23)
642
737
 
643
738
  ***
644
739
 
@@ -672,7 +767,7 @@ Returns the contained `Some` value or a provided default.
672
767
 
673
768
  #### Defined in
674
769
 
675
- [prelude.ts:17](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L17)
770
+ [prelude.ts:24](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L24)
676
771
 
677
772
  ***
678
773
 
@@ -706,7 +801,41 @@ Returns the contained `Some` value or computes it from a closure.
706
801
 
707
802
  #### Defined in
708
803
 
709
- [prelude.ts:18](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L18)
804
+ [prelude.ts:25](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L25)
805
+
806
+ ***
807
+
808
+ ### unwrapOrElseAsync()
809
+
810
+ ```ts
811
+ unwrapOrElseAsync<T>(fn): Promise<T>
812
+ ```
813
+
814
+ Asynchronous version of `unwrapOrElse`.
815
+
816
+ #### Type Parameters
817
+
818
+ | Type Parameter |
819
+ | ------ |
820
+ | `T` |
821
+
822
+ #### Parameters
823
+
824
+ | Parameter | Type |
825
+ | ------ | ------ |
826
+ | `fn` | () => `Promise`\<`T`\> |
827
+
828
+ #### Returns
829
+
830
+ `Promise`\<`T`\>
831
+
832
+ #### Overrides
833
+
834
+ [`Option`](Option.md).[`unwrapOrElseAsync`](Option.md#unwraporelseasync)
835
+
836
+ #### Defined in
837
+
838
+ [prelude.ts:26](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L26)
710
839
 
711
840
  ***
712
841
 
@@ -732,7 +861,7 @@ A tuple of `Options`, one for each element in the original `Option` of a tuple.
732
861
 
733
862
  #### Defined in
734
863
 
735
- [prelude.ts:28](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L28)
864
+ [prelude.ts:40](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L40)
736
865
 
737
866
  ***
738
867
 
@@ -769,7 +898,7 @@ This can be thought of as an exclusive or operation on `Option` values.
769
898
 
770
899
  #### Defined in
771
900
 
772
- [prelude.ts:34](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L34)
901
+ [prelude.ts:48](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L48)
773
902
 
774
903
  ***
775
904
 
@@ -807,7 +936,7 @@ An `Option` containing a tuple of the values if both are `Some`, otherwise `None
807
936
 
808
937
  #### Defined in
809
938
 
810
- [prelude.ts:26](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L26)
939
+ [prelude.ts:38](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L38)
811
940
 
812
941
  ***
813
942
 
@@ -847,4 +976,4 @@ An `Option` containing the result of `fn` if both `Options` are `Some`, otherwis
847
976
 
848
977
  #### Defined in
849
978
 
850
- [prelude.ts:27](https://github.com/JiangJie/happy-rusty/blob/d91a6123f053d528d1e11023507d8f0c72720848/src/enum/prelude.ts#L27)
979
+ [prelude.ts:39](https://github.com/JiangJie/happy-rusty/blob/6efe20969984552f52d79aee092bb6925a077fe7/src/enum/prelude.ts#L39)