brk_rolldown_std_utils 0.1.0

brk fork of rolldown_std_utils
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

use crate::pretty_type_name;

pub trait OptionExt<T> {
  fn unpack(self) -> T;

  fn unpack_ref(&self) -> &T;

  fn unpack_ref_mut(&mut self) -> &mut T;
}

impl<T> OptionExt<T> for Option<T> {
  /// Similar to `unwrap`, but with a more descriptive panic message.
  ///
  /// ```ignore
  /// None::<usize>.unwrap();
  /// // called `Option::unwrap()` on a `None` value
  ///
  /// None::<usize>.unpack();
  /// // Got `None` value when calling `OptionExt::unpack()` on `Option<usize>`
  /// ```
  #[track_caller]
  fn unpack(self) -> T {
    match self {
      Some(v) => v,
      None => panic!(
        "Got `None` value when calling `OptionExt::unpack()` on `{type_name}`",
        type_name = pretty_type_name::<Self>()
      ),
    }
  }

  /// Shorthand for `self.as_ref().unpack()`.
  fn unpack_ref(&self) -> &T {
    self.as_ref().unpack()
  }

  /// Shorthand for `self.as_mut().unpack()`.
  fn unpack_ref_mut(&mut self) -> &mut T {
    self.as_mut().unpack()
  }
}