toolx 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f027d545a91be1a02f8ef28f52ced20c6d6ffe3defc99be3f59dd783b78bed2f
-  data.tar.gz: 453e20a3f42da721d4acdb50fb62de95ad62b4801c6c652c3285c8a5de311a21
+  metadata.gz: 71e2fe435a932be8cd57480bce5c52c27e369699cbe6de4f9dacc6eed981476b
+  data.tar.gz: 68b6b1546a453e517c25c98359a9e00d6bcae46e01cf2331564e81f0147cbd28
 SHA512:
-  metadata.gz: 9551fd33fe000bf1a10e5500a409f770ea64533b3db892825174f96659773fa93b872b78f21cb7dbdfc575045e54024bddb18e499b96417c36a1edf0a931a3b4
-  data.tar.gz: '018ed1cadf76d903502d6e1b5fdd1c3bc14d3891995d35d2566fb36c2c15ffbd59ea04c6af87d46f7c876cbf840a5f903b3b2eae8b6d43e3afafa3738ee74de1'
+  metadata.gz: 4a4d5785740ee58fc8ed1489b4444482c2d9b98569091d8764d1f79038057f4b3421184aba119d2968f3c839845dbf9e708a55354ba09818b58e2c4114c5dff0
+  data.tar.gz: 5b38acc866cff44a922234c89093ea23fe44b3c26e84ff92c215404a086940bf9993b6fc065684e29f860fcafc7935c6a79d632df80f51f4fadbdbccffb6f14d

data/README.md

@@ -26,6 +26,8 @@ class ApplicationRecord < ActiveRecord::Base
   include Toolx::Core::Concerns::Transformer
   include Toolx::Core::Concerns::CustomIdentifier
   include Toolx::Core::Concerns::DateTimeToBoolean
+  include Toolx::Core::Concerns::Keygen
+  include Toolx::Core::Concerns::Tokenizer
   include Toolx::Core::Concerns::WithStateMachine
 end
 ```
@@ -135,6 +137,96 @@ user.deleted = true  # also sets current time
 user.deleted = false # sets deleted_at to nil
 ```
 
+### Keygen
+
+Generate unique keys for your models, ensuring they are unique across the database.
+
+```ruby
+class User < ApplicationRecord
+  include Toolx::Core::Concerns::Keygen
+
+  keygen :dob, attr: :lic_key, secret: 'my$ecret', limit: 20, separator: '.', br: 3
+end
+user = User.new(dob: '1990-01-01')
+user.save! 
+user.lic_key # => '090.cc2.207.c45.3e7.20b.f95'
+```
+
+### Tokenizer
+
+Generate unique tokens for your models before creation, useful for API keys, access tokens, invitations, etc.
+
+```ruby
+class AccessToken < ApplicationRecord
+  include Toolx::Core::Concerns::Tokenizer
+
+  tokenize :token, size: 32, prefix: 'tok'
+end
+
+token = AccessToken.create!
+token.token # => "tok-xnT3yM9dPQsA4W8Ks7LZhV5RuKcgByTw"
+```
+
+### Stateman via with_state_machine 
+
+It is working only with `Statesman::Adapters::ActiveRecord`
+
+You can generate state machine classes via rake task
+
+```bash
+bin/rails "toolx:stateman:generate[Project]"
+```
+command will generate models for existing `Project` model as
+`Project::StateMachine` and `Project::Transition`.
+
+also will add migraion file for those models.
+
+Example usage:
+
+```ruby
+class Project::StateMachine
+  include Statesman::Machine
+
+  state :active, initial: true
+  state :pending
+  state :skipped
+  state :cancelled
+  state :done
+
+  transition from: :active, to: [:pending, :pending, :skipped, :cancelled, :done]
+  transition from: :pending, to: [:skipped, :cancelled, :done]
+  transition from: :skipped, to: [:pending]
+
+  after_transition do |model, transition|
+    model.update!(status: transition.to_state)
+  end
+end
+
+class Project::Transition < ActiveRecord::Base
+  belongs_to :project
+
+  attribute :most_recent, :boolean, default: false
+  attribute :sort_key, :integer
+  attribute :to_state, :string
+  attribute :metadata, :json, default: {}
+
+  validates :to_state, inclusion: { in: Project::StateMachine.states }
+end
+
+class Project < ActiveRecord::Base
+  include Toolx::Core::Concerns::WithStateMachine
+  STATUSES = %w[active pending done skipped cancelled].freeze
+
+  with_state_machine
+
+  attribute :name, :string
+  attribute :status, :string, default: 'active'
+
+  validates :name, presence: true
+  validates :status, inclusion: { in: STATUSES }, allow_nil: true
+end
+```
+
 ### Errors
 
 A structured, extensible error-handling framework:
@@ -227,7 +319,6 @@ end
 Presenter.auto_present(Article.new(title: "A very long title"))
 ```
 
-
 ### SimpleCrypt
 
 Simple AES encryption helper using ActiveSupport::MessageEncryptor.
@@ -383,66 +474,6 @@ SignupOperation.flow
   .perform!(email: 'foo@bar.com', age: 20)
 ```
 
-### Stateman via with_state_machine 
-
-It is working only with `Statesman::Adapters::ActiveRecord`
-
-You can generate state machine classes via rake task
-
-```bash
-bin/rails "toolx:stateman:generate[Project]"
-```
-command will generate models for existing `Project` model as
-`Project::StateMachine` and `Project::Transition`.
-
-also will add migraion file for those models.
-
-Example usage:
-
-```ruby
-class Project::StateMachine
-  include Statesman::Machine
-
-  state :active, initial: true
-  state :pending
-  state :skipped
-  state :cancelled
-  state :done
-
-  transition from: :active, to: [:pending, :pending, :skipped, :cancelled, :done]
-  transition from: :pending, to: [:skipped, :cancelled, :done]
-  transition from: :skipped, to: [:pending]
-
-  after_transition do |model, transition|
-    model.update!(status: transition.to_state)
-  end
-end
-
-class Project::Transition < ActiveRecord::Base
-  belongs_to :project
-
-  attribute :most_recent, :boolean, default: false
-  attribute :sort_key, :integer
-  attribute :to_state, :string
-  attribute :metadata, :json, default: {}
-
-  validates :to_state, inclusion: { in: Project::StateMachine.states }
-end
-
-class Project < ActiveRecord::Base
-  include Toolx::Core::Concerns::WithStateMachine
-  STATUSES = %w[active pending done skipped cancelled].freeze
-
-  with_state_machine
-
-  attribute :name, :string
-  attribute :status, :string, default: 'active'
-
-  validates :name, presence: true
-  validates :status, inclusion: { in: STATUSES }, allow_nil: true
-end
-```
-
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/tasks/aliases.rake

@@ -40,6 +40,8 @@ namespace :toolx do
           include Toolx::Core::Concerns::CustomIdentifier
           include Toolx::Core::Concerns::DateTimeToBoolean
           include Toolx::Core::Concerns::WithStateMachine
+          include Toolx::Core::Concerns::Keygen
+          include Toolx::Core::Concerns::Tokenizer
         end
       RUBY
       puts "\n"

data/lib/toolx/core/concerns/keygen.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Toolx
+  module Core
+    module Concerns
+      module Keygen
+        extend ::ActiveSupport::Concern
+
+        class_methods do
+          # Generates a unique key based on the provided attributes and an optional secret.
+          # @example
+          #   class License < ApplicationRecord
+          #     include Keygen
+          #     keygen ->(m) { [m.id, m.format_date(m.expire_at), m.type, m.user_id] }
+          #   end
+          #
+          #   license = License.new(id: '1234', expire_at: Time.current + 1.month, type: 'default', user_id: 'usr_5678')
+          #   license.key # => "7034-d544-f8d1-fddf-d939-14ce-53c5-3ed9-f71f-3dab"
+          #
+          # @param source [Array<Symbol, Proc>] Attributes or a Proc to generate the key from.
+          # @param attr [Symbol] The attribute to store the generated key in (default)
+          # @param secret [String, nil] An optional secret to include in the key generation.
+          # @param limit [Integer] The maximum length of the generated key (default: 40).
+          # @param separator [String] The separator to use in the generated key (default: '-').
+          # @param br [Integer] The number of characters in each segment of the key (default: 4).
+          def keygen(*source, attr: :key, secret: nil, limit: 40, separator: '-', br: 4)
+            after_save do
+              next if source.blank?
+
+              binding = source.first.class == Proc
+              data = binding ? source.first.call(self) : source.map { |attr| send(attr).to_s }
+              value = (data.push(secret.to_s)).compact.join
+              result = Digest::SHA256.hexdigest(value)[0..limit].scan(/.{#{br}}/).join(separator)
+
+              next if send(attr) == result
+
+              update_column(attr, result)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/toolx/core/concerns/tokenizer.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Toolx
+  module Core
+    module Concerns
+      module Tokenizer
+        extend ::ActiveSupport::Concern
+
+        class_methods do
+          # Generates a unique token for a given attribute before creation.
+          #
+          # @example
+          #   class AccessToken < ApplicationRecord
+          #     include Toolx::Core::Concerns::Tokenizer
+          #     tokenize :token, size: 32, prefix: 'tok'
+          #   end
+          #
+          #   token = AccessToken.create
+          #   token.token # => "tok-MH3yTbcuZJ8o..."
+          #
+          # @param attribute [Symbol] The attribute to assign the token to.
+          # @param size [Integer] The size of the randomly generated token (default: 64).
+          # @param prefix [String, nil] Optional prefix to prepend to the token.
+          def tokenize(attribute, size: 64, prefix: nil)
+            before_create do
+              token_value = send(attribute)
+              next unless token_value.nil?
+
+              loop do
+                unique = SecureRandom.base58(size)
+
+                send("#{attribute}=", [prefix, unique].compact.join('-'))
+                break unless self.class.exists?(token_value)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/toolx/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Toolx
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: toolx
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Pawel Niemczyk
 bindir: exe
 cert_chain: []
-date: 2025-06-24 00:00:00.000000000 Z
+date: 2025-06-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: statesman
@@ -288,6 +288,8 @@ files:
 - lib/toolx/core/concerns/custom_identifier.rb
 - lib/toolx/core/concerns/date_time_to_boolean.rb
 - lib/toolx/core/concerns/inquirer.rb
+- lib/toolx/core/concerns/keygen.rb
+- lib/toolx/core/concerns/tokenizer.rb
 - lib/toolx/core/concerns/transformer.rb
 - lib/toolx/core/concerns/with_state_machine.rb
 - lib/toolx/core/env.rb