flipper 0.7.0.beta6 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fbc4122278d701b4a97828cb9fbfe1f66328ff48
-  data.tar.gz: 87a4ad6f4b5da8b4a3c9d61fae53231a156f10c3
+  metadata.gz: 03893918187a23f82ff77ec7c88587be111ffb7f
+  data.tar.gz: 6c4ebaabd49273abaeeb9803266cc2d81aff58d5
 SHA512:
-  metadata.gz: 0f870e8966135ca803eb0aabe97dce999cd710db15720d67374a8b81e1fc13f608e7ba0ec082b079075b6b8c2a6509bc37db5b8b5af1e27f758b5de4a31de7db
-  data.tar.gz: b5f89715dcb5e10989f1e2fd2f63cc19d62854011d1f08aee29f1d3e7cc17d7280638c12d98576dcf099f5960cbc0f6e25d7f3868fac0a942f6259d6a8eb92a3
+  metadata.gz: d8d36b6752af084d8e3e087bedfe02d2074d8d1846b602a0a50b644deadf4bfd1f95b9299975c43b464e522a60137dc4513f9161597565496fd89e9984a36b02
+  data.tar.gz: 5149b9bba88fd4f5cc3de1893517f22d3cf02f3427df4d67efde604891233f2a37200696f77ac801421c1082d77ae99cd8ca8ed51f4547281e2946448b3453e3

data/Changelog.md

@@ -1,4 +1,4 @@
-## master (0.7)
+## 0.7
 
 * Added Flipper.groups and Flipper.group_names
 * Changed percentage_of_random to percentage_of_time

data/README.md

@@ -72,6 +72,7 @@ Of course there are more [examples for you to peruse](examples/). You could also
 * [Instrumentation](docs/Instrumentation.md) - ActiveSupport::Notifications, Statsd and Metriks
 * [Optimization](docs/Optimization.md) - Memoization middleware
 * [Web Interface](docs/ui/README.md) - Point and click...
+* [Caveats](docs/Caveats.md) - Flipper beware! (see what I did there)
 
 ## Contributing
 

data/docs/Caveats.md

@@ -0,0 +1,4 @@
+# Caveats
+
+1. The [individual actor gate](https://github.com/jnunemaker/flipper/blob/master/docs/Gates.md#3-individual-actor) is typically not designed for hundreds or thousands of actors to be enabled. This is an explicit choice to make it easier to batch load data from the adapters instead of performing individual checks for actors over and over. If you need to enable something for more than 20 individual people, I would recommend using a [group](https://github.com/jnunemaker/flipper/blob/master/docs/Gates.md#2-group).
+2. The disable method exists only to clear something that is enabled. If the thing you are disabling is not enabled, the disable is pointless. This means that if you enable one group an actor is in and disable another group, the feature will be enabled for the actor. ([related issue](https://github.com/jnunemaker/flipper/issues/71))

data/examples/percentage_of_actors_enabled_check.rb

@@ -0,0 +1,39 @@
+require File.expand_path('../example_setup', __FILE__)
+
+require 'flipper'
+require 'flipper/adapters/memory'
+
+adapter = Flipper::Adapters::Memory.new
+flipper = Flipper.new(adapter)
+
+# Some class that represents what will be trying to do something
+class User
+  attr_reader :id
+
+  def initialize(id)
+    @id = id
+  end
+
+  # Must respond to flipper_id
+  alias_method :flipper_id, :id
+end
+
+# checking a bunch
+gate = Flipper::Gates::PercentageOfActors.new
+feature_name = "data_migration"
+percentage_enabled = 10
+total = 20_000
+enabled = []
+
+(1..total).each do |id|
+  user = User.new(id)
+  if gate.open?(user, percentage_enabled, feature_name: feature_name)
+    enabled << user
+  end
+end
+
+p actual: enabled.size, expected: total * (percentage_enabled * 0.01)
+
+# checking one
+user = User.new(1)
+p user_1_enabled: Flipper::Gates::PercentageOfActors.new.open?(user, percentage_enabled, feature_name: feature_name)

data/lib/flipper/version.rb

@@ -1,3 +1,3 @@
 module Flipper
-  VERSION = "0.7.0.beta6"
+  VERSION = "0.7.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: flipper
 version: !ruby/object:Gem::Version
-  version: 0.7.0.beta6
+  version: 0.7.0
 platform: ruby
 authors:
 - John Nunemaker
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-05-13 00:00:00.000000000 Z
+date: 2015-06-21 00:00:00.000000000 Z
 dependencies: []
 description: Feature flipper is the act of enabling/disabling features in your application,
   ideally without re-deploying or changing anything in your code base. Flipper makes
@@ -25,6 +25,7 @@ files:
 - README.md
 - Rakefile
 - docs/Adapters.md
+- docs/Caveats.md
 - docs/Gates.md
 - docs/Instrumentation.md
 - docs/Optimization.md
@@ -35,6 +36,7 @@ files:
 - examples/individual_actor.rb
 - examples/instrumentation.rb
 - examples/percentage_of_actors.rb
+- examples/percentage_of_actors_enabled_check.rb
 - examples/percentage_of_time.rb
 - flipper.gemspec
 - lib/flipper.rb
@@ -124,9 +126,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.2.3