simple_feature_flags 1.4.0 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ec2b8373585148b5a35440da4b652b80939c9a206e8fcd9a77d352d4c73a291
-  data.tar.gz: 62ee0f5e72b494c7d9e8af4edace2d46bc7345bcc1dc7988e4f576b0b7d16e8a
+  metadata.gz: a31152f17215cd2905c721f27217aaa187c006345a5c811ca6194ae36fabef89
+  data.tar.gz: 9df276339edd478dc86e0ce590518c21ebc115f63899fe493ad328d11180ae5d
 SHA512:
-  metadata.gz: fa1df864803d24acba2331e3dc1d8da16dca764c3d321208f712cc9d34291be9f1742ec200d7ab4f4e87b7a0e2d035a79573189319b34867053c98332c1b1df0
-  data.tar.gz: 92400c60aef05bf3ad039123dd830af4e3b0c00a34e01d7d8ef72b905f67dc7fa0fd8e30b215c563a656a7ac545b0df0be0ea59233c3d6d3373677a72f5ae7d0
+  metadata.gz: 8b02dde3a77725c376a0375d8c291e308ee5ce8e7b885e2e051a08e8205eb8407b64e460e43ee6a404a504dd9f9bf1248f387a6764870ec444c3c44f0b423f71
+  data.tar.gz: f3f1cdecad7872b6c10c3a1e086f773844e04bf3869fc07d6661fef81dcf33fdb78f2d731318b3f6410cc6ca039fb10625bedb4ffc854f865b0ccf3cfe98f1b6

data/Gemfile

@@ -12,5 +12,5 @@ gem 'redis', '~> 5.3' # redis client
 gem 'redis-namespace', '~> 1.11' # namespaces for redis
 gem 'rubocop-espago', '~> 1.1' # ruby linter
 gem 'rubocop-sorbet', '~> 0.10' # rubocop for sorbet
-gem 'sorbet', '>= 0.5' # static typechecker
-gem 'tapioca', '> 0.13' # RBI generator for sorbet
+gem 'sorbet', '~> 0.5' # static typechecker
+gem 'tapioca', '~> 0.17' # RBI generator for sorbet

data/Gemfile.lock

@@ -1,32 +1,37 @@
 PATH
   remote: .
   specs:
-    simple_feature_flags (1.4.0)
+    simple_feature_flags (1.4.1)
       sorbet-runtime (> 0.5)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.3)
+    benchmark (0.4.1)
     byebug (11.1.3)
     connection_pool (2.4.1)
-    erubi (1.13.0)
+    erubi (1.13.1)
     json (2.10.2)
     language_server-protocol (3.17.0.4)
     lint_roller (1.1.0)
+    logger (1.7.0)
     minitest (5.25.1)
     netrc (0.11.0)
     parallel (1.27.0)
     parser (3.3.8.0)
       ast (~> 2.4.1)
       racc
-    prism (1.2.0)
+    prism (1.4.0)
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.2.1)
-    rbi (0.2.1)
+    rbi (0.3.6)
       prism (~> 1.0)
-      sorbet-runtime (>= 0.5.9204)
+      rbs (>= 3.4.4)
+    rbs (4.0.0.dev.4)
+      logger
+      prism (>= 1.3.0)
     redis (5.3.0)
       redis-client (>= 0.22.0)
     redis-client (0.22.2)
@@ -34,6 +39,8 @@ GEM
     redis-namespace (1.11.0)
       redis (>= 4)
     regexp_parser (2.10.0)
+    require-hooks (0.2.2)
+    rexml (3.4.1)
     rubocop (1.74.0)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
@@ -52,27 +59,32 @@ GEM
     rubocop-sorbet (0.10.0)
       rubocop (>= 1)
     ruby-progressbar (1.13.0)
-    sorbet (0.5.11647)
-      sorbet-static (= 0.5.11647)
-    sorbet-runtime (0.5.11647)
-    sorbet-static (0.5.11647-aarch64-linux)
-    sorbet-static (0.5.11647-universal-darwin)
-    sorbet-static (0.5.11647-x86_64-linux)
-    sorbet-static-and-runtime (0.5.11647)
-      sorbet (= 0.5.11647)
-      sorbet-runtime (= 0.5.11647)
-    spoom (1.5.0)
+    sorbet (0.5.12210)
+      sorbet-static (= 0.5.12210)
+    sorbet-runtime (0.5.12210)
+    sorbet-static (0.5.12210-aarch64-linux)
+    sorbet-static (0.5.12210-universal-darwin)
+    sorbet-static (0.5.12210-x86_64-linux)
+    sorbet-static-and-runtime (0.5.12210)
+      sorbet (= 0.5.12210)
+      sorbet-runtime (= 0.5.12210)
+    spoom (1.7.4)
       erubi (>= 1.10.0)
       prism (>= 0.28.0)
+      rbi (>= 0.3.3)
+      rbs (>= 4.0.0.dev.4)
+      rexml (>= 3.2.6)
       sorbet-static-and-runtime (>= 0.5.10187)
       thor (>= 0.19.2)
-    tapioca (0.16.4)
+    tapioca (0.17.5)
+      benchmark
       bundler (>= 2.2.25)
       netrc (>= 0.11.0)
       parallel (>= 1.21.0)
-      rbi (~> 0.2)
+      rbi (>= 0.3.1)
+      require-hooks (>= 0.2.2)
       sorbet-static-and-runtime (>= 0.5.11087)
-      spoom (>= 1.2.0)
+      spoom (>= 1.7.0)
       thor (>= 1.2.0)
       yard-sorbet
     thor (1.3.2)
@@ -98,8 +110,8 @@ DEPENDENCIES
   rubocop-espago (~> 1.1)
   rubocop-sorbet (~> 0.10)
   simple_feature_flags!
-  sorbet (>= 0.5)
-  tapioca (> 0.13)
+  sorbet (~> 0.5)
+  tapioca (~> 0.17)
 
 BUNDLED WITH
    2.6.8

data/README.md

@@ -151,6 +151,21 @@ FEATURE_FLAGS.inactive_globally?(:feature_name) #=> false
 FEATURE_FLAGS.inactive_partially?(:feature_name) #=> true
 ```
 
+#### Activate a feature in a block
+
+Activates a feature for the code in the given block
+then restores the original state of the feature.
+
+```ruby
+FEATURE_FLAGS.active?(:feature_name) #=> false
+
+FEATURE_FLAGS.do_activate(:feature_name) do
+  FEATURE_FLAGS.active?(:feature_name) #=> true
+end
+
+FEATURE_FLAGS.active?(:feature_name) #=> false
+```
+
 #### Deactivate a feature
 
 Deactivates a feature in the global scope
@@ -165,6 +180,21 @@ FEATURE_FLAGS.active?(:feature_name) #=> false
 FEATURE_FLAGS.inactive?(:feature_name) #=> true
 ```
 
+#### Deactivate a feature in a block
+
+Activates a feature for the code in the given block
+then restores the original state of the feature.
+
+```ruby
+FEATURE_FLAGS.active?(:feature_name) #=> true
+
+FEATURE_FLAGS.do_deactivate(:feature_name) do
+  FEATURE_FLAGS.active?(:feature_name) #=> false
+end
+
+FEATURE_FLAGS.active?(:feature_name) #=> true
+```
+
 #### Activate a feature for a particular record/object
 
 ```ruby

data/lib/simple_feature_flags/base_storage.rb

@@ -5,11 +5,9 @@ require 'yaml'
 
 module SimpleFeatureFlags
   # Abstract class for all storage adapters.
+  # @abstract
   class BaseStorage
     extend T::Sig
-    extend T::Helpers
-
-    abstract!
 
     # Path to the file with feature flags
     sig { abstract.returns(String) }
@@ -245,6 +243,18 @@ module SimpleFeatureFlags
     sig { abstract.params(feature: T.any(Symbol, String)).returns(T::Boolean) }
     def deactivate(feature); end
 
+    # Deactivates the flag, calls the block and restores the previous state of the flag.
+    sig do
+      abstract
+        .type_parameters(:R)
+        .params(
+          feature: T.any(Symbol, String),
+          block:   T.proc.returns(T.type_parameter(:R)),
+        )
+        .returns(T.type_parameter(:R))
+    end
+    def do_deactivate(feature, &block); end
+
     # Returns a hash of Objects that the given flag is turned on for.
     # The keys are class/model names, values are arrays of IDs of instances/records.
     #
@@ -308,13 +318,13 @@ module SimpleFeatureFlags
 
     private
 
-    sig { params(objects: T::Array[Object], object_id_method: Symbol).returns(T::Hash[String, T::Array[Object]]) }
+    #: (Array[Object] objects, ?object_id_method: Symbol) -> Hash[String, Array[Object]]
     def objects_to_hash(objects, object_id_method: CONFIG.default_id_method)
       objects.group_by { |ob| ob.class.to_s }
              .transform_values { |arr| arr.map(&object_id_method) }
     end
 
-    sig { void }
+    #: -> void
     def import_flags_from_file
       changes = YAML.load_file(file)
       changes = { mandatory: [], remove: [] } unless changes.is_a? ::Hash

data/lib/simple_feature_flags/cli/command/generate.rb

@@ -10,17 +10,17 @@ module SimpleFeatureFlags
       class Generate
         extend T::Sig
 
-        CONFIG_FILE = T.let('simple_feature_flags.yml', String)
+        CONFIG_FILE = 'simple_feature_flags.yml' #: String
 
-        sig { returns(Options) }
+        #: Options
         attr_reader :options
 
-        sig { params(options: Options).void }
+        #: (Options options) -> void
         def initialize(options)
           @options = options
         end
 
-        sig { void }
+        #: -> void
         def run
           if options.rails
             generate_for_rails
@@ -36,7 +36,7 @@ module SimpleFeatureFlags
 
         private
 
-        sig { void }
+        #: -> void
         def generate_for_rails
           ::FileUtils.cp_r example_config_dir, destination_dir
 
@@ -70,26 +70,20 @@ module SimpleFeatureFlags
           system 'bundle'
         end
 
-        sig do
-          params(
-            file_path: String,
-            regexp:    Regexp,
-            block:     T.proc.params(arg0: String).returns(String),
-          ).void
-        end
+        #: (String file_path, Regexp regexp) { (String arg0) -> String } -> void
         def file_gsub(file_path, regexp, &block)
           new_content = File.read(file_path).gsub(regexp, &block)
           File.binwrite(file_path, new_content)
         end
 
-        sig { params(file_path: String, line: String).void }
+        #: (String file_path, String line) -> void
         def file_append(file_path, line)
           new_content = File.read(file_path)
           new_content = "#{new_content}\n#{line}\n"
           File.binwrite(file_path, new_content)
         end
 
-        sig { params(dir: String, embed_level: Integer).void }
+        #: (String dir, ?Integer embed_level) -> void
         def print_dir_tree(dir, embed_level = 0)
           padding = ' ' * (embed_level * 2)
 
@@ -105,32 +99,32 @@ module SimpleFeatureFlags
           end
         end
 
-        sig { returns String }
+        #: -> String
         def initializer_file
           ::File.join(destination_dir, 'config', 'initializers', 'simple_feature_flags.rb')
         end
 
-        sig { returns String }
+        #: -> String
         def gemfile
           ::File.join(destination_dir, 'Gemfile')
         end
 
-        sig { returns String }
+        #: -> String
         def routes_rb
           ::File.join(destination_dir, 'config', 'routes.rb')
         end
 
-        sig { returns String }
+        #: -> String
         def example_config_dir
           ::File.join(::File.expand_path(__dir__), '..', '..', '..', 'example_files', 'config')
         end
 
-        sig { returns String }
+        #: -> String
         def example_config_file
           ::File.join(example_config_dir, CONFIG_FILE)
         end
 
-        sig { returns String }
+        #: -> String
         def destination_dir
           if options.rails && !::Dir.new(::Dir.pwd).entries.include?('config')
             raise IncorrectWorkingDirectoryError,
@@ -140,7 +134,7 @@ module SimpleFeatureFlags
           ::Dir.pwd
         end
 
-        sig { returns String }
+        #: -> String
         def destination_file
           @destination_file ||= ::File.join(destination_dir, CONFIG_FILE)
         end

data/lib/simple_feature_flags/cli/options.rb

@@ -9,23 +9,23 @@ module SimpleFeatureFlags
     class Options
       extend T::Sig
 
-      sig { returns(OptionParser) }
+      #: OptionParser
       attr_reader :opt_parser
 
-      sig { returns(T::Boolean) }
+      #: bool
       attr_reader :generate
 
-      sig { returns(T::Boolean) }
+      #: bool
       attr_reader :rails
 
-      sig { returns(T::Boolean) }
+      #: bool
       attr_reader :ui
 
-      sig { params(args: T::Array[String]).void }
+      #: (Array[String] args) -> void
       def initialize(args)
-        @rails = T.let(true, T::Boolean)
-        @ui = T.let(false, T::Boolean)
-        @generate = T.let(false, T::Boolean)
+        @rails = true #: bool
+        @ui = false #: bool
+        @generate = false #: bool
 
         @opt_parser = ::OptionParser.new do |opts|
           opts.banner = 'Usage: simple_feature_flags [options]'

data/lib/simple_feature_flags/cli/runner.rb

@@ -7,15 +7,15 @@ module SimpleFeatureFlags
     class Runner
       extend T::Sig
 
-      sig { returns(Options) }
+      #: Options
       attr_reader :options
 
-      sig { params(args: T::Array[String]).void }
+      #: (?Array[String] args) -> void
       def initialize(args = ARGV)
         @options = Options.new(args)
       end
 
-      sig { void }
+      #: -> void
       def run
         command_class =
           if @options.generate

data/lib/simple_feature_flags/configuration.rb

@@ -6,10 +6,10 @@ module SimpleFeatureFlags
   class Configuration
     extend T::Sig
 
-    sig { returns(Symbol) }
+    #: Symbol
     attr_accessor :default_id_method
 
-    sig { void }
+    #: -> void
     def initialize
       @default_id_method = :id
     end