dm_ruby_extensions 1.5.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a52656d8cd06524cb3619c98f8ee54221bbe7099bd8583ac3f6635a3fca73ad1
-  data.tar.gz: 8563dfd8ae1a2d76e5d07fbc6d4b09ce84f01f0970de0344ed6da46bb69f3819
+  metadata.gz: 36e22b14857c9ce862d6610260ebf28c314982649a0a69e6e04cf37bd74fad25
+  data.tar.gz: 1002cd447ad89971c298c3eeb3f21069302491667781546c82de05b28beb3521
 SHA512:
-  metadata.gz: 58dc5a359f374ca974e993472c29ea2649a0855856f03335bd276f5aed0bedb490dee6ea34309e714cbdbce9253c54fdb5ca5c02fa3115b0acf64d681b689b83
-  data.tar.gz: 7e9f70201a41ac2f623214e27af7cd1549984174e4f5bea5e578a8f8898a18f931a546799293feba8449918402f77ac51ea4f2e5ca100f3124fb3d5499f862dd
+  metadata.gz: 60992cd05bf21a44458666b8bdd8d6e6e91360c53f259f930421b05ed1701b0e9f6b028c28842793007be1312e9c28a6036de6b5484ccae3a967b0a692b311bf
+  data.tar.gz: 52bf4954ecfcd7a36f1efb02a4b5fd72e671242ce5df1c95ae96b2150915b3b61abfbd4aec5fc53df9af512ec80d4a031b6c4d6cb90168590f6dfba5c8c6886f

data/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+## 1.6.0
+
+- Support Ruby 4.0: `required_ruby_version` is now `>= 3.2` (was `~> 3.0`, which
+  excluded Ruby 4).
+- Drop support for Ruby 3.0 and 3.1, which have reached end of life.
+- Limit ActiveSupport to `>= 6.0, < 9`.
+- Gemspec: package files with `Dir` instead of `git ls-files`, remove the
+  deprecated `test_files`, require MFA for publishing, and add source, changelog
+  and bug tracker links.
+- Replace the Travis build, which no longer ran, with GitHub Actions on Ruby 3.2
+  through 4.0.
+- Update RuboCop to 1.92 and rubocop-rspec to 3.10.
+- Fix a spec for `nil + other` that didn't actually test it.
+
+## 1.5.0
+
+- Drop support for Ruby 2.

data/README.md

@@ -1,94 +1,146 @@
 # DmRubyExtensions
 
 [![Gem Version](https://badge.fury.io/rb/dm_ruby_extensions.svg)](http://badge.fury.io/rb/dm_ruby_extensions)
-[![Build Status](https://travis-ci.com/digitalmoksha/dm_ruby_extensions.svg?branch=master)](https://travis-ci.com/digitalmoksha/dm_ruby_extensions)
+[![Build status](https://github.com/digitalmoksha/dm_ruby_extensions/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/digitalmoksha/dm_ruby_extensions/actions/workflows/ci.yml)
 
-Adds some simple convenience methods to some Ruby classes, for use in the digitalMoksha gems.
-Although some of these can be found in other libraries, this includes a small handful and
-removes the dependency on another large library.
+A small set of convenience methods added to Ruby's core classes (`String`, `Hash`,
+`Array`, `Date` and others). It's used by the digitalMoksha gems, such as
+[moksha_cms](https://gitlab.com/moksha_cms/moksha_cms), for formatting names and
+titles, building CSS and URLs, reading Rails date params, and similar everyday jobs.
 
-## Installation
-
-Add this line to your application's Gemfile:
-
-    gem 'dm_ruby_extensions'
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install dm_ruby_extensions
-
-## Usage
-
-#### Array
-
-* extract_options!
-* closest_max
-* xss_aware_join
-* css_join
-
-#### Date
-
-* to_age
-* localize
+## Requirements
 
-#### DateTime
+- Ruby 3.2 or later (CI covers 3.2 through 4.0)
+- ActiveSupport 6.0 or later
 
-* to_age
-* localize
+Requiring the gem also loads `active_support/core_ext`. The `localize` methods use
+`I18n`, which comes with ActiveSupport.
 
-#### Fixnum
-
-* factorial
-* as_boolean
-
-#### Hash
-
-* convert_date
-* convert_datetime
-* url_query_string
-* rekey
-* rekey!
-
-#### Nil
-
-* to_s_default
-* as_boolean
-* to_age
-* sql_wildcard
-
-#### Numeric
-
-* percent_of
-
-#### String
-
-* to_s_default
-* as_boolean
-* as_css_size
-* sql_wildcard
-* replace_non_alphanumeric
-* expand_url
-* absolute_url?
-* smart_titlecase
-* smart_capitalize
-* smart_capitalize!
-* smart_truncate
-* name_case
-* name_case!
+## Installation
 
-#### Time
+Add it to your Gemfile:
+
+```ruby
+gem 'dm_ruby_extensions'
+```
+
+and run `bundle install`. In a Rails app it's loaded by Bundler; elsewhere, add
+`require 'dm_ruby_extensions'`.
+
+## What it adds
+
+### String
+
+| Method | Description |
+|---|---|
+| `to_s_default(default = 'n/a')` | The string, or `default` if it's empty or only whitespace |
+| `as_boolean` | `true` for `'true'`, `'yes'` or `'1'`, otherwise `false` |
+| `as_css_size` | Adds `px` unless the value already has `px`, `%` or `em`, or is `auto`/`inherit` |
+| `sql_wildcard` | Wraps the string in `%` for a SQL `LIKE` |
+| `replace_non_alphanumeric(replacement = '')` | Replaces everything except letters, digits, `_`, `.` and `-` |
+| `sanitize_filename` | Strips any path (Unix or Windows) and replaces unsafe characters with `_` |
+| `expand_url(path = '')` | Prefixes a relative URL with `path`; absolute URLs are returned unchanged |
+| `absolute_url?` | `true` if the string contains `://` or starts with `/` |
+| `smart_titlecase` | Title case that keeps small words lowercase (Ruby port of John Gruber's TitleCase) |
+| `smart_capitalize` / `smart_capitalize!` | Capitalizes the first real letter, leaving words like `iPhone` alone |
+| `smart_truncate(words: 12)` / `smart_truncate(sentences: n)` | Truncates by words or sentences and appends `...` |
+| `name_case` / `name_case!` | Properly cases names, e.g. `McDonald`, `O'Brien` (port of Lingua::EN::NameCase) |
+
+```ruby
+'300'.as_css_size                            #=> "300px"
+'images/logo.png'.expand_url('/assets')      #=> "/assets/images/logo.png"
+'C:\docs\my report.pdf'.sanitize_filename    #=> "my_report.pdf"
+'the lord of the rings'.smart_titlecase      #=> "The Lord of the Rings"
+'one two three four five'.smart_truncate(words: 3)  #=> "one two three..."
+'MCDONALD'.name_case                         #=> "McDonald"
+```
+
+### Hash
+
+| Method | Description |
+|---|---|
+| `convert_date(attribute)` | Builds a `Date` from Rails date-select params (`attr(1i)`–`attr(3i)`), or `nil` |
+| `convert_datetime(attribute)` | Builds a local `Time` from Rails datetime-select params (`attr(1i)`–`attr(5i)`), or `nil` |
+| `url_query_string(leading_slash = true)` | Turns the hash into a query string, e.g. `"/?page=2&q=yoga"` |
+| `rekey` / `rekey!` | Renames keys with a key map or a block; with neither, symbolizes all keys (from [Facets](https://github.com/rubyworks/facets)) |
+
+```ruby
+params = { 'start_date(1i)' => '2026', 'start_date(2i)' => '11', 'start_date(3i)' => '8' }
+params.convert_date(:start_date)   #=> Sun, 08 Nov 2026
+{ page: 2, q: 'yoga' }.url_query_string   #=> "/?page=2&q=yoga"
+{ a: 1, b: 2 }.rekey(a: 'x')       # 'x' => 1, :b => 2
+```
+
+### Array
+
+| Method | Description |
+|---|---|
+| `extract_options!` | Removes and returns a trailing options hash, or `{}` |
+| `closest_max(value)` | The largest element that is less than or equal to `value` |
+| `xss_aware_join(delimiter = '')` | Joins into an `html_safe` string, escaping elements that aren't already safe |
+| `css_join` | Joins CSS class names, skipping `nil` and empty strings; returns `nil` if nothing is left, so Rails leaves the attribute out |
+
+```ruby
+[0, 5, 7, 8, 11, 16].closest_max(6)          #=> 5
+['btn', nil, '', 'btn-primary'].css_join     #=> "btn btn-primary"
+[nil, ''].css_join                           #=> nil
+```
+
+### Date, DateTime and Time
+
+| Method | Description |
+|---|---|
+| `Date#to_age`, `DateTime#to_age` | Age in whole years, e.g. from a birth date |
+| `Date#to_index`, `DateTime#to_index` | A sortable integer for the day: day of year + (year − 2000) × 1000 |
+| `localize(options = {})` | `I18n.localize(self, ...)`; a string argument is taken as the `format` |
+
+### Numbers and booleans
+
+| Method | Description |
+|---|---|
+| `Integer#factorial` | `5.factorial #=> 120` |
+| `Integer#as_boolean` | `true` for positive numbers, otherwise `false` |
+| `Numeric#percent_of(total, precision = 0)` | `25.percent_of(80) #=> 31`; returns `0` when `total` is zero |
+| `TrueClass#as_boolean`, `FalseClass#as_boolean` | Return themselves, so `as_boolean` works on any of these values |
+
+### nil
+
+`nil` gets the same helpers, so you don't have to check for it first:
+
+| Method | Returns |
+|---|---|
+| `to_s_default(default = 'n/a')` | `default` |
+| `as_boolean` | `false` |
+| `to_age` | `0` |
+| `sql_wildcard` | `'%'` (matches everything) |
+| `utc` | `''` |
+| `+(other)` | `other`, so `nil + 5 #=> 5` |
+
+## Development
+
+```
+bundle install
+bundle exec rspec
+bundle exec rubocop
+```
+
+CI runs the specs on Ruby 3.2 through 4.0 (plus ruby-head) on Linux and macOS, and
+runs RuboCop, for every pull request and push to `master`.
+
+To release a new version, update `lib/dm_ruby_extensions/version.rb` and
+`CHANGELOG.md`, then:
+
+```
+gem build dm_ruby_extensions.gemspec
+gem push dm_ruby_extensions-<version>.gem
+```
 
-* localize
+## Contributing
 
+Bug reports and pull requests are welcome at
+<https://github.com/digitalmoksha/dm_ruby_extensions>. Please include specs for any
+change.
 
-## Contributing
+## License
 
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+MIT. See [LICENSE](LICENSE).

data/lib/dm_ruby_extensions/extend_date.rb

@@ -17,6 +17,6 @@ class Date
   # Create a unique sortable index for this date
   #------------------------------------------------------------------------------
   def to_index
-    yday + (year - 2000) * 1000
+    yday + ((year - 2000) * 1000)
   end
 end

data/lib/dm_ruby_extensions/extend_datetime.rb

@@ -16,6 +16,6 @@ class DateTime
   # Create a unique sortable index for this date
   #------------------------------------------------------------------------------
   def to_index
-    yday + (year - 2000) * 1000
+    yday + ((year - 2000) * 1000)
   end
 end

data/lib/dm_ruby_extensions/extend_hash.rb

@@ -30,11 +30,9 @@ class Hash
 
   # Convert hash of parameters to a query string
   #------------------------------------------------------------------------------
-  # rubocop:disable Style/OptionalBooleanParameter
-  def url_query_string(leading_slash = true)
+  def url_query_string(leading_slash = true) # rubocop:disable Style/OptionalBooleanParameter
     "#{leading_slash ? '/?' : '?'}#{to_query}"
   end
-  # rubocop:enable Style/OptionalBooleanParameter
 
   # Borrowed from https://github.com/rubyworks/facets
   #------------------------------------------------------------------------------
@@ -111,7 +109,7 @@ class Hash
   #
   # CREDIT: Trans, Gavin Kistner
 
-  def rekey!(key_map = nil, &block)
-    replace(rekey(key_map, &block))
+  def rekey!(key_map = nil, &)
+    replace(rekey(key_map, &))
   end
 end

data/lib/dm_ruby_extensions/extend_integer.rb

@@ -12,6 +12,6 @@ class Integer
 
   #------------------------------------------------------------------------------
   def as_boolean
-    positive? ? true : false
+    positive?
   end
 end

data/lib/dm_ruby_extensions/extend_string.rb

@@ -11,7 +11,7 @@ class String # :nodoc:
 
   #------------------------------------------------------------------------------
   def as_boolean
-    self == 'true' || self == 'yes' || self == '1' ? true : false
+    self == 'true' || self == 'yes' || self == '1'
   end
 
   # given a css type of size (like a width), make it into a valid css value
@@ -59,7 +59,7 @@ class String # :nodoc:
   # Test if a url is absolute
   #------------------------------------------------------------------------------
   def absolute_url?
-    include?('://') || start_with?('/') ? true : false
+    include?('://') || start_with?('/')
   end
 
   #------------------------------------------------------------------------------
@@ -88,13 +88,13 @@ class String # :nodoc:
     result = dup
 
     # ignore any leading crazy characters and capitalize the first real character
-    return result unless self =~ /^['"(\[']*([a-z])/
+    return result unless self =~ /^['"(\[]*([a-z])/
 
     i = index(::Regexp.last_match(1))
     x = result[i, result.length]
 
     # word with capitals and periods mid-word are left alone
-    result[i, 1] = result[i, 1].upcase unless x =~ (/[A-Z]/) || x =~ (/\.\w+/)
+    result[i, 1] = result[i, 1].upcase unless x =~ /[A-Z]/ || x =~ /\.\w+/
 
     result
   end
@@ -143,7 +143,7 @@ class String # :nodoc:
     localstring.gsub!(/'\w\b/, &:downcase) # Lowercase 's
 
     if options[:irish]
-      if localstring =~ (/\bMac[A-Za-z]{2,}[^aciozj]\b/) || localstring =~ (/\bMc/)
+      if localstring =~ /\bMac[A-Za-z]{2,}[^aciozj]\b/ || localstring =~ /\bMc/
         match = localstring.match(/\b(Ma?c)([A-Za-z]+)/)
         localstring.gsub!(/\bMa?c[A-Za-z]+/) { match[1] + match[2].capitalize }
 

data/lib/dm_ruby_extensions/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DmRubyExtensions
-  VERSION = '1.5.0'
+  VERSION = '1.6.0'
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: dm_ruby_extensions
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.6.0
 platform: ruby
 authors:
 - Brett Walker
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-22 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -17,6 +16,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -24,6 +26,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
 description: Ruby base class extensions
 email:
 - github@digitalmoksha.com
@@ -31,18 +36,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/workflow/ci.yml"
-- ".gitignore"
-- ".rspec"
-- ".rubocop.yml"
-- ".ruby-version"
-- ".travis.yml"
-- Gemfile
+- CHANGELOG.md
 - LICENSE
 - README.md
-- Rakefile
-- bin/console
-- dm_ruby_extensions.gemspec
 - lib/dm_ruby_extensions.rb
 - lib/dm_ruby_extensions/extend_array.rb
 - lib/dm_ruby_extensions/extend_date.rb
@@ -56,51 +52,29 @@ files:
 - lib/dm_ruby_extensions/extend_time.rb
 - lib/dm_ruby_extensions/extend_true.rb
 - lib/dm_ruby_extensions/version.rb
-- spec/extensions/array_spec.rb
-- spec/extensions/date_spec.rb
-- spec/extensions/datetime_spec.rb
-- spec/extensions/false_spec.rb
-- spec/extensions/hash_spec.rb
-- spec/extensions/integer_spec.rb
-- spec/extensions/nil_spec.rb
-- spec/extensions/numeric_spec.rb
-- spec/extensions/string_spec.rb
-- spec/extensions/time_spec.rb
-- spec/extensions/true_spec.rb
-- spec/spec_helper.rb
 homepage: https://github.com/digitalmoksha/dm_ruby_extensions
 licenses:
 - MIT
-metadata: {}
-post_install_message:
+metadata:
+  source_code_uri: https://github.com/digitalmoksha/dm_ruby_extensions
+  changelog_uri: https://github.com/digitalmoksha/dm_ruby_extensions/blob/master/CHANGELOG.md
+  bug_tracker_uri: https://github.com/digitalmoksha/dm_ruby_extensions/issues
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - "~>"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
-signing_key:
+rubygems_version: 4.0.11
 specification_version: 4
 summary: Simple Ruby base class extensions
-test_files:
-- spec/extensions/array_spec.rb
-- spec/extensions/date_spec.rb
-- spec/extensions/datetime_spec.rb
-- spec/extensions/false_spec.rb
-- spec/extensions/hash_spec.rb
-- spec/extensions/integer_spec.rb
-- spec/extensions/nil_spec.rb
-- spec/extensions/numeric_spec.rb
-- spec/extensions/string_spec.rb
-- spec/extensions/time_spec.rb
-- spec/extensions/true_spec.rb
-- spec/spec_helper.rb
+test_files: []

data/.github/workflow/ci.yml

@@ -1,41 +0,0 @@
-name: CI
-
-on:
-  pull_request:
-
-jobs:
-  rspec:
-    strategy:
-      fail-fast: false
-      matrix:
-        os:
-          - ubuntu-latest
-          - macos-latest
-        ruby-version: [3.0, 3.1, 3.2, 'ruby-head']
-
-    runs-on: ${{ matrix.os }}
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Ruby ${{ matrix.ruby-version }}
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: ${{ matrix.ruby-version }}
-          bundler-cache: true # 'bundle install' and cache
-
-      - name: Run ${{ matrix.os }} tests
-        run: bundle install
-        run: bundle exec rspec
-
-  rubocop:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Ruby ${{ matrix.ruby-version }}
-        uses: ruby/setup-ruby@v1
-      - name: Run rubocop
-        run: bundle install
-        run: bundle exec rubocop

data/.gitignore

@@ -1,17 +0,0 @@
-*.gem
-*.rbc
-.bundle
-.config
-.yardoc
-Gemfile.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp

data/.rspec

@@ -1,3 +0,0 @@
---color
---require spec_helper
---format documentation

data/.rubocop.yml

@@ -1,26 +0,0 @@
-AllCops:
-  Exclude:
-    - '**/tmp/**/*'
-  CacheRootDirectory: tmp
-  UseCache: false
-
-Metrics/BlockLength:
-  Enabled: false
-
-Metrics/MethodLength:
-  Enabled: false
-
-Metrics/AbcSize:
-  Enabled: false
-
-Metrics/CyclomaticComplexity:
-  Enabled: false
-
-Metrics/ClassLength:
-  Enabled: false
-
-Metrics/PerceivedComplexity:
-  Enabled: false
-
-Style/Documentation:
-  Enabled: false

data/.ruby-version

@@ -1 +0,0 @@
-3.2.2

data/.travis.yml

@@ -1,7 +0,0 @@
-language: ruby
-rvm:
-  - 2.3.7
-  - 2.4.4
-script:
-  - bundle install --jobs=3 --retry=3
-  - bundle exec rake spec

data/Gemfile

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-
-gemspec
-
-gem 'pry-byebug'
-gem 'rake'
-gem 'rspec'
-gem 'rubocop', '~> 1.36'
-gem 'rubocop-rspec', '~> 2.13'

data/Rakefile

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-require 'bundler/gem_tasks'
-require 'rspec/core/rake_task'
-
-RSpec::Core::RakeTask.new
-
-task default: :spec
-task test: :spec

data/bin/console

@@ -1,18 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require 'bundler/setup'
-require 'dm_ruby_extensions'
-require 'irb'
-
-puts <<~TEXT
-  -------------------
-  Example Usage:
-
-  '1'.as_boolean
-  (Date.today - 12.years).to_age
-  -------------------
-
-TEXT
-
-IRB.start(__FILE__)

data/dm_ruby_extensions.gemspec

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-lib = File.expand_path('lib', __dir__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'dm_ruby_extensions/version'
-
-Gem::Specification.new do |gem|
-  gem.name          = 'dm_ruby_extensions'
-  gem.version       = DmRubyExtensions::VERSION
-  gem.authors       = ['Brett Walker']
-  gem.email         = ['github@digitalmoksha.com']
-  gem.description   = 'Ruby base class extensions'
-  gem.summary       = 'Simple Ruby base class extensions'
-  gem.homepage      = 'https://github.com/digitalmoksha/dm_ruby_extensions'
-  gem.licenses      = ['MIT']
-
-  gem.files         = `git ls-files`.split($INPUT_RECORD_SEPARATOR)
-  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
-  gem.require_paths = ['lib']
-
-  gem.required_ruby_version = '~> 3.0'
-
-  gem.add_dependency 'activesupport', '>= 6.0'
-end

data/spec/extensions/array_spec.rb

@@ -1,40 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'dm_ruby_extensions'
-
-describe Array do
-  describe 'closest_max' do
-    #------------------------------------------------------------------------------
-    it 'return the value that is closest to the value in the array, rounded down' do
-      expect([0, 5, 7, 8, 11, 16].closest_max(6)).to eq 5
-      expect([0, 5, 7, 8, 11, 16].closest_max(7)).to eq 7
-    end
-  end
-
-  describe 'extract_options!' do
-    #------------------------------------------------------------------------------
-    it "Removes and returns the last element in the array if it's a hash, otherwise returns a blank hash" do
-      args = [1, 2, { a: :b }]
-      expect(args.extract_options!).to eq({ a: :b })
-      expect(args).to eq [1, 2]
-      expect(args.extract_options!).to eq({})
-    end
-  end
-
-  describe 'xss_aware_join' do
-    it 'safely join safe and unsafe strings' do
-      safe    = '<p>Safe</p>'.html_safe
-      unsafe  = '<script></script>'
-      expect([safe, unsafe].xss_aware_join).to eq '<p>Safe</p>&lt;script&gt;&lt;/script&gt;'
-      expect([safe, unsafe].xss_aware_join.class).to eq ActiveSupport::SafeBuffer
-    end
-  end
-
-  describe 'css_join' do
-    it 'given an array of css classes/styles, join them into one string' do
-      classes = ['panel', '', 'panel-body', nil, 'red']
-      expect(classes.css_join(' ')).to eq 'panel panel-body red'
-    end
-  end
-end

data/spec/extensions/date_spec.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'dm_ruby_extensions'
-
-describe Date do
-  describe 'to_age' do
-    it 'return number of years since now' do
-      expect(Date.new(Time.now.year - 50, Time.now.month, Time.now.day).to_age).to eq 50
-    end
-  end
-
-  describe 'localize' do
-    it 'localize the date based on the format' do
-      I18n.enforce_available_locales = false
-      I18n.locale = :en
-      date = Date.new(2012, 11, 23)
-      expect(date.localize).to eq '2012-11-23'
-      expect(date.localize(format: :short)).to eq 'Nov 23'
-      expect(date.localize('%b %Y')).to eq 'Nov 2012'
-    end
-  end
-
-  describe 'to_index' do
-    it 'creates unique sortable index for a date' do
-      date = Date.new(2012, 11, 23)
-      expect(date.to_index).to eq 12_328
-    end
-  end
-end

data/spec/extensions/datetime_spec.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'dm_ruby_extensions'
-
-describe DateTime do
-  describe 'to_age' do
-    it 'return number of years since now' do
-      expect(DateTime.new(Time.now.year - 50, Time.now.month, Time.now.day).to_age).to eq 50
-    end
-  end
-
-  describe 'localize' do
-    it 'localize the date based on the format' do
-      I18n.enforce_available_locales = false
-      I18n.locale = :en
-      date = DateTime.new(2012, 11, 23, 8, 35)
-      expect(date.localize).to eq 'Fri, 23 Nov 2012 08:35:00 +0000'
-      expect(date.localize(format: :short)).to eq '23 Nov 08:35'
-      expect(date.localize('%b %Y')).to eq 'Nov 2012'
-    end
-  end
-
-  describe 'to_index' do
-    it 'creates unique sortable index for a date' do
-      date = Date.new(2012, 11, 23)
-      expect(date.to_index).to eq 12_328
-    end
-  end
-end

data/spec/extensions/false_spec.rb

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'dm_ruby_extensions'
-
-describe FalseClass do
-  describe 'as_boolean' do
-    specify { expect(false.as_boolean).to eq false }
-  end
-end

data/spec/extensions/hash_spec.rb

@@ -1,58 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'dm_ruby_extensions'
-
-describe Hash do
-  describe 'convert_date' do
-    #------------------------------------------------------------------------------
-    it 'converts a rails date hash' do
-      datehash = { 'start_date(1i)' => 2012, 'start_date(2i)' => 11, 'start_date(3i)' => 23 }
-      expect(datehash.convert_date(:start_date)).to eq Date.new(2012, 11, 23)
-      expect(datehash.convert_date(:end_date)).to eq nil
-    end
-  end
-
-  describe 'convert_datetime' do
-    #------------------------------------------------------------------------------
-    it 'converts a rails datetime hash' do
-      datehash = { 'start_date(1i)' => 2012, 'start_date(2i)' => 11, 'start_date(3i)' => 23, 'start_date(4i)' => 8,
-                   'start_date(5i)' => 35 }
-      expect(datehash.convert_datetime(:start_date)).to eq Time.local(2012, 11, 23, 8, 35)
-      expect(datehash.convert_datetime(:end_date)).to eq nil
-    end
-  end
-
-  describe 'url_query_string' do
-    #------------------------------------------------------------------------------
-    it 'converts hash of parameters to a query string' do
-      params = { tag: 'shoe', as_admin: '1' }
-      expect(params.url_query_string).to eq '/?as_admin=1&tag=shoe'
-      expect(params.url_query_string(false)).to eq '?as_admin=1&tag=shoe'
-    end
-  end
-
-  describe 'rekey' do
-    #------------------------------------------------------------------------------
-    it 'if a key map is given, then the first key is changed to the second key.' do
-      foo = { a: 1, b: 2 }
-      expect(foo.rekey(a: 'a')).to eq({ 'a' => 1, :b => 2 })
-      expect(foo.rekey(b: :x)).to eq({ a: 1, x: 2 })
-      expect(foo.rekey('foo' => 'bar')).to eq({ a: 1, b: 2 })
-    end
-
-    #------------------------------------------------------------------------------
-    # rubocop:disable Style/SymbolProc
-    it 'converts all keys in the Hash accroding to the given block procedure' do
-      foo = { name: 'Gavin', wife: :Lisa }
-      expect(foo.rekey { |k| k.to_s }).to eq({ 'name' => 'Gavin', 'wife' => :Lisa })
-    end
-    # rubocop:enable Style/SymbolProc
-
-    #------------------------------------------------------------------------------
-    it 'converts all keys to symbols' do
-      foo = { 'name' => 'Gavin', 'wife' => :Lisa }
-      expect(foo.rekey).to eq({ name: 'Gavin', wife: :Lisa })
-    end
-  end
-end

data/spec/extensions/integer_spec.rb

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'dm_ruby_extensions'
-
-describe Integer do
-  describe 'factorial' do
-    #------------------------------------------------------------------------------
-    it 'return the factorial of the number' do
-      expect(5.factorial).to eq 120
-      expect(1.factorial).to eq 1
-    end
-  end
-
-  describe 'as_boolean' do
-    specify { expect(1.as_boolean).to be_truthy }
-    specify { expect(0.as_boolean).to be_falsey }
-    specify { expect(20.as_boolean).to be_truthy }
-  end
-end

data/spec/extensions/nil_spec.rb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'dm_ruby_extensions'
-
-describe NilClass do
-  describe 'to_s_default' do
-    it 'returns default string' do
-      expect(nil.to_s_default).to eq 'n/a'
-      expect(nil.to_s_default('--')).to eq '--'
-    end
-  end
-
-  describe 'as_boolean' do
-    specify { expect(nil.as_boolean).to eq false }
-  end
-
-  describe 'to_age' do
-    specify { expect(nil.to_age).to eq 0 }
-  end
-
-  describe 'sql_wildcard' do
-    specify { expect(nil.sql_wildcard).to eq '%' }
-  end
-
-  describe 'utc' do
-    specify { expect(nil.utc).to eq '' }
-  end
-
-  describe '+(y)' do
-    specify { expect(nil + 12).to eq 12 }
-    specify { expect('foo').to eq 'foo' }
-  end
-end

data/spec/extensions/numeric_spec.rb

@@ -1,14 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'dm_ruby_extensions'
-
-describe Numeric do
-  describe 'percent_of' do
-    it 'returns percentage of number' do
-      expect(25.percent_of(100)).to eq 25
-      expect(25.percent_of(80)).to eq 31
-      expect(25.percent_of(80, 2)).to eq 31.25
-    end
-  end
-end

data/spec/extensions/string_spec.rb

@@ -1,125 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'dm_ruby_extensions'
-
-describe String do
-  describe 'to_s_default' do
-    specify { expect('foobar'.to_s_default).to eq 'foobar' }
-    specify { expect(''.to_s_default).to eq 'n/a' }
-    specify { expect(''.to_s_default('--')).to eq '--' }
-  end
-
-  describe 'as_boolean' do
-    specify { expect('true'.as_boolean).to be_truthy }
-    specify { expect('yes'.as_boolean).to be_truthy }
-    specify { expect('1'.as_boolean).to be_truthy }
-    specify { expect('false'.as_boolean).to be_falsey }
-    specify { expect('foo'.as_boolean).to be_falsey }
-  end
-
-  describe 'as_css_size' do
-    specify { expect('50'.as_css_size).to eq '50px' }
-    specify { expect(''.as_css_size).to eq '' }
-    specify { expect('50px'.as_css_size).to eq '50px' }
-    specify { expect('50%'.as_css_size).to eq '50%' }
-    specify { expect('50em'.as_css_size).to eq '50em' }
-    specify { expect('auto'.as_css_size).to eq 'auto' }
-    specify { expect('inherit'.as_css_size).to eq 'inherit' }
-  end
-
-  describe 'sql_wildcard' do
-    specify { expect('foobar'.sql_wildcard).to eq '%foobar%' }
-  end
-
-  describe 'replace_non_alphanumeric' do
-    specify { expect('fo9o^()b  ar'.replace_non_alphanumeric).to eq 'fo9obar' }
-    specify { expect('fo9o^()b  ar'.replace_non_alphanumeric('*')).to eq 'fo9o***b**ar' }
-  end
-
-  describe 'sanitize_filename' do
-    specify { expect('foobar.doc'.sanitize_filename).to eq 'foobar.doc' }
-    specify { expect('/user/home/foobar.doc'.sanitize_filename).to eq 'foobar.doc' }
-    specify { expect('/user/home/f9o o(b+a^r.d*c'.sanitize_filename).to eq 'f9o_o_b_a_r.d_c' }
-  end
-
-  describe 'expand_url' do
-    specify { expect('/home/foobar.doc'.expand_url).to eq '/home/foobar.doc' }
-    specify { expect('/foobar.doc'.expand_url('/home/')).to eq '/foobar.doc' }
-    specify { expect('foobar.doc'.expand_url).to eq '/foobar.doc' }
-    specify { expect('foobar.doc'.expand_url('/home/')).to eq '/home/foobar.doc' }
-    specify { expect('foobar.doc'.expand_url('/home')).to eq '/home/foobar.doc' }
-  end
-
-  describe 'absolute_url?' do
-    specify { expect('/home/foo'.absolute_url?).to be_truthy }
-    specify { expect('://home/foo'.absolute_url?).to be_truthy }
-    specify { expect('home/foo'.absolute_url?).to be_falsey }
-  end
-
-  describe 'smart_titlecase' do
-    specify do
-      expect('a sample title and text: a treatsie'.smart_titlecase).to eq 'A Sample Title and Text: A Treatsie'
-    end
-  end
-
-  describe 'smart_capitalize' do
-    specify { expect('foobar'.smart_capitalize).to eq 'Foobar' }
-    specify { expect('fooBar'.smart_capitalize).to eq 'fooBar' }
-    specify { expect('(foobar)'.smart_capitalize).to eq '(Foobar)' }
-  end
-
-  describe 'smart_truncate' do
-    specify do
-      expect('One time. Two times. 3 times. 4 times.'.smart_truncate(sentences: 3))
-        .to eq 'One time. Two times. 3 times...'
-    end
-    specify do
-      expect('one two three and four five six and seven and yet another eight'.smart_truncate(words: 6))
-        .to eq 'one two three and four five...'
-    end
-    specify do
-      expect('one two three and four five six and seven and yet another eight'.smart_truncate)
-        .to eq 'one two three and four five six and seven and yet another...'
-    end
-  end
-
-  describe 'name_case' do
-    before :each do
-      @proper_names = [
-        'Keith',            'Leigh-Williams',       'McCarthy',
-        "O'Callaghan",      'St. John',             'von Streit',
-        'van Dyke',         'Van',                  'ap Llwyd Dafydd',
-        'al Fahd',          'Al',
-        'el Grecco',
-        'ben Gurion', 'Ben',
-        'da Vinci',
-        'di Caprio',        'du Pont',              'de Legate',
-        'del Crond',        'der Sind',             'van der Post',
-        'von Trapp',        'la Poisson',           'le Figaro',
-        'Mack Knife',       'Dougal MacDonald',
-        # Mac exceptions
-        'Machin',           'Machlin',              'Machar',
-        'Mackle',           'Macklin',              'Mackie',
-        'Macquarie',        'Machado',              'Macevicius',
-        'Maciulis',         'Macias',               'MacMurdo',
-        # Roman numerals
-        'Henry VIII',       'Louis III',            'Louis XIV',
-        'Charles II',       'Fred XLIX'
-      ]
-    end
-
-    it 'handles each proper name' do
-      @proper_names.each do |name|
-        expect(name.downcase.name_case).to eq name
-        expect(name.name_case).to eq name
-        # assert_equal(name, NameCase(name))
-      end
-    end
-
-    it 'handles multibyte' do
-      proper_cased = 'Iñtërnâtiônàlizætiøn'
-      expect(proper_cased.downcase.name_case).to eq proper_cased
-    end
-  end
-end

data/spec/extensions/time_spec.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'dm_ruby_extensions'
-
-describe Time do
-  describe 'localize' do
-    it 'localize the date based on the format' do
-      I18n.enforce_available_locales = false
-      I18n.locale = :en
-      time = Time.parse('2012-11-23 08:35 utc')
-      expect(time.localize).to eq 'Fri, 23 Nov 2012 08:35:00 +0000'
-      expect(time.localize(format: :short)).to eq '23 Nov 08:35'
-      expect(time.localize('%b %Y')).to eq 'Nov 2012'
-    end
-  end
-end

data/spec/extensions/true_spec.rb

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-require 'dm_ruby_extensions'
-
-describe TrueClass do
-  describe 'as_boolean' do
-    specify { expect(true.as_boolean).to eq true }
-  end
-end

data/spec/spec_helper.rb

@@ -1,86 +0,0 @@
-# frozen_string_literal: true
-
-require 'pry-byebug'
-# This file was generated by the `rails generate rspec:install` command. Conventionally, all
-# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
-# The generated `.rspec` file contains `--require spec_helper` which will cause this
-# file to always be loaded, without a need to explicitly require it in any files.
-#
-# Given that it is always loaded, you are encouraged to keep this file as
-# light-weight as possible. Requiring heavyweight dependencies from this file
-# will add to the boot time of your test suite on EVERY test run, even for an
-# individual file that may not need all of that loaded. Instead, consider making
-# a separate helper file that requires the additional dependencies and performs
-# the additional setup, and require it from the spec files that actually need it.
-#
-# The `.rspec` file also contains a few flags that are not defaults but that
-# users commonly want.
-#
-# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
-RSpec.configure do |config|
-  # rspec-expectations config goes here. You can use an alternate
-  # assertion/expectation library such as wrong or the stdlib/minitest
-  # assertions if you prefer.
-  config.expect_with :rspec do |expectations|
-    # This option will default to `true` in RSpec 4. It makes the `description`
-    # and `failure_message` of custom matchers include text for helper methods
-    # defined using `chain`, e.g.:
-    # be_bigger_than(2).and_smaller_than(4).description
-    #   # => "be bigger than 2 and smaller than 4"
-    # ...rather than:
-    #   # => "be bigger than 2"
-    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
-  end
-
-  # rspec-mocks config goes here. You can use an alternate test double
-  # library (such as bogus or mocha) by changing the `mock_with` option here.
-  config.mock_with :rspec do |mocks|
-    # Prevents you from mocking or stubbing a method that does not exist on
-    # a real object. This is generally recommended, and will default to
-    # `true` in RSpec 4.
-    mocks.verify_partial_doubles = true
-  end
-
-  # The settings below are suggested to provide a good initial experience
-  # with RSpec, but feel free to customize to your heart's content.
-  #   # These two settings work together to allow you to limit a spec run
-  #   # to individual examples or groups you care about by tagging them with
-  #   # `:focus` metadata. When nothing is tagged with `:focus`, all examples
-  #   # get run.
-  #   config.filter_run :focus
-  #   config.run_all_when_everything_filtered = true
-  #
-  #   # Limits the available syntax to the non-monkey patched syntax that is recommended.
-  #   # For more details, see:
-  #   #   - http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax
-  #   #   - http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
-  #   #   - http://myronmars.to/n/dev-blog/2014/05/notable-changes-in-rspec-3#new__config_option_to_disable_rspeccore_monkey_patching
-  #   config.disable_monkey_patching!
-  #
-  #   # Many RSpec users commonly either run the entire suite or an individual
-  #   # file, and it's useful to allow more verbose output when running an
-  #   # individual spec file.
-  #   if config.files_to_run.one?
-  #     # Use the documentation formatter for detailed output,
-  #     # unless a formatter has already been configured
-  #     # (e.g. via a command-line flag).
-  #     config.default_formatter = 'doc'
-  #   end
-  #
-  #   # Print the 10 slowest examples and example groups at the
-  #   # end of the spec run, to help surface which specs are running
-  #   # particularly slow.
-  #   config.profile_examples = 10
-  #
-  #   # Run specs in random order to surface order dependencies. If you find an
-  #   # order dependency and want to debug it, you can fix the order by providing
-  #   # the seed, which is printed after each run.
-  #   #     --seed 1234
-  #   config.order = :random
-  #
-  #   # Seed global randomization in this process using the `--seed` CLI option.
-  #   # Setting this allows you to use `--seed` to deterministically reproduce
-  #   # test failures related to randomization by passing the same `--seed` value
-  #   # as the one that triggered the failure.
-  #   Kernel.srand config.seed
-end