human_enum 0.1.2 → 1.1.2

data/bin/rspec

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../Gemfile', __dir__)
+
+bundle_binstub = File.expand_path('bundle', __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?('This file was generated by Bundler')
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rspec-core', 'rspec')

data/bin/setup

@@ -4,5 +4,3 @@ IFS=$'\n\t'
 set -vx
 
 bundle install
-
-# Do any other automated setup that you need to do here

data/human_enum.gemspec

@@ -8,7 +8,10 @@ Gem::Specification.new do |spec|
   spec.name          = 'human_enum'
   spec.version       = HumanEnum::VERSION
   spec.authors       = ['Rafael Soares']
-  spec.email         = ['rafasoaresms@gmail.com']
+  spec.email         = ['893971+rafasoares@users.noreply.github.com']
+
+  # Should always be the lowest maintained version of Ruby
+  spec.required_ruby_version = '>= 3.1'
 
   spec.summary       = 'Adds simple and easy I18n support for Rails enums'
   spec.description   = 'This gem allows you to specify enum value translations
@@ -19,7 +22,8 @@ Gem::Specification.new do |spec|
 
   spec.metadata['homepage_uri'] = spec.homepage
   spec.metadata['source_code_uri'] = 'https://github.com/rafasoares/human_enum'
-  spec.metadata['changelog_uri'] = 'https://github.com/rafasoares/human_enum/blob/master/CHANGELOG.md'
+  spec.metadata['changelog_uri'] = 'https://github.com/rafasoares/human_enum/blob/main/CHANGELOG.md'
+  spec.metadata['rubygems_mfa_required'] = 'true'
 
   spec.files = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(test|spec|features)/})
@@ -28,19 +32,5 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'bundler', '~> 2.0'
-  spec.add_development_dependency 'rake', '~> 10.0'
-  spec.add_development_dependency 'rspec', '~> 3.0'
-
-  spec.add_development_dependency 'rubocop', '~> 0.72.0'
-  spec.add_development_dependency 'rubocop-performance', '~> 1.5'
-  spec.add_development_dependency 'rubocop-rspec', '~> 1.36'
-
-  spec.add_development_dependency 'guard', '~> 2.15'
-  spec.add_development_dependency 'guard-rspec', '~> 4.7'
-  spec.add_development_dependency 'guard-rubocop', '~> 1.3'
-
-  spec.add_development_dependency 'sqlite3', '~> 1.4'
-
-  spec.add_dependency 'activerecord', '> 5.0.0'
+  spec.add_dependency 'activerecord', '>= 6.1', '< 8'
 end

data/lib/human_enum/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HumanEnum
-  VERSION = '0.1.2'
+  VERSION = '1.1.2'
 end

data/lib/human_enum.rb

@@ -1,8 +1,10 @@
 # frozen_string_literal: true
 
 require 'human_enum/version'
+require 'active_support'
 require 'active_support/concern'
 require 'active_support/core_ext/array'
+require 'active_support/core_ext/module/deprecation'
 require 'active_model/naming'
 require 'active_model/translation'
 require 'active_record/type'
@@ -18,25 +20,67 @@ module HumanEnum
 
   extend ActiveSupport::Concern
 
+  class << self
+    def deprecator = @deprecator ||= ActiveSupport::Deprecation.new('2.0', 'HumanEnum')
+  end
+
   included do
-    def human_enum_value(enum_name)
-      enum_value = send enum_name
-      self.class.human_enum_value(enum_name, enum_value) unless enum_value.nil?
+    # DEPRECATED: This method is deprecated and will be removed in future versions.
+    #
+    # Returns the human-readable value of the specified enum.
+    #
+    # @param enum_name [Symbol] The name of the enum.
+    # @return [String] The human-readable value of the enum.
+    # @deprecated Use `human_<enum_name>` instead.
+    # :nocov:
+    def human_enum_value(enum_name, enum_value)
+      _translate_enum(enum_name, enum_value)
+    end
+    # :nocov:
+
+    deprecate(human_enum_value: 'use `human_<enum_name>` instead', deprecator: HumanEnum.deprecator)
+
+    private
+
+    def _translate_enum(enum_name, enum_value = send(enum_name))
+      self.class.send(:_translate_enum, enum_name, enum_value)
     end
   end
 
-  class_methods do
-    def enum(definitions)
-      super definitions
+  class_methods do # rubocop:disable Metrics/BlockLength
+    def enum(...)
+      super(...).tap { humanize_enums }
+    end
 
-      definitions.keys.without(:_prefix, :_suffix).each do |name|
-        human_enum name
+    # DEPRECATED: This method is deprecated and will be removed in future versions.
+    #
+    # Translates the given enum value into a human-readable string.
+    #
+    # @param enum_name [Symbol] The name of the enum.
+    # @param enum_value [Symbol] The value of the enum.
+    # @return [String] The human-readable string representation of the enum value.
+    # @deprecated Use `human_<plural_enum_name>` instead.
+    # :nocov:
+    def human_enum_value(enum_name, enum_value)
+      _translate_enum(enum_name, enum_value)
+    end
+    # :nocov:
+
+    deprecate(human_enum_value: 'use `human_<plural_enum_name>` instead', deprecator: HumanEnum.deprecator)
+
+    # Goes through all enums defined in the model and creates the necessary methods, if they don't exist yet.
+    def humanize_enums
+      defined_enums.each do |enum_name, values|
+        _define_instance_method(enum_name)
+        _define_class_method(enum_name, values)
       end
     end
 
-    def human_enum_value(enum_name, enum_value)
+    private
+
+    def _translate_enum(enum_name, enum_value)
       attributes_scope = "#{i18n_scope}.attributes"
-      enum_key = "#{enum_name.to_s.pluralize}.#{enum_value}"
+      enum_key = [enum_name.to_s.pluralize, enum_value].compact.join('.')
 
       defaults = lookup_ancestors.map do |klass|
         :"#{attributes_scope}.#{klass.model_name.i18n_key}.#{enum_key}"
@@ -45,17 +89,23 @@ module HumanEnum
       defaults << :"attributes.#{enum_key}"
       defaults << enum_value.to_s.humanize
 
-      I18n.translate defaults.shift, default: defaults
+      I18n.t defaults.shift, default: defaults
     end
 
-    def human_enum(enum_name)
-      send :define_method, "human_#{enum_name}" do
-        human_enum_value enum_name
+    def _define_instance_method(enum_name)
+      return if method_defined?(:"human_#{enum_name}")
+
+      define_method(:"human_#{enum_name}") do
+        _translate_enum(enum_name, send(enum_name))
       end
+    end
 
+    def _define_class_method(enum_name, values)
       collection_name = enum_name.to_s.pluralize
+      return if respond_to?(:"human_#{collection_name}")
+
       self.class.send :define_method, "human_#{collection_name}" do
-        human_enum_value enum_name, nil
+        values.to_h { |key, _| [key.to_sym, _translate_enum(enum_name, key)] }
       end
     end
   end

metadata

@@ -1,198 +1,74 @@
 --- !ruby/object:Gem::Specification
 name: human_enum
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 1.1.2
 platform: ruby
 authors:
 - Rafael Soares
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-10-12 00:00:00.000000000 Z
+date: 2024-10-29 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.72.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.72.0
-- !ruby/object:Gem::Dependency
-  name: rubocop-performance
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.5'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.5'
-- !ruby/object:Gem::Dependency
-  name: rubocop-rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.36'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.36'
-- !ruby/object:Gem::Dependency
-  name: guard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.15'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.15'
-- !ruby/object:Gem::Dependency
-  name: guard-rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '4.7'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '4.7'
-- !ruby/object:Gem::Dependency
-  name: guard-rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.3'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.3'
-- !ruby/object:Gem::Dependency
-  name: sqlite3
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.4'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.4'
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 5.0.0
+        version: '8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 5.0.0
+        version: '6.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8'
 description: |-
   This gem allows you to specify enum value translations
       like any other ActiveRecord attribute and adds helper methods to get
       humanized translations of enum values
 email:
-- rafasoaresms@gmail.com
+- 893971+rafasoares@users.noreply.github.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/FUNDING.yml"
-- ".github/workflows/gempush.yml"
+- ".codeclimate.yml"
+- ".devcontainer/devcontainer.json"
+- ".github/dependabot.yml"
+- ".github/workflows/publish.yml"
+- ".github/workflows/test-results.yml"
+- ".github/workflows/tests.yml"
 - ".gitignore"
 - ".hound.yml"
 - ".rspec"
 - ".rubocop.yml"
 - ".ruby-gemset"
 - ".ruby-version"
-- ".semaphore/semaphore.yml"
 - ".travis.yml"
+- ".vscode/settings.json"
 - CHANGELOG.md
+- CODEOWNERS
 - CODE_OF_CONDUCT.md
 - Gemfile
 - Gemfile.lock
+- Gemfile.rails-6.1.lock
+- Gemfile.rails-7.0.lock
+- Gemfile.rails-7.1.lock
 - Guardfile
 - LICENSE.txt
 - README.md
 - Rakefile
 - bin/console
+- bin/rake
+- bin/rspec
 - bin/setup
 - human_enum.gemspec
 - lib/human_enum.rb
@@ -203,7 +79,8 @@ licenses:
 metadata:
   homepage_uri: https://github.com/rafasoares/human_enum
   source_code_uri: https://github.com/rafasoares/human_enum
-  changelog_uri: https://github.com/rafasoares/human_enum/blob/master/CHANGELOG.md
+  changelog_uri: https://github.com/rafasoares/human_enum/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -212,14 +89,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.5.22
 signing_key: 
 specification_version: 4
 summary: Adds simple and easy I18n support for Rails enums

data/.github/FUNDING.yml

@@ -1,12 +0,0 @@
-# These are supported funding model platforms
-
-github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
-patreon: # Replace with a single Patreon username
-open_collective: # Replace with a single Open Collective username
-ko_fi: # Replace with a single Ko-fi username
-tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
-community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
-liberapay: rafasoares # Replace with a single Liberapay username
-issuehunt: # Replace with a single IssueHunt username
-otechie: # Replace with a single Otechie username
-custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

data/.github/workflows/gempush.yml

@@ -1,41 +0,0 @@
-name: Ruby Gem
-
-on:
-  push:
-    branches:
-      - master
-
-jobs:
-  build:
-    name: Build + Publish
-    runs-on: ubuntu-latest
-
-    steps:
-    - uses: actions/checkout@master
-    - name: Set up Ruby 2.6
-      uses: actions/setup-ruby@v1
-      with:
-        version: 2.6.x
-
-    - name: Publish to GPR
-      run: |
-        mkdir -p $HOME/.gem
-        touch $HOME/.gem/credentials
-        chmod 0600 $HOME/.gem/credentials
-        printf -- "---\n:github: Bearer ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
-        gem build *.gemspec
-        gem push --KEY github --host https://rubygems.pkg.github.com/${OWNER} *.gem
-      env:
-        GEM_HOST_API_KEY: ${{secrets.GPR_AUTH_TOKEN}}
-        OWNER: rafasoares
-
-    - name: Publish to RubyGems
-      run: |
-        mkdir -p $HOME/.gem
-        touch $HOME/.gem/credentials
-        chmod 0600 $HOME/.gem/credentials
-        printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
-        gem build *.gemspec
-        gem push *.gem
-      env:
-        GEM_HOST_API_KEY: ${{secrets.RUBYGEMS_AUTH_TOKEN}}

data/.semaphore/semaphore.yml

@@ -1,52 +0,0 @@
-version: v1.0
-name: Human Enum
-agent:
-  machine:
-    type: e1-standard-2
-    os_image: ubuntu1804
-  containers:
-    - name: main
-      image: 'ruby:2.6.4'
-      env_vars:
-        - name: BUNDLER_VERSION
-          value: 2.0.2
-blocks:
-  - name: Setup
-    task:
-      jobs:
-        - name: bundle
-          commands:
-            - bundle install --deployment -j 4 --path vendor/bundle
-      prologue:
-        commands:
-          - checkout
-          - cache restore
-          - gem install bundler -v $BUNDLER_VERSION
-      epilogue:
-        on_pass:
-          commands:
-            - cache store
-  - name: Code scanning
-    task:
-      jobs:
-        - name: check style
-          commands:
-            - bundle exec rubocop
-      prologue:
-        commands:
-          - checkout
-          - cache restore
-          - gem install bundler -v $BUNDLER_VERSION
-          - bundle install --deployment --path vendor/bundle
-  - name: Unit tests
-    task:
-      prologue:
-        commands:
-          - checkout
-          - cache restore
-          - gem install bundler -v $BUNDLER_VERSION
-          - bundle install --deployment --path vendor/bundle
-      jobs:
-        - name: RSpec
-          commands:
-            - bundle exec rake spec