Package 'featureflag'

Creates an instance of a bool feature flag with the specified bool value.

Description

Creates an instance of a bool feature flag with the specified bool value.

Usage

create_bool_feature_flag(value)

Arguments

value

single logical determining whether the flag should be enabled

Value

feature flag object of the bool value

Examples

{
  enabled_flag <- create_bool_feature_flag(TRUE)
  disabled_flag <- create_bool_feature_flag(FALSE)
}

---

Creates the base of a feature flag.

Description

It should not be used directly, but only as a prerequisite when creating concrete feature flag.

Usage

create_feature_flag()

Value

instance of a base feature flag.

---

Creates an instance of a percentage feature flag with a specified chance of being enabled

Description

Creates an instance of a percentage feature flag with a specified chance of being enabled

Usage

create_percentage_feature_flag(percentage)

Arguments

percentage

chance of being enabled e.g. 1 for always being enabled

Value

feature flag object of the percentage type

Examples

{
  always_enabled_flag <- create_percentage_feature_flag(percentage = 1)
  randomly_enabled_flag <- create_percentage_feature_flag(percentage = 0.5)
}

---

Creates an instance of a time period feature flag.

Description

Creates an instance of a time period feature flag.

Usage

create_time_period_feature_flag(from = NULL, to = NULL)

Arguments

from	date-time from which the feature flag should be enabled set as null if you want a one sided boundary.
to	date-time to which the feature flag should be enabled set as null if you want a one sided boundary

Details

Boundaries are set as inclusive

Examples

{
   two_sided_flag <- create_time_period_feature_flag(
      from = ISOdatetime(2020, 10, 10, 0, 0, 0, tz = "UTC"),
      to = ISOdatetime(2020, 11, 10, 0, 0, 0, tz = "UTC")
   )

   left_sided_flag <- create_time_period_feature_flag(
      from = ISOdatetime(2020, 10, 10, 0, 0, 0, tz = "UTC")
   )

   right_sided_flag <- create_time_period_feature_flag(
      to = ISOdatetime(2020, 10, 10, 0, 0, 0, tz = "UTC")
   )

}

---

Evaluates the provided expression if the feature flag is enabled.

Description

Evaluates the provided expression if the feature flag is enabled.

Usage

feature_if(feature_flag, expr)

Arguments

feature_flag	flag which defines whether the provided expression should be evaluated
expr	expression to evaluate when the feature_flag is enabled

Details

The passed expression is evaluated in the frame where feature_if is called.

Value

If the passed feature_flag is enabled, than the result of the evaluation of the passed expression is returned. Otherwise there is no return value.

Examples

{
  flag <- create_bool_feature_flag(TRUE)

  feature_if(flag, {
    2 + 7
  })
}

---

Evaluates one or the other expression based on whether the feature flag is enabled.

Description

Evaluates one or the other expression based on whether the feature flag is enabled.

Usage

feature_ifelse(feature_flag, true_expr, false_expr)

Arguments

feature_flag	flag which defines which expression should be evaluated
true_expr	expression to evaluate when the feature_flag is enabled
false_expr	expression to evaluate when the feature_flag is disabled

Details

The passed expression is evaluated in the frame where feature_ifelse is called.

Value

The result of evaluating true_expr is returned if the passed feature_flag is enabled. Otherwise the result of evaluating false_expr is returned.

Examples

{
  flag <- create_bool_feature_flag(TRUE)

  feature_ifelse(
    flag,
    2 * 7,
    3 * 7
  )
}

---

Checks if the given feature flag is enabled.

Description

Checks if the given feature flag is enabled.

Usage

is_enabled(feature_flag)

Arguments

feature_flag

feature flag to be tested whether it is enabled

Value

TRUE if the feature flag is enabled.

---

Checks if the given bool feature flag is enabled

Description

Checks if the given bool feature flag is enabled

Usage

## S3 method for class 'bool_feature_flag'
is_enabled(feature_flag)

Arguments

feature_flag

flag to be checked whether it is enabled

Value

TRUE if the feature flag is enabled.

Examples

{
  enabled_flag <- create_bool_feature_flag(TRUE)

  if (is_enabled(enabled_flag)) {
    print("The flag is enabled!")
  }
}

---

Checks if the given percentage flag is enabled

Description

Checks if the given percentage flag is enabled

Usage

## S3 method for class 'percentage_feature_flag'
is_enabled(feature_flag)

Arguments

feature_flag

flag to be checked whether it is enabled

Value

TRUE if the feature flag is enabled.

Examples

{
  enabled_flag <- create_percentage_feature_flag(1)

  if (is_enabled(enabled_flag)) {
    print("The flag is enabled!")
  }
}

---

Checks if the given bool feature flag is enabled

Description

Checks if the given bool feature flag is enabled

Usage

## S3 method for class 'time_period_feature_flag'
is_enabled(feature_flag)

Arguments

feature_flag

flag to be checked whether it is enabled

Value

TRUE if the feature flag is enabled.

Examples

{
   feature_flag <- create_time_period_feature_flag(
      from = ISOdatetime(2020, 10, 10, 0, 0, 0, tz = "UTC")
   )

   if (is_enabled(feature_flag)) {
      print("The flag is enabled!")
   }
}

---