fat_core 7.1.2 → 7.2.0

data/Rakefile

@@ -24,16 +24,12 @@ RSpec::Core::RakeTask.new(:spec, :tag) do |t|
   t.rspec_opts = '--tag ~online -f d'
 end
 
+require "gem_docs"
+GemDocs.install
+
 ########################################################################
 # Rubocop tasks
 ########################################################################
-# Option A (recommended): Keep using Bundler and run rubocop via `bundle exec`.
-# This wrapper task ensures the rubocop run uses the gems from your Gemfile,
-# even when you invoke `rake rubocop` (no need to remember `bundle exec rake`).
-#
-# You can pass extra RuboCop CLI flags with the RUBOCOP_OPTS environment variable:
-#   RUBOCOP_OPTS="--format simple" rake rubocop
-
 desc "Run rubocop under `bundle exec`"
 task :rubocop do
   opts = (ENV['RUBOCOP_OPTS'] || '').split

data/lib/fat_core/all.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative '../fat_core'
 require_relative 'array'
 require_relative 'bigdecimal'
 require_relative 'enumerable'

data/lib/fat_core/string.rb

@@ -8,6 +8,9 @@ require_relative 'numeric'
 
 module FatCore
   module String
+    UPPERS = ('A'..'Z').to_a
+    REGEXP_META_CHARACTERS = "\\$()*+.<>?[]^{|}".chars.freeze
+
     # @group Transforming
     # :section: Transforming
 
@@ -93,22 +96,29 @@ module FatCore
       r.gsub('XzXzXcbXzXzX', '\\}')
     end
 
-    UPPERS = ('A'..'Z').to_a
-    REGEXP_META_CHARACTERS = "\\$()*+.<>?[]^{|}".chars.freeze
+    # Rather than truncate a String to make it fit a given length, this method
+    # removes characters from the middle of the string to make it fit the
+    # given size.  This is often preferable to truncating at the end or
+    # beginning of a String because the most important information is often at
+    # the start or end of a String.  By default the missing middle is
+    # indicated by a single '~' character, but you can set it to any string,
+    # even the empty string with the `ellipsis:` parameter.
+    def gut(max_size, ellipsis: '~', squeeze: nil)
+      return self if size <= max_size
 
-    private
-
-    def upper?
-      UPPERS.include?(self[0])
-    end
-
-    # Return true if all the letters in self are upper case
-    def all_upper?
-      tr('^A-Za-z', '').split('').all? { |c| ('A'..'Z').to_a.include? c }
+      s =
+        if squeeze
+          tr(squeeze, '')
+        else
+          self
+        end
+      chars_to_cut = (s.size - max_size) + ellipsis.size
+      chars_to_keep = s.size - chars_to_cut
+      start_chars = chars_to_keep / 2 + (chars_to_keep.odd? ? 1 : 0)
+      end_chars = chars_to_keep - start_chars
+      s[0..start_chars - 1] + ellipsis + s[-end_chars..-1]
     end
 
-    public
-
     # Return self capitalized according to the conventions for capitalizing
     # titles of books or articles. Tries to follow the rules of the University
     # of Chicago's *A Manual of Style*, Section 7.123, except to the extent that
@@ -215,32 +225,6 @@ module FatCore
       DamerauLevenshtein.distance(self, other.to_s, 1, 10)
     end
 
-    # Test whether self matches the `matcher` treating `matcher` as a
-    # case-insensitive regular expression if it is of the form '/.../' or as a
-    # string to #fuzzy_match against otherwise.
-    #
-    # @param matcher [String] regexp if looks like /.../; #fuzzy_match pattern otherwise
-    # @return [nil] if no match
-    # @return [String] the matched portion of self, with punctuation stripped in
-    #   case of #fuzzy_match
-    # @see #fuzzy_match #fuzzy_match for the specifics of string matching
-    # @see #as_regexp #as_regexp for conversion of `matcher` to regular expression
-    def matches_with(matcher)
-      # Replace periods and commas with a space (so they are still word
-      # separators, e.g. 'WWW.WOLFRAM' -> 'WWW WOLFRAM' and 'AMZON,INC.' ->
-      # 'AMAZON INC') and remove asterisks and apostrophes
-      target = gsub(/[.,]/, ' ').gsub(/[\*']/, '').clean
-      if matcher.nil?
-        nil
-      elsif matcher.match?(%r{^\s*/})
-        re = matcher.as_regexp
-        md = target.match(re)
-        md[0] if md
-      else
-        to_s.fuzzy_match(matcher)
-      end
-    end
-
     # Return the matched portion of self, minus punctuation characters, if self
     # matches the string `matcher` using the following notion of matching:
     #
@@ -304,6 +288,28 @@ module FatCore
       matched_text
     end
 
+    # Test whether self matches the `matcher` treating `matcher` as a
+    # case-insensitive regular expression if it is of the form '/.../' or as a
+    # string to #fuzzy_match against otherwise.
+    #
+    # @param matcher [String] regexp if looks like /.../; #fuzzy_match pattern otherwise
+    # @return [nil] if no match
+    # @return [String] the matched portion of self, with punctuation stripped in
+    #   case of #fuzzy_match
+    # @see #fuzzy_match #fuzzy_match for the specifics of string matching
+    # @see #as_regexp #as_regexp for conversion of `matcher` to regular expression
+    def matches_with(matcher)
+      return if matcher.nil?
+
+      if matcher.match?(%r{^\s*/})
+        re = matcher.as_regexp
+        md = match(re)
+        md[0] if md
+      else
+        fuzzy_match(matcher)
+      end
+    end
+
     # Convert a string of the form '/.../Iixm' to a regular
     # expression. However, make the regular expression case-insensitive by
     # default and extend the modifier syntax to allow '/I' to indicate
@@ -377,6 +383,17 @@ module FatCore
       to_f.commas(places)
     end
 
+    private
+
+    def upper?
+      UPPERS.include?(self[0])
+    end
+
+    # Return true if all the letters in self are upper case
+    def all_upper?
+      tr('^A-Za-z', '').split('').all? { |c| ('A'..'Z').to_a.include? c }
+    end
+
     module ClassMethods
       # @group Generating
       # :section: Generating

data/lib/fat_core/version.rb

@@ -2,8 +2,8 @@
 
 module FatCore
   MAJOR = 7
-  MINOR = 1
-  PATCH = 2
+  MINOR = 2
+  PATCH = 0
 
   # FatCore version number
   VERSION = [MAJOR, MINOR, PATCH].compact.join('.')

data/lib/fat_core.rb

@@ -3,5 +3,15 @@
 require 'active_support/core_ext/object/blank'
 require 'active_support/core_ext/object/deep_dup'
 
-require 'fat_core/version'
-require 'fat_core/patches'
+# Gem Overview (extracted from README.org by gem_docs)
+#
+# * Introduction
+# ~fat-core~ is somewhat of a grab bag of core class extensions that I have
+# found useful across several projects.  It's higgeldy-piggeldy nature reflects
+# the fact that none of them are important enough to deserve a gem of their own,
+# but nonetheless need to be collected in one place to reduce redundancy across
+# projects and provide a focused place to develop and test them.
+module FatCore
+  require 'fat_core/version'
+  require 'fat_core/patches'
+end

data/spec/lib/string_spec.rb

@@ -158,6 +158,15 @@ the people, for the people, shall not perish from the earth."
       end
     end
 
+    it 'guts a string in the middle' do
+      expect('hello'.gut(10)).to eq('hello')
+      expect('helloworld'.gut(6)).to eq('hel~ld')
+      expect('Class A Common Stock'.gut(15)).to eq("Class A~n Stock")
+      expect('Class A Common Stock'.gut(15, ellipsis: '...')).to eq("Class ... Stock")
+      expect('Class A Common Stock'.gut(15, ellipsis: '')).to eq("Class A n Stock")
+      expect('Class A Common Stock'.gut(16, ellipsis: '', squeeze: ' ')).to eq("ClassAComonStock")
+    end
+
     it 'converts a string to a regular expression' do
       # Ignores case by default
       re = "/hello((\s+)(world))?/".as_regexp
@@ -372,15 +381,22 @@ the people, for the people, shall not perish from the earth."
         expect("St. Luke's Hospital".matches_with('lukes:hospital')).to eq('Lukes Hospital')
       end
 
-      it 'performs examples in documentation with regexes' do
-        expect("St. Luke's".matches_with('/st\s*lukes/')).to eq('St Lukes')
-        expect("St. Luke's Hospital".matches_with('/st lukes/')).to eq('St Lukes')
-        expect("St. Luke's Hospital".matches_with('/luk.*\bhosp/')).to eq('Lukes Hosp')
-        expect("St. Luke's Hospital".matches_with('/st(.*)spital\z/')).to eq('St Lukes Hospital')
+      it 'does not pre-condition the subject when regexes' do
+        expect("St. Luke's Hospital".matches_with('st:lukes')).to eq('St Lukes')
+        expect("St. Luke's Hospital".matches_with('lukes')).to eq('Lukes')
+        expect("St. Luke's".matches_with('/st.*luke\'s/')).to eq('St. Luke\'s')
+        expect("St. Luke's Hospital".matches_with('/st\\. luke/')).to eq('St. Luke')
+        expect("St. Luke's Hospital".matches_with('/luk.*\bhosp/')).to eq('Luke\'s Hosp')
+        expect("St. Luke's Hospital".matches_with('/st(.*)spital\z/')).to eq('St. Luke\'s Hospital')
         expect("St. Luke's Hospital".matches_with('/st spital/')).to be_nil
         expect("St. Luke's Hospital".matches_with('/st.*laks/')).to be_nil
         expect("St. Luke's Hospital".matches_with('/\Alukes/')).to be_nil
-        expect("St. Luke's Hospital".matches_with('/lukes hospital/')).to eq('Lukes Hospital')
+        expect("St. Luke's Hospital".matches_with('/luke.*hospital/')).to eq('Luke\'s Hospital')
+      end
+
+      it 'makes the regex case insensitive unless option I given' do
+        expect("St. Luke's Hospital".matches_with('/LUKE/')).to eq('Luke')
+        expect("St. Luke's Hospital".matches_with('/LUKE/I')).to be_nil
       end
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fat_core
 version: !ruby/object:Gem::Version
-  version: 7.1.2
+  version: 7.2.0
 platform: ruby
 authors:
 - Daniel E. Doherty
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-27 00:00:00.000000000 Z
+date: 2026-05-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -89,6 +89,7 @@ files:
 - CHANGELOG.org
 - Gemfile
 - LICENSE.txt
+- README.md
 - README.org
 - Rakefile
 - TODO.org