rlse

rlse

Rlse (pronounced “release”) is an open-source library written in Rust that makes feature flags a first-class citizen in your codebase. With Rlse, you can easily manage feature flag definitions directly in your code, improving consistency, simplicity, and efficiency in your release process.

Installation

Install the npm package

Add Rlse to your project using npm:

$ npm install rlse -S

Create a configuration file

Create a configuration file in the root of your project to define your feature flags. By default, Rlse looks for a file named rlse.toml. Here’s an example:

[features]
testFeature1 = { environments = ['dev', 'test']}
testFeature2 = { environments = ['test']}
testFeature3 = { environments = ['dev', 'uat', 'test', 'prod']}

If you prefer a different file name, set the RLSE_CONFIG environment variable to point to it. For example:

export RLSE_CONFIG="custom_config.toml"

💡 Tip: Ensure the configuration file is included in your build process so it deploys with your application.

Defining Features

The [features] section is where you define your feature flags. Each feature is a key-value pair, where the key is the feature name and the value specifies the environments in which it is enabled.

Example:

[features]
uniqueFriendlyFeatureName = { environments = ['dev']}

In this example:

• The uniqueFriendlyFeatureName feature is enabled only in the dev environment.
• The environment can be determined dynamically from the APP_ENV environment variable or explicitly passed when testing the feature flag.

Usage

Rlse makes it easy to conditionally enable features based on your configuration. Use the is_enabled function to check whether a feature is active in a given environment.

Example:

import { is_enabled } from "rlse";

// Automatically checks the `APP_ENV` environment variable.
// Defaults to the 'dev' environment if `APP_ENV` is not set.
if (is_enabled("uniqueFriendlyFeatureName")) {
  // Feature-specific logic here
}

// Explicitly pass an environment as the second parameter.
if (is_enabled("uniqueFriendlyFeatureName", "prod")) {
  // Feature-specific logic for production environment
}

🛑 Important:

• is_enabled() will return false unless the feature/environment combination is explicitly defined in the configuration file.
• Ensure your configuration file accurately reflects your environment setup.

Why Choose Rlse?

• Simplify Feature Management: Centralize and standardize feature flag definitions across environments.
• Rust-Powered Performance: Benefit from the speed and reliability of Rust under the hood.
• First-Class Code Citizen: Keep feature flags in your codebase, reducing the risk of misalignment.