featury 1.0.0.rc17 → 1.0.0.rc19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 491815dac66e84a9b49167bf18da77eeedc2d09678eaa2f9f0bff8d92412e3bd
-  data.tar.gz: 6da5468fe1f8433300821b314d6f6290199b941020c8785c2b7c863692d26b99
+  metadata.gz: 90d7f0c59fc6810d609fa806bb5fa60cda2894c66bacbfd8f6015c05f9d8d376
+  data.tar.gz: 21fbdbca92e6583fc9f02261c2de3344d1c91740b0dc72df6810c2102a9a907c
 SHA512:
-  metadata.gz: bb45c8f5986cdbeb6c18aabdda320a58844c838eee932ed17f2db90493812d5c79ef4da5652e0f93f67d8f2b245c6c4f09c714c4be54a6bf55fd308a395ef323
-  data.tar.gz: b7983574ee2e170fee966888b989cc9dd4603ccea54f479ef87325d1f1736766812041b45d806516466622f193f8c30dc935e0807afe04f655eb27211315daf0
+  metadata.gz: 3909dee49e854c7c4b380f23a1f7fb70028a3c84c16d99bd1a1978f152d40684b28f5df2249cbd7c0627fb6b148b4f73a3967382e7914fe4186f683f26899d37
+  data.tar.gz: 513add3e16f4a5fabd4790ac161f3d5e6a2252c3580ec2f7be01d5219c5cfccfecce5cfe147a3b233b689facfe1469e553250c0315d82b48a41f6fb07ced2d1e

data/README.md

@@ -40,22 +40,26 @@ In such a scenario, the base class could potentially be structured as follows:
 
 ```ruby
 class ApplicationFeature < Featury::Base
-  action :enabled? do |features:, **options|
+  action :enabled?, web: :enabled? do |features:, **options|
     features.all? { |feature| Flipper.enabled?(feature, *options.values) }
   end
 
-  action :disabled? do |features:, **options|
+  action :disabled?, web: :regular do |features:, **options|
     features.any? { |feature| !Flipper.enabled?(feature, *options.values) }
   end
 
-  action :enable do |features:, **options|
+  action :enable, web: :enable do |features:, **options|
     features.all? { |feature| Flipper.enable(feature, *options.values) }
   end
 
-  action :disable do |features:, **options|
+  action :disable, web: :disable do |features:, **options|
     features.all? { |feature| Flipper.disable(feature, *options.values) }
   end
 
+  action :add do |features:, **options|
+    features.all? { |feature| Flipper.add(feature, *options.values) }
+  end
+
   before do |action:, features:|
     Slack::API::Notify.call!(action:, features:)
   end
@@ -66,6 +70,16 @@ class ApplicationFeature < Featury::Base
 end
 ```
 
+#### About the `web:` key
+
+The `web:` key in the action definition allows you to specify which method will be used for web interactions. This is useful for mapping internal action names to external endpoints or UI actions. For example:
+
+- `enabled?` — the method that will be used in the web context to check the state of a feature flag;
+- `enable` — the method that will be used in the web context to enable a feature flag;
+- `disable` — the method that will be used in the web context to disable a feature flag.
+
+This mapping helps you clearly separate internal logic from the interface exposed to web clients.
+
 #### Features of your project
 
 ```ruby
@@ -154,9 +168,10 @@ info = User::OnboardingFeature.info
 ```
 
 ```ruby
-info.features # Feature flags of the current class.
-info.groups   # Feature flag groups of the current class.
-info.tree     # Tree of feature flags from the current class.
+info.actions      # Feature actions (all, web) of the current class.
+info.features     # Feature flags of the current class.
+info.groups       # Feature flag groups of the current class.
+info.tree         # Tree of feature flags from the current class.
 ```
 
 ## Contributing

data/lib/featury/actions/action.rb

@@ -3,12 +3,31 @@
 module Featury
   module Actions
     class Action
-      attr_reader :name, :block
+      attr_reader :name,
+                  :web,
+                  :block
 
-      def initialize(name, block:)
+      def initialize(name, web:, block:)
         @name = name
+        @web = web
         @block = block
       end
+
+      def web_enabled?
+        @web == :enabled?
+      end
+
+      def web_enable?
+        @web == :enable
+      end
+
+      def web_disable?
+        @web == :disable
+      end
+
+      def web_regular?
+        @web == :regular
+      end
     end
   end
 end

data/lib/featury/actions/collection.rb

@@ -4,16 +4,39 @@ module Featury
   module Actions
     class Collection
       extend Forwardable
-      def_delegators :@collection, :<<, :each, :map, :merge, :find
+      def_delegators :@collection, :<<, :filter, :each, :map, :merge, :find
 
       def initialize(collection = Set.new)
         @collection = collection
       end
 
+      def for_web
+        Collection.new(
+          filter do |action|
+            action.web_enabled? ||
+              action.web_enable? ||
+              action.web_disable? ||
+              action.web_regular?
+          end
+        )
+      end
+
       def names
         map(&:name)
       end
 
+      def web_enabled
+        find(&:web_enabled?)
+      end
+
+      def web_enable
+        find(&:web_enable?)
+      end
+
+      def web_disable
+        find(&:web_disable?)
+      end
+
       def find_by(name:)
         find { |action| action.name == name }
       end

data/lib/featury/actions/dsl.rb

@@ -17,9 +17,10 @@ module Featury
 
         private
 
-        def action(name)
+        def action(name, web: nil)
           collection_of_actions << Action.new(
             name,
+            web:,
             block: ->(features:, **options) { yield(features:, **options) }
           )
         end

data/lib/featury/info/dsl.rb

@@ -10,6 +10,7 @@ module Featury
       module ClassMethods
         def info
           Featury::Info::Result.new(
+            actions: Featury::Info::Result::Actions.new(collection_of_actions),
             features: collection_of_features.full_names,
             groups: collection_of_groups.map(&:group),
             tree: collection_of_features.full_names.concat(

data/lib/featury/info/result.rb

@@ -3,9 +3,37 @@
 module Featury
   module Info
     class Result
-      attr_reader :features, :groups, :tree
+      class Actions
+        class Web
+          attr_reader :all,
+                      :enabled,
+                      :enable,
+                      :disable
 
-      def initialize(features:, groups:, tree:)
+          def initialize(collection_of_actions)
+            @all = collection_of_actions.names
+            @enabled = collection_of_actions.web_enabled.name
+            @enable = collection_of_actions.web_enable.name
+            @disable = collection_of_actions.web_disable.name
+          end
+        end
+
+        attr_reader :all,
+                    :web
+
+        def initialize(collection_of_actions)
+          @all = collection_of_actions.names
+          @web = Web.new(collection_of_actions.for_web)
+        end
+      end
+
+      attr_reader :actions,
+                  :features,
+                  :groups,
+                  :tree
+
+      def initialize(actions:, features:, groups:, tree:)
+        @actions = actions
         @features = features
         @groups = groups
         @tree = tree

data/lib/featury/version.rb

@@ -5,7 +5,7 @@ module Featury
     MAJOR = 1
     MINOR = 0
     PATCH = 0
-    PRE = "rc17"
+    PRE = "rc19"
 
     STRING = [MAJOR, MINOR, PATCH, PRE].compact.join(".")
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: featury
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc17
+  version: 1.0.0.rc19
 platform: ruby
 authors:
 - Anton Sokolov