simple_symbolize 3.0.0 → 4.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fcd4f78253aed92cf1895fd948418deac6fe69f2e3ce80efae55eb79556b157c
-  data.tar.gz: 7cefb49253c485e825b05e27bf6fcf020f4ef24f1995cc0ab1590e76a5ef0aed
+  metadata.gz: 5fe69f67b8c3e4152dd088e6425f0a0e9c0c5206ff384bd599284f976b664e4e
+  data.tar.gz: d8ce3414da304b386a71e83f482bd3dc2a031274c61dbe8d69efbab1d9dc819a
 SHA512:
-  metadata.gz: fee566211bb3708c7f3225897008f9f5434fbaa8840f3fcab3b50d7031e74263a4b14a39fbf383834bbd3948cb4020457e00c6d83777f3235fa7d3d77877f312
-  data.tar.gz: a453a5a9be5d81ea8198f21b5fbd0fc1663f71f58f6051a9aa3ebc7c87893d76413d7b1c38b3e184032a7b773ed9ecabe92374f88fb467853ab986a55d17e57b
+  metadata.gz: da85cabac7e7f368cfd7a0366dffa7642e6f0b27f2cbac49b548264df55f82eb715d74cf80e2113a172b7451b2496a86ddcbc13ef818d66e8b7f72aa8df80ff1
+  data.tar.gz: 82a0bd3a48cecbf2ca49607dd136cc8dc46a3babb761507b88a74043a494f396fbe6e7ecc53393c5a2d065e2f8d0302ccfdf80dfe6cb2412d3188091f15d2f44

data/.github/workflows/ruby.yml

@@ -18,7 +18,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby-version: [ '3.0', '3.1', '3.2' ]
+        ruby-version: [ '3.2', '3.3', '3.4' ]
 
     steps:
     - uses: actions/checkout@v2

data/.github/workflows/ruby_gem.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby-version: [ '3.0', '3.1', '3.2' ]
+        ruby-version: [ '3.2', '3.3', '3.4' ]
 
     steps:
       - uses: actions/checkout@v2

data/.rubocop.yml

@@ -27,4 +27,7 @@ Metrics/MethodLength:
   Max: 25
 
 Layout/LineLength:
-  Max: 130
+  Max: 130
+
+Metrics/CyclomaticComplexity:
+  Max: 8

data/.ruby-version

@@ -1 +1 @@
-3.2.2
+3.4.5

data/Gemfile

@@ -4,3 +4,8 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in simple_symbolize.gemspec
 gemspec
+
+gem 'rake', '~> 13.3'
+gem 'rspec', '~> 3.13'
+gem 'rubocop', '~> 1.79'
+gem 'simplecov', '~> 0.22'

data/README.md

@@ -17,7 +17,7 @@ It works by removing special characters in a String like `'!'` and underscoring
 'hello world!'.to_sym # => :"hello world!"
 
 # Symbolize gem
-'hello world!'.symbolize # => :hello_world
+'hello world!'.simple_symbolize # => :hello_world
 ```
 
 ## Installation
@@ -53,7 +53,19 @@ SimpleSymbolize.symbolize('hello world!') # => :hello_world
 ```ruby
 require 'simple_symbolize'
 
-'hello world!'.symbolize # => :hello_world
+String.include SimpleSymbolize::CoreExt::String
+
+'hello world!'.simple_symbolize # => :hello_world
+```
+
+### Call the symbolize method on your Symbol object
+
+```ruby
+require 'simple_symbolize'
+
+Symbol.include SimpleSymbolize::CoreExt::Symbol
+
+:hello_world!.simple_symbolize # => :hello_world
 ```
 
 ## Configuration
@@ -72,15 +84,51 @@ end
 
 ## Updates!
 
+### V4.1
+### Symbol methods can now be Mixed in
+
+SimpleSymbolize now supports mixing in the methods on the Symbol class, allowing you to call `simple_symbolize` directly on a Symbol object.
+
+```ruby
+Symbol.include SimpleSymbolize::CoreExt::Symbol
+:hello_world!.simple_symbolize # => :hello_world
+```
+
+### V4
+#### String methods now need to be Mixed in
+
+SimpleSymbolize is safe to use with other gems, particularly the popular ActiveSupport gem which SimpleSymbolize use to share 
+certain methods names with.
+
+You now need to deliberately mixin the methods on the String class:
+
+```ruby
+String.include SimpleSymbolize::CoreExt::String
+```
+
+To make them easier to spot, the method names on the String class have been prefixed with `simple_` to avoid confusion.
+
+```ruby
+'Hello World!'.simple_symbolize #=> :hello_world
+'Hello World!'.simple_elementize #=> 'hello_world'
+'Hello World!'.simple_camelize #=> :helloWorld
+'Hello World!'.simple_snakeize #=> :hello_world
+```
+
+#### Introducing #snakeize
+
+The `#snakeize` method will return your object in snake_case.
+This is the default behaviour of the `#symbolize` method however `#snakeize` will always return thr Symbol in snake_case.
+
 ### V3
-#### String to_snake_case
+#### String to_snake_case [DEPRECATED - replaced with `#simple_snakeize` in v4]
 
 `#to_snake_case` extends the String class to return you your String object in snake_case format.
 
 #### Handle camelCase with Symbolize
 
 ```ruby
-symbolize('helloWorld!') # => :hello_world
+SimpleSymbolize.symbolize('helloWorld!') # => :hello_world
 ```
 
 This is the default behaviour and can be switched off by setting `#handle_camel_case` to `false`
@@ -109,7 +157,7 @@ Sometimes you just want a simple String obj without all the fuss. Elementize tak
 and returns you a simple-to-use String.
 
 ```ruby
-elementize('hello world!') # => "hello_world"
+SimpleSymbolize.elementize('hello world!') # => "hello_world"
 ```
 
 #### Camelize

data/lib/simple_symbolize/core_ext/string/symbolize.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# Extends the String class by mixing in the symbolize module.
+# @example Mixin the methods to the String class
+#   String.include SimpleSymbolize::CoreExt::String
+
+module SimpleSymbolize
+  module CoreExt
+    # Contains methods to be mixed into the String class
+    module String
+      # @example Symbolize a string using the String object method
+      #   "hello world!".symbolize #=> :hello_world
+      def simple_symbolize
+        SimpleSymbolize.symbolize(self)
+      end
+
+      # @example Turns a String into a camelCase Symbol
+      #   "Hello World".simple_camelize => :helloWorld
+      def simple_camelize
+        SimpleSymbolize.camelize(self)
+      end
+
+      # @example Symbolizes a String then calls #to_s
+      #   "helloWorld".simple_elementize => 'hello_word'
+      def simple_elementize
+        SimpleSymbolize.elementize(self)
+      end
+
+      # @example Turns a String into it's snake_case equivalent
+      #   "helloWorld".simple_snakeize => 'hello_word'
+      def simple_snakeize
+        SimpleSymbolize.snakeize(self)
+      end
+    end
+  end
+end

data/lib/simple_symbolize/core_ext/symbol/symbolize.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# Extends the Symbol class by mixing in the symbolize module.
+# @example Mixin the methods to the Symbol class
+#   Symbol.include SimpleSymbolize::CoreExt::Symbol
+
+module SimpleSymbolize
+  module CoreExt
+    # Contains methods to be mixed into the String class
+    module Symbol
+      # @example Symbolize a string using the String object method
+      #   :hello_world!.symbolize #=> :hello_world
+      def simple_symbolize
+        SimpleSymbolize.symbolize(self)
+      end
+
+      # @example Turns a String into a camelCase Symbol
+      #   :hello_world.simple_camelize => :helloWorld
+      def simple_camelize
+        SimpleSymbolize.camelize(self)
+      end
+
+      # @example Symbolizes a String then calls #to_s
+      #   :helloWorld!.simple_elementize => 'hello_word'
+      def simple_elementize
+        SimpleSymbolize.elementize(self)
+      end
+
+      # @example Turns a String into it's snake_case equivalent
+      #   :helloWorld.simple_snakeize => :hello_word
+      def simple_snakeize
+        SimpleSymbolize.snakeize(self)
+      end
+    end
+  end
+end

data/lib/simple_symbolize/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SimpleSymbolize
-  VERSION = '3.0.0'
+  VERSION = '4.1.0'
 end

data/lib/simple_symbolize.rb

@@ -2,10 +2,9 @@
 
 require 'simple_symbolize/version'
 
-require_relative 'simple_symbolize/string'
 require_relative 'simple_symbolize/translations'
-
-include SimpleSymbolize
+require_relative 'simple_symbolize/core_ext/string/symbolize'
+require_relative 'simple_symbolize/core_ext/symbol/symbolize'
 
 # Main module for the gem
 # Contains the base methods and allows configuration
@@ -31,18 +30,21 @@ module SimpleSymbolize
   # @param obj [Object] the String object to be symbolized.
   #
   # @example Symbolize a string using the symbolize method
-  #   symbolize("hello world!") #=> :hello_world
-  def symbolize(obj)
+  #   SimpleSymbolize.symbolize("hello world!") #=> :hello_world
+  def self.symbolize(obj)
     return obj unless obj.respond_to?(:to_s)
     return obj if [Hash, Array, NilClass].include?(obj.class)
+    return obj if obj.respond_to?(:empty?) && obj.empty?
 
-    str = obj.to_s
-    str = str.to_snake_case if SimpleSymbolize.translations.handle_camel_case
-
-    str.downcase
-       .gsub(Regexp.union(SimpleSymbolize.translations.underscore), '_')
-       .gsub(Regexp.union(SimpleSymbolize.translations.remove), '')
-       .to_sym
+    obj = if SimpleSymbolize.translations.handle_camel_case
+            snakeize(obj)
+          else
+            obj.to_s
+               .downcase
+               .gsub(Regexp.union(SimpleSymbolize.translations.underscore), '_')
+               .gsub(Regexp.union(SimpleSymbolize.translations.remove), '')
+          end
+    obj.to_sym
   end
 
   # Symbolizes a String object and returns it as a String object.
@@ -50,10 +52,11 @@ module SimpleSymbolize
   # @param obj [Object] the object to be symbolized.
   #
   # @example Elementize a string using the elementize method
-  #   elementize("hello world!") #=> "helloWorld"
-  def elementize(obj)
+  #   SimpleSymbolize.elementize("hello world!") #=> "helloWorld"
+  def self.elementize(obj)
     return obj unless obj.respond_to?(:to_s)
     return obj if [Hash, Array, NilClass].include?(obj.class)
+    return obj if obj.respond_to?(:empty?) && obj.empty?
 
     symbolize(obj).to_s
   end
@@ -63,14 +66,35 @@ module SimpleSymbolize
   # @param obj [Object] the String object to be camelized.
   #
   # @example Camelize a string using the camelize method
-  #   camelize("hello world!") #=> :helloWorld
-  def camelize(obj)
+  #   SimpleSymbolize.camelize("hello world!") #=> :helloWorld
+  def self.camelize(obj)
     return obj unless obj.respond_to?(:to_s)
     return obj if [Hash, Array, NilClass].include?(obj.class)
+    return obj if obj.respond_to?(:empty?) && obj.empty?
 
     first, *rest = elementize(obj).split('_')
     return obj if first.nil?
 
     rest.size.positive? ? (first << rest.map(&:capitalize).join).to_sym : symbolize(first)
   end
+
+  # Turns a String || Symbol into a snake_case Symbol
+  #
+  # @param obj [Object] the object to be snakeize
+  #
+  # @example Snakeize an object using the snakeize method
+  #   SimpleSymbolize.snakeize('Hello World!') #=> :hello_world
+  def self.snakeize(obj)
+    return obj unless obj.respond_to?(:to_s)
+    return obj if [Hash, Array, NilClass].include?(obj.class)
+    return obj if obj.respond_to?(:empty?) && obj.empty?
+
+    obj.to_s
+       .gsub(Regexp.union(SimpleSymbolize.translations.underscore), '_')
+       .gsub(Regexp.union(SimpleSymbolize.translations.remove), '')
+       .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+       .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+       .downcase
+       .to_sym
+  end
 end

data/simple_symbolize.gemspec

@@ -5,7 +5,7 @@ require_relative 'lib/simple_symbolize/version'
 Gem::Specification.new do |spec|
   spec.name          = 'simple_symbolize'
   spec.version       = SimpleSymbolize::VERSION
-  spec.authors       = ['alexo']
+  spec.authors       = ['alexo', 'Driver and Vehicle Licensing Agency (DVLA)']
   spec.email         = ['']
 
   spec.summary       = 'Turns Strings into Symbols.'
@@ -18,11 +18,8 @@ Gem::Specification.new do |spec|
   spec.license       = 'MIT'
   spec.required_ruby_version = Gem::Requirement.new('>= 3.0')
 
-  # spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
-
   spec.metadata['homepage_uri'] = spec.homepage
   spec.metadata['source_code_uri'] = spec.homepage
-  # spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
@@ -32,9 +29,4 @@ Gem::Specification.new do |spec|
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
-
-  spec.add_development_dependency 'pry', '~> 0.14'
-  spec.add_development_dependency 'rake', '~> 13.0'
-  spec.add_development_dependency 'rspec', '~> 3.12'
-  spec.add_development_dependency 'rubocop', '~> 1.54'
 end

metadata

@@ -1,71 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: simple_symbolize
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 4.1.0
 platform: ruby
 authors:
 - alexo
-autorequire: 
+- Driver and Vehicle Licensing Agency (DVLA)
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-07-21 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: pry
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.14'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.14'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.12'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.12'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.54'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.54'
+date: 2025-08-01 00:00:00.000000000 Z
+dependencies: []
 description: 'simple_symbolize will remove special characters from a String, replacing
   whitespace with an underscore, down-casing and finally calling the #to_sym String
   method. Configure this gem to your hearts content!'
@@ -88,7 +33,8 @@ files:
 - bin/console
 - bin/setup
 - lib/simple_symbolize.rb
-- lib/simple_symbolize/string.rb
+- lib/simple_symbolize/core_ext/string/symbolize.rb
+- lib/simple_symbolize/core_ext/symbol/symbolize.rb
 - lib/simple_symbolize/translations.rb
 - lib/simple_symbolize/version.rb
 - simple_symbolize.gemspec
@@ -98,7 +44,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/dvla/simple-symbolize
   source_code_uri: https://github.com/dvla/simple-symbolize
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -114,7 +60,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.2.15
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Turns Strings into Symbols.
 test_files: []

data/lib/simple_symbolize/string.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-require 'simple_symbolize'
-
-# Extends the String class by mixing in the symbolize module.
-class String
-  # @example Symbolize a string using the String object method
-  #   "hello world!".symbolize #=> :hello_world
-  def symbolize
-    SimpleSymbolize.symbolize(self)
-  end
-
-  # @example Turns a String into it's snake_case equivalent
-  #   "helloWorld".to_snake_case => 'hello_word'
-  def to_snake_case
-    # rubocop:disable Style/RedundantSelf
-    self.gsub(/([a-z\d])([A-Z])/, '\1_\2')
-        .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
-        .downcase
-    # rubocop:enable Style/RedundantSelf
-  end
-end