flipper 0.28.3 → 1.4.2

data/README.md

@@ -1,17 +1,17 @@
 [![Flipper Mark](docs/images/banner.jpg)](https://www.flippercloud.io)
 
-[Website](https://flippercloud.io) | [Documentation](https://flippercloud.io/docs) | [Examples](examples) | [Twitter](https://twitter.com/flipper_cloud)
+[Website](https://flippercloud.io?utm_source=oss&utm_medium=readme&utm_campaign=website_link) | [Documentation](https://flippercloud.io/docs?utm_source=oss&utm_medium=readme&utm_campaign=docs_link) | [Examples](examples) | [Chat](https://chat.flippercloud.io/join/xjHq-aJsA-BeZH) | [Twitter](https://twitter.com/flipper_cloud) | [Ruby.social](https://ruby.social/@flipper)
 
 # Flipper
 
-> Beautiful, performant feature flags for Ruby.
+> Beautiful, performant feature flags for Ruby and Rails.
 
 Flipper gives you control over who has access to features in your app.
 
-* Enable or disable features for everyone, specific actors, groups of actors, a percentage of actors, or a percentage of time.
-* Configure your feature flags from the console or a web UI.
-* Regardless of what data store you are using, Flipper can performantly store your feature flags.
-* Use [Flipper Cloud](#flipper-cloud) to cascade features from multiple environments, share settings with your team, control permissions, keep an audit history, and rollback.
+- Enable or disable features for everyone, specific actors, groups of actors, a percentage of actors, or a percentage of time.
+- Configure your feature flags from the console or a web UI.
+- Regardless of what data store you are using, Flipper can performantly store your feature flags.
+- Use [Flipper Cloud](#flipper-cloud) to cascade features from multiple environments, share settings with your team, control permissions, keep an audit history, and rollback.
 
 Control your software — don't let it control you.
 
@@ -35,7 +35,7 @@ Or install it yourself with:
 
 ## Subscribe & Ship
 
-[💌  Subscribe](https://buttondown.email/flipper) - I'll send you short and sweet emails when we release new versions.
+[💌  Subscribe](https://blog.flippercloud.io/#/portal/signup) - we'll send you short and sweet emails when we release new versions ([examples](https://blog.flippercloud.io/tag/releases/)).
 
 ## Getting Started
 
@@ -43,7 +43,7 @@ Use `Flipper#enabled?` in your app to check if a feature is enabled.
 
 ```ruby
 # check if search is enabled
-if Flipper.enabled? :search, current_user
+if Flipper.enabled?(:search, current_user)
   puts 'Search away!'
 else
   puts 'No search for you!'
@@ -66,24 +66,26 @@ Flipper.enable_group :search, :admin
 Flipper.enable_percentage_of_actors :search, 2
 ```
 
-Read more about [getting started with Flipper](https://flippercloud.io/docs) and [enabling features](https://flippercloud.io/docs/features).
+Read more about [getting started with Flipper](https://flippercloud.io/docs?utm_source=oss&utm_medium=readme&utm_campaign=getting_started) and [enabling features](https://flippercloud.io/docs/features?utm_source=oss&utm_medium=readme&utm_campaign=enabling_features).
 
 ## Flipper Cloud
 
-Like Flipper and want more? Check out [Flipper Cloud](https://www.flippercloud.io), which comes with:
+Like Flipper and want more? Check out [Flipper Cloud](https://www.flippercloud.io?utm_source=oss&utm_medium=readme&utm_campaign=check_out), which comes with:
 
-* **everything in one place** — no need to bounce around from different application UIs or IRB consoles.
-* **permissions** — grant access to everyone in your organization or lockdown each project to particular people.
-* **multiple environments** — production, staging, enterprise, by continent, whatever you need.
-* **personal environments** — no more rake scripts or manual enable/disable to get your laptop to look like production. Every developer gets a personal environment that inherits from production that they can override as they please ([read more](https://www.johnnunemaker.com/flipper-cloud-environments/)).
-* **no maintenance** — we'll keep the lights on for you. We also have handy webhooks for keeping your app in sync with Cloud, so **our availability won't affect yours**. All your feature flag reads are local to your app.
-* **audit history** — every feature change and who made it.
-* **rollbacks** — enable or disable a feature accidentally? No problem. You can roll back to any point in the audit history with a single click.
+- **multiple environments** — production, staging, per continent, whatever you need. Every environment inherits from production by default and every project comes with a [project overview page](https://blog.flippercloud.io/project-overview/) that shows each feature and its status in each environment.
+- **personal environments** — everyone on your team gets a personal environment (that inherits from production) which they can modify however they want without stepping on anyone else's toes.
+- **permissions** — grant access to everyone in your organization or lockdown each project to particular people. You can even limit access to a particular environment (like production) to specific people.
+- **audit history** — every feature change and who made it.
+- **rollbacks** — enable or disable a feature accidentally? No problem. You can roll back to any point in the audit history with a single click.
+- **maintenance** — we'll keep the lights on for you. We also have handy webhooks and background polling for keeping your app in sync with Cloud, so **our availability won't affect yours**. All your feature flag reads are local to your app.
+- **everything in one place** — no need to bounce around from different application UIs or IRB consoles.
 
-[![Flipper Cloud Screenshot](docs/images/flipper_cloud.png)](https://www.flippercloud.io)
+[![Flipper Cloud Screenshot](docs/images/flipper_cloud.png)](https://www.flippercloud.io?utm_source=oss&utm_medium=readme&utm_campaign=screenshot)
 
 Cloud is super simple to integrate with Rails ([demo app](https://github.com/fewerandfaster/flipper-rails-demo)), Sinatra or any other framework.
 
+We also have a [free plan](https://www.flippercloud.io?utm_source=oss&utm_medium=readme&utm_campaign=free_plan) that you can use forever.
+
 ## Contributing
 
 1. Fork it
@@ -95,17 +97,20 @@ Cloud is super simple to integrate with Rails ([demo app](https://github.com/few
 
 ## Releasing
 
-1. Update the version to be whatever it should be and commit.
-2. `script/release`
-3. Profit.
+1. Update the version in `lib/flipper/version.rb` and commit.
+2. Tag and push: `git tag v1.x.x && git push origin v1.x.x`
+3. GitHub Actions builds and publishes all gems to RubyGems automatically.
+4. Edit and publish the draft [GitHub Release](https://github.com/flippercloud/flipper/releases).
 
 ## Brought To You By
 
-| pic | @mention | area |
-|---|---|---|
-| ![@jnunemaker](https://avatars3.githubusercontent.com/u/235?s=64) | [@jnunemaker](https://github.com/jnunemaker) | most things |
-| ![@bkeepers](https://avatars3.githubusercontent.com/u/173?s=64) | [@bkeepers](https://github.com/bkeepers) | most things |
-| ![@dpep](https://avatars3.githubusercontent.com/u/918804?s=64) | [@dpep](https://github.com/dpep) | tbd |
-| ![@alexwheeler](https://avatars3.githubusercontent.com/u/3260042?s=64) | [@alexwheeler](https://github.com/alexwheeler) | api |
-| ![@thetimbanks](https://avatars1.githubusercontent.com/u/471801?s=64) | [@thetimbanks](https://github.com/thetimbanks) | ui |
-| ![@lazebny](https://avatars1.githubusercontent.com/u/6276766?s=64) | [@lazebny](https://github.com/lazebny) | docker |
+| pic                                                                    | @mention                                       | area        |
+| ---------------------------------------------------------------------- | ---------------------------------------------- | ----------- |
+| ![@jnunemaker](https://avatars3.githubusercontent.com/u/235?s=64)      | [@jnunemaker](https://github.com/jnunemaker)   | most things |
+| ![@bkeepers](https://avatars3.githubusercontent.com/u/173?s=64)        | [@bkeepers](https://github.com/bkeepers)       | most things |
+| ![@dpep](https://avatars3.githubusercontent.com/u/918804?s=64)         | [@dpep](https://github.com/dpep)               | tbd         |
+| ![@alexwheeler](https://avatars3.githubusercontent.com/u/3260042?s=64) | [@alexwheeler](https://github.com/alexwheeler) | api         |
+| ![@thetimbanks](https://avatars1.githubusercontent.com/u/471801?s=64)  | [@thetimbanks](https://github.com/thetimbanks) | ui          |
+| ![@lazebny](https://avatars1.githubusercontent.com/u/6276766?s=64)     | [@lazebny](https://github.com/lazebny)         | docker      |
+| ![@pagertree](https://avatars.githubusercontent.com/u/24941240?s=64)   | [@pagertree](https://github.com/pagertree)   | sponsor     |
+| ![@kdaigle](https://avatars.githubusercontent.com/u/2501?s=64)   | [@kdaigle](https://github.com/kdaigle)   | sponsor     |

data/Rakefile

@@ -27,7 +27,8 @@ end
 
 require 'rspec/core/rake_task'
 RSpec::Core::RakeTask.new(:spec) do |t|
-  t.rspec_opts = %w(--color --format documentation)
+  t.rspec_opts = %w(--color)
+  t.verbose = false
 end
 
 namespace :spec do
@@ -41,7 +42,6 @@ end
 Rake::TestTask.new do |t|
   t.libs = %w(lib test)
   t.pattern = 'test/**/*_test.rb'
-  t.options = '--documentation'
   t.warning = false
 end
 

data/benchmark/typecast_ips.rb

@@ -16,4 +16,12 @@ Benchmark.ips do |x|
   x.report("Typecast.to_float '1'") { Flipper::Typecast.to_float('1'.freeze) }
   x.report("Typecast.to_float 1.01") { Flipper::Typecast.to_float(1) }
   x.report("Typecast.to_float '1.01'") { Flipper::Typecast.to_float('1'.freeze) }
+
+  x.report("Typecast.to_number 1") { Flipper::Typecast.to_number(1) }
+  x.report("Typecast.to_number 1.1") { Flipper::Typecast.to_number(1.1) }
+  x.report("Typecast.to_number '1'") { Flipper::Typecast.to_number('1'.freeze) }
+  x.report("Typecast.to_number '1.1'") { Flipper::Typecast.to_number('1.1'.freeze) }
+  x.report("Typecast.to_number nil") { Flipper::Typecast.to_number(nil) }
+  time = Time.now
+  x.report("Typecast.to_number Time.now") { Flipper::Typecast.to_number(time) }
 end

data/examples/cloud/app.ru

@@ -0,0 +1,12 @@
+# Usage (from the repo root):
+#   env FLIPPER_CLOUD_TOKEN=<token> FLIPPER_CLOUD_SYNC_SECRET=<secret> bundle exec rackup examples/cloud/app.ru -p 9999
+#   http://localhost:9999/
+
+require 'bundler/setup'
+require 'flipper/cloud'
+
+Flipper.configure do |config|
+  config.default { Flipper::Cloud.new }
+end
+
+run Flipper::Cloud.app

data/examples/cloud/backoff_policy.rb

@@ -0,0 +1,13 @@
+# Just a simple example that shows how the backoff policy works.
+require 'bundler/setup'
+require 'flipper/cloud/telemetry/backoff_policy'
+
+intervals = []
+policy = Flipper::Cloud::Telemetry::BackoffPolicy.new
+
+5.times do |n|
+  intervals << policy.next_interval
+end
+
+pp intervals.map { |i| i.round(2) }
+puts "Total: #{intervals.sum.round(2)}ms (#{(intervals.sum/1_000.0).round(2)} sec)"

data/examples/cloud/basic.rb

@@ -0,0 +1,22 @@
+# Usage (from the repo root):
+# env FLIPPER_CLOUD_TOKEN=<token> bundle exec ruby examples/cloud/basic.rb
+
+require_relative "./cloud_setup"
+require 'bundler/setup'
+require 'flipper/cloud'
+
+Flipper[:stats].enable
+
+if Flipper[:stats].enabled?
+  puts 'Enabled!'
+else
+  puts 'Disabled!'
+end
+
+Flipper[:stats].disable
+
+if Flipper[:stats].enabled?
+  puts 'Enabled!'
+else
+  puts 'Disabled!'
+end

data/examples/cloud/cloud_setup.rb

@@ -0,0 +1,20 @@
+if ENV["FLIPPER_CLOUD_TOKEN"].nil? || ENV["FLIPPER_CLOUD_TOKEN"].empty?
+  warn "FLIPPER_CLOUD_TOKEN missing so skipping cloud example."
+  exit
+end
+
+matrix_key = if ENV["CI"]
+  suffix_rails = ENV["RAILS_VERSION"].split(".").take(2).join
+  suffix_ruby = RUBY_VERSION.split(".").take(2).join
+  "FLIPPER_CLOUD_TOKEN_#{suffix_ruby}_#{suffix_rails}"
+else
+  "FLIPPER_CLOUD_TOKEN"
+end
+
+if matrix_token = ENV[matrix_key]
+  puts "Using #{matrix_key} for FLIPPER_CLOUD_TOKEN"
+  ENV["FLIPPER_CLOUD_TOKEN"] = matrix_token
+else
+  warn "Missing #{matrix_key}. Go create an environment in flipper cloud and set #{matrix_key} to the adapter token for that environment in github actions secrets."
+  exit 1
+end

data/examples/cloud/forked.rb

@@ -0,0 +1,36 @@
+# Usage (from the repo root):
+# env FLIPPER_CLOUD_TOKEN=<token> bundle exec ruby examples/cloud/threaded.rb
+
+require_relative "./cloud_setup"
+require 'bundler/setup'
+require 'flipper/cloud'
+
+puts Process.pid
+
+# Make a call in the parent process so we can detect forking.
+Flipper.enabled?(:stats)
+
+pids = 2.times.map do |n|
+  fork {
+    # Check every second to see if the feature is enabled
+    threads = []
+    2.times do
+      threads << Thread.new do
+        loop do
+          sleep rand
+
+          if Flipper[:stats].enabled?
+            puts "#{Process.pid} #{Time.now.to_i} Enabled!"
+          else
+            puts "#{Process.pid} #{Time.now.to_i} Disabled!"
+          end
+        end
+      end
+    end
+    threads.map(&:join)
+  }
+end
+
+pids.each do |pid|
+  Process.waitpid pid, 0
+end

data/examples/cloud/import.rb

@@ -0,0 +1,17 @@
+# Usage (from the repo root):
+#   env FLIPPER_CLOUD_TOKEN=<token> bundle exec ruby examples/cloud/import.rb
+
+require_relative "./cloud_setup"
+require 'bundler/setup'
+require 'flipper'
+require 'flipper/cloud'
+
+Flipper.enable(:test)
+Flipper.enable(:search)
+Flipper.enable_actor(:stats, Flipper::Actor.new("jnunemaker"))
+Flipper.enable_percentage_of_time(:logging, 5)
+
+cloud = Flipper::Cloud.new
+
+# makes cloud identical to memory flipper
+cloud.import(Flipper)

data/examples/cloud/poll_interval/README.md

@@ -0,0 +1,111 @@
+# Poll Interval Dynamic Adjustment Demo
+
+This demo shows how the Flipper poller dynamically adjusts its polling interval based on the `poll-interval` header from the server, and how it responds to the `poll-shutdown` header.
+
+## Files
+
+- `server.rb` - Test server that responds with configurable headers
+- `client.rb` - Client that polls the server and logs interval changes
+- `README.md` - This file
+
+## How to Run
+
+### Terminal 1: Start the Server
+
+```bash
+bundle exec ruby examples/cloud/poll_interval/server.rb
+```
+
+The server will start on http://localhost:3000 and show a prompt where you can control what headers to send.
+
+### Terminal 2: Start the Client
+
+```bash
+bundle exec ruby examples/cloud/poll_interval/client.rb
+```
+
+The client will start polling the server every 10 seconds (the minimum) and log all activity.
+
+## Testing Scenarios
+
+### 1. Change Poll Interval
+
+In the **server terminal**, type a number to set the poll interval:
+
+```
+> 20
+```
+
+In the **client terminal**, you'll see:
+
+```
+[HH:MM:SS] WARN: ⚠️  INTERVAL CHANGED: 10.0s → 20.0s
+```
+
+The client will now poll every 20 seconds instead of 10.
+
+### 2. Try an Invalid Interval (Below Minimum)
+
+In the **server terminal**:
+
+```
+> 5
+```
+
+In the **client terminal**, you'll see a warning:
+
+```
+Flipper::Cloud poll interval must be greater than or equal to 10 but was 5.0. Setting interval to 10.
+```
+
+The interval will remain at 10 seconds (the minimum).
+
+### 3. Trigger Shutdown
+
+In the **server terminal**:
+
+```
+> shutdown
+```
+
+In the **client terminal**, you'll see:
+
+```
+[HH:MM:SS] WARN: Shutdown requested by server via poll-shutdown header
+[HH:MM:SS] WARN: Poller stopped
+[HH:MM:SS] WARN: Poller thread is no longer running
+```
+
+The poller will stop gracefully.
+
+### 4. Reset Headers
+
+In the **server terminal**:
+
+```
+> reset
+```
+
+The server will stop sending special headers. The client will continue with its current interval.
+
+## What You'll Learn
+
+- How `poll-interval` header dynamically adjusts polling frequency
+- How `poll-shutdown` header gracefully stops the poller
+- How minimum interval enforcement works (10 seconds minimum)
+- How the poller continues working even if the server returns errors
+- Real-time logging of poller events via instrumentation
+
+## Implementation Details
+
+The poller checks response headers in the `ensure` block of the `sync` method, which means:
+
+- Interval adjustments happen even if the sync fails with an error
+- Shutdown signals are never missed, even during failures
+- The poller is resilient to network issues
+
+The `interval=` setter handles all validation:
+
+- Type conversion via `Flipper::Typecast.to_float`
+- Minimum enforcement (10 seconds)
+- Warning messages for invalid values

data/examples/cloud/poll_interval/client.rb

@@ -0,0 +1,108 @@
+# Example showing poll interval being dynamically adjusted via poll-interval header
+#
+# Usage:
+#   1. Terminal 1: bundle exec ruby examples/cloud/poll_interval/server.rb
+#   2. Terminal 2: bundle exec ruby examples/cloud/poll_interval/client.rb
+
+require 'bundler/setup'
+require 'flipper'
+require 'flipper/adapters/http'
+require 'flipper/poller'
+require 'logger'
+
+# Setup logging to show what's happening
+logger = Logger.new(STDOUT)
+logger.level = Logger::INFO
+logger.formatter = proc do |severity, datetime, progname, msg|
+  "[#{datetime.strftime('%H:%M:%S')}] #{severity}: #{msg}\n"
+end
+
+# Create HTTP adapter pointing to localhost:3000
+http_adapter = Flipper::Adapters::Http.new(url: 'http://localhost:3000/flipper')
+
+# Create instrumenter to log poller events
+instrumenter = Module.new do
+  def self.instrument(name, payload = {})
+    case payload[:operation]
+    when :poll
+      logger.info "Polling remote adapter..."
+    when :shutdown_requested
+      logger.warn "Shutdown requested by server via poll-shutdown header"
+    when :stop
+      logger.warn "Poller stopped"
+    when :thread_start
+      logger.info "Poller thread started"
+    end
+
+    result = yield if block_given?
+
+    if payload[:operation] == :poll && result
+      logger.info "Poll completed successfully"
+    end
+
+    result
+  end
+
+  def self.logger=(l)
+    @logger = l
+  end
+
+  def self.logger
+    @logger
+  end
+end
+instrumenter.logger = logger
+
+# Create poller with custom instrumenter and short initial interval
+poller = Flipper::Poller.new(
+  remote_adapter: http_adapter,
+  interval: 5,  # Start with 5 second interval (will be enforced to 10 minimum)
+  instrumenter: instrumenter,
+  start_automatically: false,
+  shutdown_automatically: false
+)
+
+logger.info "Starting poller with interval: #{poller.interval} seconds"
+logger.info "Minimum allowed interval: #{Flipper::Poller::MINIMUM_POLL_INTERVAL} seconds"
+logger.info ""
+logger.info "Server can control polling via response headers:"
+logger.info "  - poll-interval: <seconds>  (adjust poll frequency)"
+logger.info "  - poll-shutdown: true       (stop polling)"
+logger.info ""
+
+# Track interval changes
+last_interval = poller.interval
+
+# Start the poller
+poller.start
+
+# Monitor for interval changes and log them
+logger.info "Monitoring poller... (Ctrl+C to exit)"
+logger.info ""
+
+begin
+  loop do
+    sleep 2
+
+    current_interval = poller.interval
+
+    # Highlight when it changes
+    if current_interval != last_interval
+      logger.warn "⚠️  INTERVAL CHANGED: #{last_interval}s → #{current_interval}s"
+      last_interval = current_interval
+    end
+
+    # Check if poller thread is still alive
+    unless poller.thread&.alive?
+      logger.warn "Poller thread is no longer running"
+      break
+    end
+  end
+rescue Interrupt
+  logger.info ""
+  logger.info "Interrupted by user"
+ensure
+  logger.info "Stopping poller..."
+  poller.stop
+  logger.info "Final interval: #{poller.interval} seconds"
+end

data/examples/cloud/poll_interval/server.rb

@@ -0,0 +1,98 @@
+# Simple test server for demonstrating poll interval changes
+#
+# Usage:
+#   1. Terminal 1: bundle exec ruby examples/cloud/poll_interval/server.rb
+#   2. Terminal 2: bundle exec ruby examples/cloud/poll_interval/client.rb
+#
+# Commands in server terminal:
+#   - Type a number (e.g., "15") to set poll-interval header to that value
+#   - Type "shutdown" to send poll-shutdown: true header
+#   - Type "reset" to stop sending special headers
+#   - Ctrl+C to exit
+
+require 'bundler/setup'
+require 'webrick'
+require 'json'
+
+# State for what headers to send
+$poll_interval = nil
+$poll_shutdown = false
+
+# Thread to handle user input for changing headers
+input_thread = Thread.new do
+  puts ""
+  puts "=" * 60
+  puts "Server Controls:"
+  puts "  Type a number (e.g., '15') to set poll-interval"
+  puts "  Type 'shutdown' to trigger poll shutdown"
+  puts "  Type 'reset' to clear all special headers"
+  puts "=" * 60
+  puts ""
+
+  loop do
+    print "> "
+    input = gets&.chomp
+    break if input.nil?
+
+    case input
+    when /^\d+$/
+      $poll_interval = input.to_i
+      puts "✓ Will send poll-interval: #{$poll_interval}"
+    when "shutdown"
+      $poll_shutdown = true
+      puts "✓ Will send poll-shutdown: true"
+    when "reset"
+      $poll_interval = nil
+      $poll_shutdown = false
+      puts "✓ Cleared all special headers"
+    else
+      puts "Unknown command. Use a number, 'shutdown', or 'reset'"
+    end
+  end
+end
+
+# Setup WEBrick server
+server = WEBrick::HTTPServer.new(
+  Port: 3000,
+  Logger: WEBrick::Log.new($stdout, WEBrick::Log::INFO),
+  AccessLog: [[
+    $stdout,
+    WEBrick::AccessLog::COMMON_LOG_FORMAT
+  ]]
+)
+
+# Handle GET /flipper/features
+server.mount_proc '/flipper/features' do |req, res|
+  # Build response
+  response_body = {
+    features: []
+  }
+
+  res.status = 200
+  res['Content-Type'] = 'application/json'
+  res.body = JSON.generate(response_body)
+
+  # Add special headers if configured
+  if $poll_interval
+    res['poll-interval'] = $poll_interval.to_s
+    puts "→ Sent poll-interval: #{$poll_interval}"
+  end
+
+  if $poll_shutdown
+    res['poll-shutdown'] = 'true'
+    puts "→ Sent poll-shutdown: true"
+  end
+end
+
+# Trap interrupt and shutdown gracefully
+trap('INT') do
+  puts "\nShutting down server..."
+  server.shutdown
+  input_thread.kill
+end
+
+puts "Server starting on http://localhost:3000"
+puts "Endpoint: GET http://localhost:3000/flipper/features"
+puts ""
+
+server.start

data/examples/cloud/threaded.rb

@@ -0,0 +1,33 @@
+# Usage (from the repo root):
+# env FLIPPER_CLOUD_TOKEN=<token> bundle exec ruby examples/cloud/threaded.rb
+
+require_relative "./cloud_setup"
+require 'bundler/setup'
+require 'flipper/cloud'
+
+puts Process.pid
+
+Flipper.configure do |config|
+  config.default {
+    Flipper::Cloud.new(
+      local_adapter: config.adapter,
+      debug_output: STDOUT,
+    )
+  }
+end
+
+# You might want to do this at some point to see different results:
+# Flipper.enable(:search)
+# Flipper.disable(:stats)
+
+# Check every second to see if the feature is enabled
+5.times.map { |i|
+  Thread.new {
+    loop do
+      sleep rand
+
+      Flipper.enabled?(:stats)
+      Flipper.enabled?(:search)
+    end
+  }
+}.each(&:join)

data/examples/dsl.rb

@@ -47,20 +47,6 @@ puts "stats.enabled?: #{stats.enabled?}"
 puts "stats.enabled? person: #{stats.enabled? person}"
 puts
 
-# get an instance of the percentage of time type set to 5
-puts Flipper.time(5).inspect
-
-# get an instance of the percentage of actors type set to 15
-puts Flipper.actors(15).inspect
-
-# get an instance of an actor using an object that responds to flipper_id
-responds_to_flipper_id = Struct.new(:flipper_id).new(10)
-puts Flipper.actor(responds_to_flipper_id).inspect
-
-# get an instance of an actor using an object
-actor = Struct.new(:flipper_id).new(22)
-puts Flipper.actor(actor).inspect
-
 # register a top level group
 admins = Flipper.register(:admins) { |actor|
   actor.respond_to?(:admin?) && actor.admin?