rails-feature-flip 0.1.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 534e43865643944f6c7758b89e0788d25a92afbc73097bbaf924cebcdc970515
-  data.tar.gz: a0bbde657ff531b12cda61e103caf8f1025e3b4d3befe54c57cd543f79c6a3ea
+  metadata.gz: 31fa37d8001db49630a6166dc989f7df70cd2e93bcd2d808a64ba2891a8ddf25
+  data.tar.gz: 00c2471a2ce557a8f3c4f82213ad53e277cc75a92469f575ec9ae50881fc9ea0
 SHA512:
-  metadata.gz: bbaeb831c8f33edf473efc6784d72177e47276f9201340847089651b5f637db38f233e68305f88512abab0a38a8e7e0314b2eb1443d61f3be514e8b34f589702
-  data.tar.gz: a8b975432fe88b54367100991fdc1ddb94bb12aee27cea3ab2011110cde0479c30a7ccd441123ba585de81b25751be6b425b63350318a715bad5a3b9670704a5
+  metadata.gz: 15ccb56aab858a4c5b4f40076c20b922561b6f4b071e9af57fcb719507b7e48bc5905ef88fc7c49c5aa61a295de8f5b6f764502f9e33899b4a86ea70fb23b0f3
+  data.tar.gz: fb2cb9a153aac70b04741afcf91f86952ecd53e02a64b09793fef493df90b0e89ab458c5eab725979630d3c87c05b1be1e2fc8df3c5b257b7622bad7b804048f

data/.rubocop.yml

@@ -0,0 +1,25 @@
+inherit_mode:
+  merge:
+    - Exclude
+
+plugins:
+  - rubocop-minitest
+  - rubocop-rake
+
+AllCops:
+  TargetRubyVersion: 3.0
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - test/tmp/**/*
+    - '*.md'
+
+Style/Documentation:
+  Enabled: false
+
+Layout/LineLength:
+  Max: 120
+
+Metrics/ClassLength:
+  Exclude:
+    - test/**/*

data/CHANGELOG.md

@@ -1,9 +1,43 @@
 ## [Unreleased]
 
-## [0.1.0] - 2024-02-23
+## [1.0.0] - 2026-03-29
+
+### Breaking Changes
+
+- Requires Ruby >= 3.0 (was >= 2.6)
+- Requires Rails >= 7.0 (was >= 5.0)
+- Generated feature classes now use ActiveModel::Attributes instead of hand-rolled attr_reader/initialize
+
+### Bug Fixes
+
+- Fix generator namespace typo (`rails_feature_flag` → `rails_feature_flip`) in README, USAGE, and install message
+- Fix `all.rb` loader using fragile relative path — now uses `File.expand_path(__dir__)`
+- Fix singular/plural mismatch in install generator (`config/feature` → `config/features`)
+- Fix install generator using `File.read` with CWD-relative path instead of destination root
+- Use idiomatic `empty_directory` in install generator instead of `Dir.mkdir`
+
+### New Features
 
-- start of the gem
+- **ActiveModel::Attributes**: Generated features include type casting, built-in defaults, and attribute introspection
+- **Default values**: `--defaults enabled:false amount:100` flag on the feature generator
+- **Auto-enabled attribute**: `enabled:boolean` is added by default (skip with `--no-enabled`)
+- **Feature namespacing**: `Billing::InvoicePdf` generates nested modules in subdirectories
+- **Controller/view helpers**: `feature_enabled?(:name)` and `require_feature :name` via Railtie
+- **Test helper**: `with_feature(:name, enabled: true) { ... }` for overriding features in tests
+- **Feature registry**: `RailsFeatureFlip::Registry.all`, `.names`, `.find(:name)`
+- **Runtime toggles**: `RailsFeatureFlip.enable(:name)`, `.disable(:name)`, `.toggle(:name)`
+- **Rake task**: `rake features` lists all registered features with status and attributes
+
+### Quality
+
+- Added Rubocop with rubocop-minitest and rubocop-rake
+- Added 40 tests with 152 assertions covering generators, helpers, registry, and toggles
+- CI matrix expanded to Ruby 3.0, 3.1, 3.2, 3.3, 3.4, 4.0
 
 ## [0.1.1] - 2024-02-23
 
-- initial release on rubygems.org
+- Initial release on rubygems.org
+
+## [0.1.0] - 2024-02-23
+
+- Start of the gem

data/CODE_OF_CONDUCT.md

@@ -39,7 +39,7 @@ This Code of Conduct applies within all community spaces, and also applies when
 
 ## Enforcement
 
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at ben@byder.io. All complaints will be reviewed and investigated promptly and fairly.
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at ben@bdeutscher.org. All complaints will be reviewed and investigated promptly and fairly.
 
 All community leaders are obligated to respect the privacy and security of the reporter of any incident.
 

data/README.md

@@ -1,8 +1,38 @@
 # RailsFeatureFlip
 
-TODO: Delete this and the text below, and describe your gem
+This gem provides a generator to create feature flip config classes that can be used to define what features can be used in what stage and/or how they should behave in what stage.
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/rails/feature/flip`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+## Example
+
+    bin/rails generate rails_feature_flip:feature Thing enabled:boolean foo bar
+
+    This will create:
+        config/features/thing_feature.rb
+
+    Then in application.rb:
+        config.x.features.help_center = Features::Thing.new(enabled: false, foo: 'bar', bar: 'baz')
+    With that you can use:
+        App.features.thing.enabled?
+        # => false
+        App.features.thing.foo
+        # => bar
+
+The main benefit over the default `config.x` namespace is the readability in code whereas 
+
+    if App.features.thing.enabled?
+      # do something with feature "thing"
+    end
+
+is more readable than
+
+    if Rails.env.development?
+      # do something with feature "thing" in development stage
+    elsif Rails.env.test?
+      # do something with feature "thing" in test stage
+    else
+      # do something with feature "thing" in production stage
+    end
 
 ## Installation
 

data/Rakefile

@@ -1,12 +1,15 @@
 # frozen_string_literal: true
 
-require "bundler/gem_tasks"
-require "rake/testtask"
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'rubocop/rake_task'
 
 Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/test_*.rb"]
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/test_*.rb']
 end
 
-task default: :test
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/lib/generators/rails_feature_flip/feature/USAGE

@@ -1,16 +1,28 @@
 Description:
-    Generates a feature file to manage a feature of the app
+    Generates a feature file to manage a feature of the app.
+    Uses ActiveModel::Attributes for type casting and defaults.
 
 Example:
-    bin/rails generate rails_feature_flag:feature Thing enabled:boolean foo bar
+    bin/rails generate rails_feature_flip:feature Thing max_results:integer
+
+    With default values:
+    bin/rails generate rails_feature_flip:feature Thing max_results:integer --defaults enabled:false max_results:10
+
+    Namespaced feature (creates config/features/billing/invoice_pdf_feature.rb):
+    bin/rails generate rails_feature_flip:feature Billing::InvoicePdf max:integer
+
+    Without the auto-added enabled attribute:
+    bin/rails generate rails_feature_flip:feature Thing foo --no-enabled
 
     This will create:
         config/features/thing_feature.rb
 
     Then in application.rb:
-        config.x.features.help_center = Features::Thing.new(enabled: false, foo: 'bar', bar: 'baz')
+        config.x.features.thing = Features::ThingFeature.new(enabled: true, max_results: 10)
     With that you can use:
         App.features.thing.enabled?
-        # => false
-        App.features.thing.foo
-        # => bar
+        # => true
+        App.features.thing.max_results
+        # => 10
+
+    Supported types: boolean, integer, float, string (default)

data/lib/generators/rails_feature_flip/feature/feature_generator.rb

@@ -6,18 +6,68 @@ module RailsFeatureFlip
     class FeatureGenerator < Rails::Generators::NamedBase
       source_root File.expand_path('templates', __dir__)
 
-      argument :attributes, type: :array, default: [], banner: 'config_key[:boolean] (:boolean will generate a ? method)'
+      argument :attributes, type: :array, default: [],
+                            banner: 'config_key[:type] (supported types: boolean, integer, float, string)'
+
+      class_option :defaults, type: :hash, default: {},
+                              desc: 'Default values for attributes (e.g. --defaults enabled:false amount:100)'
+      class_option :enabled, type: :boolean, default: true,
+                             desc: 'Add enabled:boolean attribute (use --no-enabled to skip)'
 
       # Generate a feature
       def generate_feature
         @name = name.underscore.downcase
-        @klass_name = class_name
-        @attributes = attributes
-        @boolean_attributes = @attributes.collect { |attr| attr if attr.type == :boolean }.compact
-        feature_file_path = Rails.root.join('config', 'features')
-        feature_path = feature_file_path.join("#{@name}_feature.rb")
+        parts = class_name.split('::')
+        @namespace_parts = parts[0..-2]
+        @feature_class_name = "#{parts.last}Feature"
+        @attributes = prepend_enabled_attribute(attributes)
+        @boolean_attributes = @attributes.select { |attr| attr.type == :boolean }
+        @defaults = options[:defaults]
+
+        template('feature.erb', "config/features/#{@name}_feature.rb")
+      end
+
+      private
+
+      # Prepends enabled:boolean unless --no-enabled or already specified
+      def prepend_enabled_attribute(attrs)
+        return attrs unless options[:enabled]
+        return attrs if attrs.any? { |attr| attr.name == 'enabled' }
+
+        enabled_attr = Rails::Generators::GeneratedAttribute.parse('enabled:boolean')
+        [enabled_attr] + attrs
+      end
+
+      # Renders an ActiveModel attribute declaration line
+      def attribute_declaration(attr)
+        type = activemodel_type(attr)
+        default = @defaults[attr.name]
+        parts = ["attribute :#{attr.name}, :#{type}"]
+        parts << "default: #{format_default(type, default)}" if default
+        parts.join(', ')
+      end
+
+      def activemodel_type(attr)
+        case attr.type.to_s
+        when 'boolean' then 'boolean'
+        when 'integer' then 'integer'
+        when 'float' then 'float'
+        else 'string'
+        end
+      end
 
-        template('feature.erb', feature_path)
+      # Formats a default value as valid Ruby for the attribute declaration
+      def format_default(type, value)
+        case type
+        when 'boolean'
+          value.to_s == 'true' ? 'true' : 'false'
+        when 'integer'
+          value.to_s.to_i.to_s
+        when 'float'
+          value.to_s.to_f.to_s
+        else
+          "'#{value}'"
+        end
       end
     end
   end

data/lib/generators/rails_feature_flip/feature/templates/feature.erb

@@ -1,26 +1,35 @@
 # frozen_string_literal: true
 
+require 'active_model'
+
 # Manages features of the application
 module Features
-  # Settings for the feature <%= @klass_name %>
-  class <%= @klass_name %>Feature
-    attr_reader <%= @attributes.collect(&:name).collect{ |attr| ":#{attr}" }.join(', ') %>
+<%- @namespace_parts.each_with_index do |ns, i| -%>
+<%= '  ' * (i + 1) %>module <%= ns %>
+<%- end -%>
+<%= '  ' * (@namespace_parts.size + 1) %># Settings for the feature <%= @feature_class_name %>
+<%= '  ' * (@namespace_parts.size + 1) %>class <%= @feature_class_name %>
+<%= '  ' * (@namespace_parts.size + 2) %>include ActiveModel::Attributes
+<%= '  ' * (@namespace_parts.size + 2) %>include ActiveModel::AttributeAssignment
+
+<%- @attributes.each do |attribute| -%>
+<%= '  ' * (@namespace_parts.size + 2) %><%= attribute_declaration(attribute) %>
+<%- end -%>
 
-    # Constructor for the feature settings
-    <%- @attributes.each do |attribute| -%>
-      # @param <%= attribute.name %> [<%= attribute.type %>] setting of the feature
-    <%- end -%>
-    def initialize(<%= @attributes.collect(&:name).collect{ |attr| "#{attr}:" }.join(', ') %>)
-      <%- @attributes.each do |attribute| -%>
-        @<%= attribute.name %> = <%= attribute.name %>
-      <%- end -%>
-    end
+<%= '  ' * (@namespace_parts.size + 2) %># @param attrs [Hash] attribute values to initialize with
+<%= '  ' * (@namespace_parts.size + 2) %>def initialize(**attrs)
+<%= '  ' * (@namespace_parts.size + 3) %>super()
+<%= '  ' * (@namespace_parts.size + 3) %>assign_attributes(attrs) unless attrs.empty?
+<%= '  ' * (@namespace_parts.size + 2) %>end
+<%- @boolean_attributes.each do |attribute| -%>
 
-    <%- @boolean_attributes.each do |attribute| -%>
-    # ?-method for the attribute <%= attribute.name %>
-    def <%= attribute.name %>?
-     <%= attribute.name %>
-    end
-    <%- end -%>
-  end
-end
+<%= '  ' * (@namespace_parts.size + 2) %># ?-method for the attribute <%= attribute.name %>
+<%= '  ' * (@namespace_parts.size + 2) %>def <%= attribute.name %>?
+<%= '  ' * (@namespace_parts.size + 3) %><%= attribute.name %>
+<%= '  ' * (@namespace_parts.size + 2) %>end
+<%- end -%>
+<%= '  ' * (@namespace_parts.size + 1) %>end
+<%- @namespace_parts.size.downto(1) do |i| -%>
+<%= '  ' * i %>end
+<%- end -%>
+end

data/lib/generators/rails_feature_flip/install/install_generator.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'rails/generators'
 
 module RailsFeatureFlip
@@ -11,7 +13,7 @@ module RailsFeatureFlip
 
       # Creates RAILS_ROOT/config/features folder unless it exists
       def setup_features_dir
-        Dir.mkdir(Rails.root.join('config/feature')) unless Dir.exist?(Rails.root.join('config/feature'))
+        empty_directory 'config/features'
       end
 
       # Copy default loading file to autoload all features inside the features folder
@@ -21,20 +23,12 @@ module RailsFeatureFlip
 
       def insert_feature_load_statement
         application_rb = 'config/application.rb'
-        content = File.read(application_rb)
-        unless content.include?('require_relative \'features/all\'')
-          insert_into_file application_rb, after: /^Bundler.require.*$/ do
-            <<-RUBY.strip_heredoc
-
-
-              # Automatically load all feature configs - you can load the features manually one by one if you want to.
-              # Be sure to comment out require_relative 'features/all' when doing so.
-              # example:
-              #   require_relative 'features/foo'
-              #   require_relative 'feature/bar'
-              require_relative 'features/all'
-            RUBY
-          end
+        application_rb_path = File.join(destination_root, application_rb)
+        return display_post_install_message unless File.exist?(application_rb_path)
+
+        content = File.read(application_rb_path)
+        unless content.include?("require_relative 'features/all'")
+          insert_into_file application_rb, feature_load_snippet, after: /^Bundler.require.*$/
         end
 
         display_post_install_message
@@ -42,10 +36,23 @@ module RailsFeatureFlip
 
       private
 
+      def feature_load_snippet
+        <<~RUBY
+
+
+          # Automatically load all feature configs - you can load the features manually one by one if you want to.
+          # Be sure to comment out require_relative 'features/all' when doing so.
+          # example:
+          #   require_relative 'features/foo'
+          #   require_relative 'feature/bar'
+          require_relative 'features/all'
+        RUBY
+      end
+
       def display_post_install_message
-        say "RailsFeatureFlip has been successfully installed!"
-        say "You can now generate feature setting by running the 'rails_feature_flag:feature' generator."
-        say "Run 'bin/rails generate rails_feature_flag:feature -h' for usage details."
+        say 'RailsFeatureFlip has been successfully installed!'
+        say "You can now generate feature setting by running the 'rails_feature_flip:feature' generator."
+        say "Run 'bin/rails generate rails_feature_flip:feature -h' for usage details."
       end
     end
   end

data/lib/generators/rails_feature_flip/install/templates/all.rb

@@ -1,10 +1,11 @@
 # frozen_string_literal: true
 
 # Load all features from config/features
-Dir.entries('config/features').reject { |f| File.directory?(f) }.sort.each do |feature|
+features_dir = File.expand_path(__dir__)
+Dir.entries(features_dir).reject { |f| File.directory?(f) }.sort.each do |feature|
   next if feature == 'all.rb'
 
   require_relative feature.chomp('.rb')
 rescue LoadError => e
   puts e.message
-end
+end

data/lib/rails_feature_flip/controller_methods.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module RailsFeatureFlip
+  # Provides require_feature class method for controllers.
+  #
+  # @example
+  #   class HelpCenterController < ApplicationController
+  #     require_feature :help_center
+  #   end
+  module ControllerMethods
+    extend ActiveSupport::Concern
+
+    class_methods do
+      # Adds a before_action that returns 404 unless the feature is enabled.
+      #
+      # @param name [Symbol, String] the feature name
+      # @param options [Hash] options passed to before_action (e.g. only:, except:)
+      def require_feature(name, **options)
+        before_action(**options) do
+          head :not_found unless feature_enabled?(name)
+        end
+      end
+    end
+  end
+end

data/lib/rails_feature_flip/helper.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module RailsFeatureFlip
+  # Provides feature_enabled? helper for controllers and views.
+  #
+  # @example In a view
+  #   <% if feature_enabled?(:help_center) %>
+  #     <%= render 'help_center_widget' %>
+  #   <% end %>
+  module Helper
+    # Checks whether a feature is enabled.
+    #
+    # @param name [Symbol, String] the feature name
+    # @return [Boolean]
+    def feature_enabled?(name)
+      feature = Rails.configuration.x.features.public_send(name)
+      feature.respond_to?(:enabled?) && feature.enabled?
+    end
+  end
+end

data/lib/rails_feature_flip/railtie.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative 'helper'
+require_relative 'controller_methods'
+
+module RailsFeatureFlip
+  # Railtie that auto-includes helpers into controllers and views and provides rake tasks.
+  class Railtie < Rails::Railtie
+    rake_tasks do
+      load 'rails_feature_flip/tasks.rake'
+    end
+
+    initializer 'rails_feature_flip.helpers' do
+      ActiveSupport.on_load(:action_controller_base) do
+        include RailsFeatureFlip::Helper
+        include RailsFeatureFlip::ControllerMethods
+      end
+
+      ActiveSupport.on_load(:action_view) do
+        include RailsFeatureFlip::Helper
+      end
+    end
+  end
+end

data/lib/rails_feature_flip/registry.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module RailsFeatureFlip
+  # Provides a clean API to query all registered features.
+  #
+  # Features are stored in Rails.configuration.x.features (an OrderedOptions hash).
+  # This module wraps that hash with convenience methods.
+  #
+  # @example
+  #   RailsFeatureFlip::Registry.all    # => { chat: #<Features::ChatFeature>, ... }
+  #   RailsFeatureFlip::Registry.names  # => [:chat, :billing]
+  #   RailsFeatureFlip::Registry.find(:chat) # => #<Features::ChatFeature>
+  module Registry
+    # Returns all registered features as a hash.
+    #
+    # @return [Hash{Symbol => Object}]
+    def self.all
+      features_store.to_h
+    end
+
+    # Returns the names of all registered features.
+    #
+    # @return [Array<Symbol>]
+    def self.names
+      features_store.keys
+    end
+
+    # Finds a feature by name.
+    #
+    # @param name [Symbol, String] the feature name
+    # @return [Object] the feature instance
+    # @raise [RailsFeatureFlip::Error] if the feature is not registered
+    def self.find(name)
+      feature = features_store[name.to_sym]
+      raise RailsFeatureFlip::Error, "Feature '#{name}' is not registered" if feature.nil?
+
+      feature
+    end
+
+    def self.features_store
+      Rails.configuration.x.features
+    end
+    private_class_method :features_store
+  end
+end

data/lib/rails_feature_flip/tasks.rake

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+namespace :features do
+  desc 'List all registered features and their current values'
+  task list: :environment do
+    features = RailsFeatureFlip::Registry.all
+
+    if features.empty?
+      puts 'No features registered.'
+      next
+    end
+
+    rows = features.map do |name, feature|
+      enabled = feature.respond_to?(:enabled?) ? feature.enabled?.to_s : 'n/a'
+      attrs = feature_attributes(feature)
+      [name.to_s, feature.class.name, enabled, attrs]
+    end
+
+    print_feature_table(%w[Feature Class Enabled Attributes], rows)
+  end
+end
+
+desc 'List all registered features (alias for features:list)'
+task features: 'features:list'
+
+def feature_attributes(feature)
+  if feature.respond_to?(:attributes)
+    feature.attributes.except('enabled').map { |k, v| "#{k}: #{v.inspect}" }.join(', ')
+  else
+    ivars = feature.instance_variables - [:@enabled]
+    ivars.map { |ivar| "#{ivar.to_s.delete_prefix('@')}: #{feature.instance_variable_get(ivar).inspect}" }.join(', ')
+  end
+end
+
+def print_feature_table(headers, rows)
+  widths = column_widths(headers, rows)
+  template = widths.map { |w| "%-#{w}s" }.join('  ')
+
+  puts format(template, *headers)
+  puts widths.map { |w| '-' * w }.join('  ')
+  rows.each { |row| puts format(template, *row) }
+end
+
+def column_widths(headers, rows)
+  headers.each_with_index.map do |header, i|
+    [header.length, *rows.map { |r| r[i].to_s.length }].max
+  end
+end

data/lib/rails_feature_flip/test_helper.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module RailsFeatureFlip
+  # Test helper for temporarily overriding feature values in tests.
+  #
+  # @example Include in your test class
+  #   class MyTest < ActiveSupport::TestCase
+  #     include RailsFeatureFlip::TestHelper
+  #
+  #     test "shows widget when enabled" do
+  #       with_feature(:help_center, enabled: true) do
+  #         # test code that checks feature behavior
+  #       end
+  #     end
+  #   end
+  module TestHelper
+    # Temporarily overrides attributes on a feature and restores them after the block.
+    #
+    # @param name [Symbol, String] the feature name
+    # @param overrides [Hash] attribute values to set (e.g. enabled: true)
+    # @yield the block to execute with the overridden feature values
+    def with_feature(name, **overrides)
+      feature = Rails.configuration.x.features.public_send(name)
+      originals = save_feature_state(feature, overrides)
+      yield
+    ensure
+      restore_feature_state(feature, originals)
+    end
+
+    private
+
+    def save_feature_state(feature, overrides)
+      overrides.each_with_object({}) do |(attr, value), originals|
+        originals[attr] = feature.public_send(attr)
+        feature.public_send(:"#{attr}=", value)
+      end
+    end
+
+    def restore_feature_state(feature, originals)
+      originals&.each do |attr, value|
+        feature.public_send(:"#{attr}=", value)
+      end
+    end
+  end
+end

data/lib/rails_feature_flip/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsFeatureFlip
-  VERSION = "0.1.1"
+  VERSION = '1.0.0'
 end

data/lib/rails_feature_flip.rb

@@ -1,7 +1,32 @@
 # frozen_string_literal: true
 
 require_relative 'rails_feature_flip/version'
+require_relative 'rails_feature_flip/registry'
+require_relative 'rails_feature_flip/railtie' if defined?(Rails::Railtie)
 
 module RailsFeatureFlip
   class Error < StandardError; end
+
+  # Enables a feature at runtime (in-memory, resets on restart).
+  #
+  # @param name [Symbol, String] the feature name
+  def self.enable(name)
+    Registry.find(name).enabled = true
+  end
+
+  # Disables a feature at runtime (in-memory, resets on restart).
+  #
+  # @param name [Symbol, String] the feature name
+  def self.disable(name)
+    Registry.find(name).enabled = false
+  end
+
+  # Toggles a feature at runtime (in-memory, resets on restart).
+  #
+  # @param name [Symbol, String] the feature name
+  # @return [Boolean] the new enabled state
+  def self.toggle(name)
+    feature = Registry.find(name)
+    feature.enabled = !feature.enabled?
+  end
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: rails-feature-flip
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 1.0.0
 platform: ruby
 authors:
 - Benjamin Deutscher
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-02-23 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -16,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '7.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '7.0'
 description: A more flexible way to manage settings and features in you rails app.
 email:
 - ben@bdeutscher.org
@@ -31,6 +30,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".rubocop.yml"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
@@ -43,8 +43,13 @@ files:
 - lib/generators/rails_feature_flip/install/templates/all.rb
 - lib/generators/rails_feature_flip/install/templates/initializer.rb
 - lib/rails_feature_flip.rb
+- lib/rails_feature_flip/controller_methods.rb
+- lib/rails_feature_flip/helper.rb
+- lib/rails_feature_flip/railtie.rb
+- lib/rails_feature_flip/registry.rb
+- lib/rails_feature_flip/tasks.rake
+- lib/rails_feature_flip/test_helper.rb
 - lib/rails_feature_flip/version.rb
-- rails-feature-flip.gemspec
 homepage: https://github.com/its-bede/rails-feature-flip
 licenses:
 - MIT
@@ -52,7 +57,7 @@ metadata:
   homepage_uri: https://github.com/its-bede/rails-feature-flip
   source_code_uri: https://github.com/its-bede/rails-feature-flip
   changelog_uri: https://github.com/its-bede/rails-feature-flip/blob/main/CHANGELOG.md
-post_install_message:
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -60,15 +65,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Feature flipping for rails apps.
 test_files: []

data/rails-feature-flip.gemspec

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "lib/rails_feature_flip/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "rails-feature-flip"
-  spec.version = RailsFeatureFlip::VERSION
-  spec.authors = ["Benjamin Deutscher"]
-  spec.email = ["ben@bdeutscher.org"]
-
-  spec.summary = "Feature flipping for rails apps."
-  spec.description = "A more flexible way to manage settings and features in you rails app."
-  spec.homepage = "https://github.com/its-bede/rails-feature-flip"
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 2.6.0"
-
-  # spec.metadata["allowed_push_host"] = "TODO: Set to your gem server 'https://example.com'"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/its-bede/rails-feature-flip"
-  spec.metadata["changelog_uri"] = "https://github.com/its-bede/rails-feature-flip/blob/main/CHANGELOG.md"
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (File.expand_path(f) == __FILE__) ||
-        f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor Gemfile])
-    end
-  end
-
-  spec.files += Dir["lib/generators/**/*"]
-
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  # Uncomment to register a new dependency of your gem
-  spec.add_dependency 'rails', '>= 5.0'
-
-  # For more information and examples about making a new gem, check out our
-  # guide at: https://bundler.io/guides/creating_gem.html
-end