toggly-rails 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8d468b9f510429b469f221020f9cd8d3067d7245a64eb6a69b23177cedc5930
-  data.tar.gz: 9a366fe266b0ca94fa6f2b73ba87126b054f02014d874fea68777298dc756172
+  metadata.gz: e875e3adc013c895862f6789a17d979de7536e1dea48170ab7eeb055b223b0d9
+  data.tar.gz: 7c6e86dcc19a82100149c96fe4f13b9b5b60277193175e767eb72e6eaa21bc28
 SHA512:
-  metadata.gz: 6781f2fa1f330cd89d6dab223294a6a5aa5f86cb6a9c3cdb830bdad6ed2eeb519a93cb963dfcd10ce731df2babbc6e227ae0ed967f11fe2bab0306ec7826215a
-  data.tar.gz: a28620a28aa9ea49e37632aa2de01e17f132932e14d4f4f02d1a7bead02536c03690b0b38eb769b6cbff186bafb9f7c248f357d5b429bd9b407c74a88c252033
+  metadata.gz: fd75cf0d95a8e4adb4464a6822f38faf004ef410f94912a62f58cb5fb0b3d56f08cb305390136b0a49ce253fe4b021ea98be842bfd052aea6ac7a714402ad222
+  data.tar.gz: 4d81b7d3132ec766130fddaa8b7a389481b92656bfee9ce4773caabf8cafb3c489fdf165a6049071273fbeaab3556002ce1a48e16d9aa8aee66d2c67814eb0ac

data/CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.1] - 2026-09-16
+
+### Fixed
+
+- Forward telemetry options (`enable_usage_tracking`, `enable_metrics`,
+  flush intervals) onto core `Toggly::Config`. A live `app_key` with no
+  `TOGGLY_DISABLE_TELEMETRY=1` now enables usage with the core ~60s flush.
+
+## [0.3.0] - 2026-09-12
+
+### Added
+
+- Add the canonical `feature(feature_key, context: nil, negate: false)` view helper, capturing only the selected ActionView block.
+
+### Changed
+
+- Keep `when_feature_enabled` and `when_feature_disabled` as deprecated compatibility adapters to `feature`.
+
+## [0.2.1] - 2026-09-03
+
+### Changed
+
+- Raise required Ruby version to 3.2+ (matches Gemfile.lock Bundler and CI).
+- Use anonymous block forwarding in Rails testing and view helpers (RuboCop for Ruby 3.2+).
+
 ## [0.2.0] - 2026-08-21
 
 ### Added

data/README.md

@@ -40,11 +40,21 @@ end
 ### Views
 
 ```erb
-<% if feature_enabled?(:promo) %>
+<%= feature(:promo) do %>
   <div class="promo">Special offer!</div>
 <% end %>
+
+<%= feature(:promo, negate: true) do %>
+  <div class="standard">Standard offer</div>
+<% end %>
 ```
 
+Use the same feature key and context for both blocks. `feature` captures only
+the selected block, and `negate: true` selects the complementary branch.
+`when_feature_enabled` and `when_feature_disabled` remain available as
+deprecated compatibility adapters. Boolean helpers and `feature_switch` are
+unchanged.
+
 ## Documentation
 
 See the [main README](../README.md) for full documentation.

data/lib/toggly/rails/configuration.rb

@@ -12,7 +12,9 @@ module Toggly
                     :refresh_interval, :http_timeout,
                     :enable_undefined_in_dev, :disable_background_refresh,
                     :app_version, :instance_name, :defaults,
-                    :snapshot_provider, :use_signed_definitions, :allowed_key_ids
+                    :snapshot_provider, :use_signed_definitions, :allowed_key_ids,
+                    :enable_usage_tracking, :enable_metrics,
+                    :usage_flush_interval, :metrics_flush_interval
 
       # Rails-specific options
 
@@ -75,6 +77,10 @@ module Toggly
         config.defaults = defaults
         config.use_signed_definitions = use_signed_definitions
         config.allowed_key_ids = allowed_key_ids
+        config.enable_usage_tracking = enable_usage_tracking unless enable_usage_tracking.nil?
+        config.enable_metrics = enable_metrics unless enable_metrics.nil?
+        config.usage_flush_interval = usage_flush_interval unless usage_flush_interval.nil?
+        config.metrics_flush_interval = metrics_flush_interval unless metrics_flush_interval.nil?
 
         # Set up snapshot provider
         config.snapshot_provider = build_snapshot_provider

data/lib/toggly/rails/generators/toggly/install/install_generator.rb

@@ -37,9 +37,12 @@ module Toggly
         say "  end"
         say ""
         say "Usage in views:"
-        say "  <% if feature_enabled?(:my_feature) %>"
+        say "  <%= feature(:my_feature) do %>"
         say "    Feature content"
         say "  <% end %>"
+        say "  <%= feature(:my_feature, negate: true) do %>"
+        say "    Standard content"
+        say "  <% end %>"
         say ""
       end
 

data/lib/toggly/rails/testing.rb

@@ -82,16 +82,16 @@ module Toggly
       #
       # @param feature_key [String, Symbol] Feature key
       # @yield Block during which the feature is enabled
-      def enable_feature(feature_key, &block)
-        with_feature(feature_key, enabled: true, &block)
+      def enable_feature(feature_key, &)
+        with_feature(feature_key, enabled: true, &)
       end
 
       # Disable a feature for the duration of a block
       #
       # @param feature_key [String, Symbol] Feature key
       # @yield Block during which the feature is disabled
-      def disable_feature(feature_key, &block)
-        with_feature(feature_key, enabled: false, &block)
+      def disable_feature(feature_key, &)
+        with_feature(feature_key, enabled: false, &)
       end
 
       # RSpec helpers

data/lib/toggly/rails/version.rb

@@ -2,6 +2,6 @@
 
 module Toggly
   module Rails
-    VERSION = "0.2.0"
+    VERSION = "0.3.1"
   end
 end

data/lib/toggly/rails/view_helpers.rb

@@ -30,28 +30,40 @@ module Toggly
         !feature_enabled?(feature_key, context: context)
       end
 
+      # Render content when the feature evaluation matches the requested branch
+      #
+      # @param feature_key [String, Symbol] Feature key
+      # @param context [Toggly::Context, nil] Optional override context
+      # @param negate [Boolean] Render when the feature is disabled
+      # @yield Content to render for the selected branch
+      # @return [String, nil]
+      def feature(feature_key, context: nil, negate: false, &)
+        enabled = feature_enabled?(feature_key, context: context)
+        return unless negate ? !enabled : enabled
+
+        capture(&) if block_given?
+      end
+
       # Render content only if feature is enabled
       #
+      # @deprecated Use {#feature}.
       # @param feature_key [String, Symbol] Feature key
       # @param context [Toggly::Context, nil] Optional override context
       # @yield Content to render when enabled
       # @return [String, nil]
-      def when_feature_enabled(feature_key, context: nil, &block)
-        return unless feature_enabled?(feature_key, context: context)
-
-        capture(&block) if block_given?
+      def when_feature_enabled(feature_key, context: nil, &)
+        feature(feature_key, context: context, negate: false, &)
       end
 
       # Render content only if feature is disabled
       #
+      # @deprecated Use {#feature} with +negate: true+.
       # @param feature_key [String, Symbol] Feature key
       # @param context [Toggly::Context, nil] Optional override context
       # @yield Content to render when disabled
       # @return [String, nil]
-      def when_feature_disabled(feature_key, context: nil, &block)
-        return if feature_enabled?(feature_key, context: context)
-
-        capture(&block) if block_given?
+      def when_feature_disabled(feature_key, context: nil, &)
+        feature(feature_key, context: context, negate: true, &)
       end
 
       # Render enabled or disabled content based on feature state

data/lib/toggly-rails.rb

@@ -32,9 +32,10 @@ module Toggly
   #   end
   #
   # @example View usage
-  #   <% if feature_enabled?(:new_header) %>
+  #   <%= feature(:new_header) do %>
   #     <%= render "new_header" %>
-  #   <% else %>
+  #   <% end %>
+  #   <%= feature(:new_header, negate: true) do %>
   #     <%= render "header" %>
   #   <% end %>
   module Rails

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: toggly-rails
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Ops.ai
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-24 00:00:00.000000000 Z
+date: 2026-09-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -79,7 +79,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="