labs/lib/src/bools/default.nix

lib: {
  bools = {
    into = {
      ## Convert a boolean value into a string.
      ##
      ## @type Bool -> String
      string = value:
        if value
        then "true"
        else "false";

      ## Convert a boolean into either the string "yes" or "no".
      ##
      ## @type Bool -> String
      yesno = value:
        if value
        then "yes"
        else "no";
    };

    ## Choose between two values based on a condition. When true, the first value
    ## is returned, otherwise the second value is returned.
    ##
    ## @type Bool -> a -> b -> a | b
    when = condition: x: y:
      if condition
      then x
      else y;

    ## Perform a logical AND operation on two values.
    ##
    ## @type Bool -> Bool -> Bool
    and = a: b: a && b;

    ## Perform a logical AND operation on two functions being applied to a value.
    ##
    ## @type (a -> Bool) -> (a -> Bool) -> a -> Bool
    and' = f: g: (
      x: (f x) && (g x)
    );

    ## Perform a logical OR operation on two values.
    ##
    ## @type Bool -> Bool -> Bool
    or = a: b: a || b;

    ## Perform a logical OR operation on two functions being applied to a value.
    ##
    ## @type (a -> Bool) -> (a -> Bool) -> a -> Bool
    or' = f: g: (
      x: (f x) || (g x)
    );

    ## Perform a logical NOT operation on a value.
    ##
    ## @type Bool -> Bool
    not = a: !a;
  };
}