__ _.-~ ) _..--~~~~,' ,-/ _ .-'. . . .' ,-',' ,' ) ,'. . . _ ,--~,-'__..-' ,' ,'. . . (@)' ---~~~~ ,' /. . . . '~~ ,-' /. . . . . ,-' ; . . . . - . ,' : . . . . _ / . . . . . `-.: . . . ./ - . ) . . . | _____..---.._/ _____ ~---~~~~----~~~~ ~~
Feature flipping is the act of enabling or disabling features or parts of your application, ideally without re-deploying or changing anything in your code base.
The goal of this gem is to make turning features on or off so easy that everyone does it. Whatever your data store, throughput, or experience, feature flipping should be easy and have minimal impact on your application.
Add this line to your application's Gemfile:
And then execute:
Or install it yourself with:
$ gem install flipper
The goal of the API for flipper was to have everything revolve around features and what ways they can be enabled. Start with top level and dig into a feature, then dig in further and enable that feature for a given type of access, as opposed to thinking about how the feature will be accessed first (ie:
require 'flipper' require 'flipper/adapters/memory' Flipper.configure do |config| config.default do # pick an adapter, this uses memory, any will do adapter = Flipper::Adapters::Memory.new # pass adapter to handy DSL instance Flipper.new(adapter) end end # check if search is enabled if Flipper.enabled?(:search) puts 'Search away!' else puts 'No search for you!' end puts 'Enabling Search...' Flipper.enable(:search) # check if search is enabled if Flipper.enabled?(:search) puts 'Search away!' else puts 'No search for you!' end
- Gates - Boolean, Groups, Actors, % of Actors, and % of Time
- Adapters - Mongo, Redis, Cassandra, Active Record...
- Instrumentation - ActiveSupport::Notifications, Statsd and Metriks
- Optimization - Memoization middleware and Cache adapters
- Web Interface - Point and click...
- API - HTTP API interface
- Caveats - Flipper beware! (see what I did there)
- Docker-Compose - Using docker-compose in contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature)
- Check your changes with Rubocop tests (
- Commit your changes (
git commit -am 'Added some feature')
- Push to the branch (
git push origin my-new-feature)
- Create new Pull Request
- Update the version to be whatever it should be and commit.
Brought To You By