fat_core 7.1.3 → 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
-
-    private
-
-    def upper?
-      UPPERS.include?(self[0])
-    end
+    # 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
 
-    # 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
@@ -373,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 = 3
+  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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fat_core
 version: !ruby/object:Gem::Version
-  version: 7.1.3
+  version: 7.2.0
 platform: ruby
 authors:
 - Daniel E. Doherty
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-28 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