featury 1.0.0.rc4 → 1.0.0.rc6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61aef35ff4aede3e7c747a1b28be3d9ce598b068bc2d355093ac7a6ebb5b0829
-  data.tar.gz: 40a570d5c32557cc9d7ab325633df8783676bfe48c58f1985bc943f1bb8c1d48
+  metadata.gz: e1dc31fdf0161091a1e477a352c5e06629fed341c488d78e0d6153c02805623e
+  data.tar.gz: 298efaed87cd51269f3bef4573a925924db8503865f54d2e0402a7c35ba4b283
 SHA512:
-  metadata.gz: '097cbc783cb17e6648a514190be9bf075868113e089fb21725f9889b92e4293ebe5ea5c2ca49fdebc2ca06c318f37556ca69c56c4703c04a5693de6fbb1eb0de'
-  data.tar.gz: 3c41249a7db0ead35e581e6f6e517157b46cec9ee03e4f005f0c6529bb0067ec7c14ed7b130d550ffb22e66a72589638cb259b359137aee3f393db9763896238
+  metadata.gz: ca3ed00e6e9e6f0559c2a1ddf8a962c2dc8857d135bcf5a1c4e85f95a81d6c6244c65f050523a67a3d1aec82490a69812dc1186467b0ab2eaaba3a3523467e79
+  data.tar.gz: be517027a237226225c42d03a5ba88f0d050c93bdd82fcaf90681fb764f8602214d3381e59bf7f5531e18fde19328220d1f4e5a2257cd1911c43dbc26185d360

data/README.md

@@ -3,11 +3,11 @@
   <a href="https://github.com/servactory/featury/releases"><img src="https://img.shields.io/github/release-date/servactory/featury" alt="Release Date"></a>
 </p>
 
-## For what?
+## Purpose
 
-Featury is designed for grouping and managing multiple features in projects.
-You can use any ready-made solution or your own.
-Feature is easily customizable to suit projects and their goals.
+Featury is designed to group and manage multiple features within a project.
+It provides the flexibility to utilize any pre-existing solution or create your own.
+It's easily adjustable to align with the unique needs and objectives of your project.
 
 [//]: # (## Documentation)
 
@@ -25,8 +25,8 @@ gem "featury"
 
 #### Basic class for your features
 
-For example, you use Flipper for features.
-In this case, the base class might look like this:
+For instance, assume that you are utilizing Flipper for managing features.
+In such scenario, the base class could potentially be structured as follows:
 
 ```ruby
 class ApplicationFeature < Featury::Base
@@ -58,14 +58,10 @@ class UserFeature::Onboarding < ApplicationFeature
 
   prefix :user_onboarding
 
-  features(
-    :passage, # => :user_onboarding_passage
-  )
+  features :passage # => :user_onboarding_passage
 
-  groups(
-    BillingFeature,
-    PaymentSystemFeature
-  )
+  groups BillingFeature,
+         PaymentSystemFeature
 end
 ```
 
@@ -73,9 +69,8 @@ end
 class BillingFeature < ApplicationFeature
   prefix :billing
 
-  features(
-    :work # => :billing_work
-  )
+  features :api,        # => :billing_api
+           :webhooks    # => :billing_webhooks
 end
 ```
 
@@ -83,22 +78,21 @@ end
 class PaymentSystemFeature < ApplicationFeature
   prefix :payment_system
 
-  features(
-    :work # => :payment_system_work
-  )
+  features :api,      # => :payment_system_api
+           :webhooks  # => :payment_system_webhooks
 end
 ```
 
-The `resource` method can indicate how the transmitted information should be processed.
-In addition to the options that Servactory brings, there are options for specifying the processing mode of the transmitted data.
+The `resource` method provides an indication of how the transmitted information ought to be processed.
+Besides the options provided by [Servactory](https://github.com/servactory/servactory), additional ones are available for stipulating the processing mode of the transmitted data.
 
-If it is necessary for a resource to be transferred as an option for a feature flag, then use the `option` option:
+If a resource needs to be conveyed as a feature flag option, utilize the `option` parameter:
 
-```ruby
+```ruby 
 resource :user, type: User, option: true
 ```
 
-If it is necessary for a resource to be transferred to a nested group, then use the `nested` option:
+To transfer a resource to a nested group, utilize the `nested` option:
 
 ```ruby
 resource :user, type: User, nested: true
@@ -106,22 +100,34 @@ resource :user, type: User, nested: true
 
 #### Working with the features of your project
 
-Each of these actions will be applied to all feature flags.
-And the result of these calls will be based on the result of all feature flags.
+Each of these actions will be applied to every feature flag.
+Subsequently, the outcome of these actions will be contingent upon the combined results of all feature flags.
 
 ```ruby
 UserFeature::Onboarding.enabled?(user:) # => true
 UserFeature::Onboarding.disabled?(user:) # => false
 UserFeature::Onboarding.enable(user:) # => true
-UserFeature::Onboarding.disable(user:) # => false
+UserFeature::Onboarding.disable(user:) # => true
+```
+
+You can also utilize the `with` method to pass necessary arguments.
+
+```ruby
+feature = UserFeature::Onboarding.with(user:)
+
+feature.enabled? # => true
+feature.disabled? # => false
+feature.enable # => true
+feature.disable # => true
 ```
 
-If one of the feature flags is turned off, for example,
-through your automation, then the main feature class will
-return `false` when asked "is it enabled?".
+If a feature flag is deactivated, possibly via automation processes,
+the primary feature class subsequently responds with `false` when
+queried about its enablement status.
 
-In the example above, this could be the payment system and its shutdown due to technical work.
-In this case, all onboarding of new users will be suspended.
+In the preceding example, there might be a scenario where the payment system is
+undergoing technical maintenance and therefore is temporarily shut down.
+Consequently, the onboarding process for new users will be halted until further notice.
 
 ## Contributing
 

data/lib/featury/actions/service/factory.rb

@@ -21,7 +21,7 @@ module Featury
           @model_class.const_set(Builder::SERVICE_CLASS_NAME, class_sample)
         end
 
-        def create_service_class # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+        def create_service_class # rubocop:disable Metrics/MethodLength, Metrics/AbcSize,Metrics/CyclomaticComplexity
           collection_of_resources = @collection_of_resources
 
           Class.new(Featury::Service::Builder) do
@@ -56,7 +56,7 @@ module Featury
               end
             end
 
-            def check_features
+            def check_features # rubocop:disable Metrics/AbcSize
               options = inputs.collection_of_resources.only_option.to_h do |resource|
                 [resource.name, inputs.public_send(resource.name)]
               end
@@ -65,7 +65,7 @@ module Featury
                 inputs.action.block.call(features: inputs.collection_of_features.list, **options)
             end
 
-            def check_groups
+            def check_groups # rubocop:disable Metrics/AbcSize
               arguments = inputs.collection_of_resources.only_nested.to_h do |resource|
                 [resource.name, inputs.public_send(resource.name)]
               end

data/lib/featury/context/callable.rb

@@ -10,6 +10,8 @@ module Featury
 
         context = send(:new)
 
+        arguments.merge!(@with_arguments) if @with_arguments.is_a?(Hash)
+
         _call!(context, action, **arguments)
       end
 
@@ -17,6 +19,12 @@ module Featury
         collection_of_actions.names.include?(method_name) || super
       end
 
+      def with(arguments = {})
+        @with_arguments = arguments
+
+        self
+      end
+
       private
 
       def _call!(context, action, **arguments)

data/lib/featury/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: featury
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc4
+  version: 1.0.0.rc6
 platform: ruby
 authors:
 - Anton Sokolov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-22 00:00:00.000000000 Z
+date: 2024-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -19,7 +19,7 @@ dependencies:
         version: '5.1'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '7.2'
+        version: '8.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '5.1'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '7.2'
+        version: '8.0'
 - !ruby/object:Gem::Dependency
   name: i18n
   requirement: !ruby/object:Gem::Requirement
@@ -50,14 +50,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.6.0
+        version: 2.8.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.6.0
+        version: 2.8.0
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement