philiprehberger-string_kit 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a290f7b9aa5a9534b5f0f55086b416671e860b89bd58df4dae1558e8451f489
-  data.tar.gz: e4162f06038b8da1ad5f3b67249e3c1776fe9213014c2287a305addc163a978e
+  metadata.gz: 72e46f8edcca8e48d21af91556ac0e4126553b361787cb01a3afd322a1549b1f
+  data.tar.gz: 0dfb5daf94589ea718e366fa58e4bee558a5bd082940b0cf6b32d5c6cd53226a
 SHA512:
-  metadata.gz: df68e8c923b8ab6693894e01068317abbb4254ab10063d5859c81dbc2e1c585160e7ec4fa94189329b25ad86ae8b6b6728fa153c990fd74537b22653796abd51
-  data.tar.gz: d41749d919b01bff185fe0bd555b65a0b7c2989e27fb9cb7d0b33cd301fdeabb1491467637eee0ac09b5eb9d29c0d4481d47c73f0a9fbadc7c2fa2e93cf2f84e
+  metadata.gz: 0a4f5c0b411e7f40dcb455e199c93bc6cda99486a7286ce80cc17ca82d499a8f502f14c879863de900abe241cd2980c2ba26bf29d90fe0bd97cc7b2271c44d94
+  data.tar.gz: 451a1b8a585ec486fee920b9ef1f881e8b8ff1a1a8c264d94f65acbcb0baea4e803063bb8ffca006b3a10b79f28cd013a0788f579e2aba98b40af69f9a6d2a96

data/CHANGELOG.md

@@ -7,6 +7,21 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-05-31
+
+### Added
+- `StringKit.word_wrap(str, width)` wraps a string to lines of at most `width` characters on word boundaries. Words longer than `width` are kept intact on their own line; existing newlines are honored as forced breaks. Raises `Error` for non-positive widths.
+
+## [0.4.0] - 2026-05-30
+
+### Added
+- `StringKit.mask(str, show_first:, show_last:, mask_char:)` for partial string obfuscation
+- `StringKit.between(str, left, right)` to extract text between delimiters
+- `StringKit.truncate_words(str, max_words, omission:)` for word-aware truncation
+
+### Fixed
+- README now includes the standard package card image after the badges
+
 ## [0.3.0] - 2026-04-25
 
 ### Added

data/README.md

@@ -4,6 +4,8 @@
 [![Gem Version](https://badge.fury.io/rb/philiprehberger-string_kit.svg)](https://rubygems.org/gems/philiprehberger-string_kit)
 [![Last updated](https://img.shields.io/github/last-commit/philiprehberger/rb-string-kit)](https://github.com/philiprehberger/rb-string-kit/commits/main)
 
+![philiprehberger-string_kit](https://raw.githubusercontent.com/philiprehberger/rb-string-kit/main/package-card.webp)
+
 Comprehensive string utilities without ActiveSupport dependency
 
 ## Requirements
@@ -91,6 +93,45 @@ Philiprehberger::StringKit.levenshtein('kitten', 'sitting')  # => 3
 Philiprehberger::StringKit.similarity('kitten', 'sitting')   # => ~0.571
 ```
 
+### Masking
+
+```ruby
+Philiprehberger::StringKit.mask('4242424242424242', show_last: 4)                  # => "************4242"
+Philiprehberger::StringKit.mask('alice@example.com', show_first: 2, show_last: 4)  # => "al***********.com"
+Philiprehberger::StringKit.mask('password123', show_last: 3, mask_char: '#')       # => "########123"
+```
+
+### Between Delimiters
+
+```ruby
+Philiprehberger::StringKit.between('hello [world] there', '[', ']')  # => "world"
+Philiprehberger::StringKit.between('a(b)c(d)', '(', ')')             # => "b"
+Philiprehberger::StringKit.between('no brackets here', '[', ']')     # => nil
+```
+
+### Word-Aware Truncation
+
+```ruby
+Philiprehberger::StringKit.truncate_words('The quick brown fox jumps', 3)                  # => "The quick brown…"
+Philiprehberger::StringKit.truncate_words('Two words', 5)                                  # => "Two words"
+Philiprehberger::StringKit.truncate_words('a b c d e', 2, omission: '...')                 # => "a b..."
+```
+
+### Word Wrap
+
+```ruby
+Philiprehberger::StringKit.word_wrap('The quick brown fox jumps over the lazy dog', 15)
+# => "The quick brown\nfox jumps over\nthe lazy dog"
+
+# Words longer than `width` are kept intact on their own line
+Philiprehberger::StringKit.word_wrap('Supercalifragilistic words', 10)
+# => "Supercalifragilistic\nwords"
+
+# Existing newlines are honored as forced breaks
+Philiprehberger::StringKit.word_wrap("one two\nthree four", 7)
+# => "one two\nthree\nfour"
+```
+
 ## API
 
 | Method | Description |
@@ -118,6 +159,10 @@ Philiprehberger::StringKit.similarity('kitten', 'sitting')   # => ~0.571
 | `.strip_zero_width(str)` | Remove zero-width and invisible Unicode characters |
 | `.levenshtein(a, b)` | Edit distance between two strings |
 | `.similarity(a, b)` | 0.0–1.0 similarity derived from Levenshtein distance |
+| `StringKit.mask(str, show_first:, show_last:, mask_char:)` | Mask the middle of a string for partial obfuscation |
+| `StringKit.between(str, left, right)` | Extract text between the first occurrence of two delimiters |
+| `StringKit.truncate_words(str, max_words, omission:)` | Truncate to the first `max_words` words with an omission marker |
+| `StringKit.word_wrap(str, width)` | Wrap to lines of at most `width` characters on word boundaries |
 
 ## Development
 

data/lib/philiprehberger/string_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module StringKit
-    VERSION = '0.3.0'
+    VERSION = '0.5.0'
   end
 end

data/lib/philiprehberger/string_kit.rb

@@ -325,6 +325,77 @@ module Philiprehberger
       1.0 - (levenshtein(a, b).to_f / max)
     end
 
+    # Mask a string by replacing its middle portion with `mask_char`,
+    # leaving `show_first` characters at the start and `show_last` at the end.
+    # Returns `str` unchanged when there is not enough room to mask at least
+    # two characters in the middle.
+    #
+    # @param str [String]
+    # @param show_first [Integer] number of characters to leave visible at the start
+    # @param show_last [Integer] number of characters to leave visible at the end
+    # @param mask_char [String] character used to mask the hidden portion (default: '*')
+    # @return [String]
+    def self.mask(str, show_first: 0, show_last: 0, mask_char: '*')
+      validate!(str)
+      return str if show_first + show_last >= str.length - 1
+
+      masked_length = str.length - show_first - show_last
+      str[0, show_first] + (mask_char * masked_length) + str[str.length - show_last, show_last].to_s
+    end
+
+    # Returns the substring strictly between the first occurrence of `left`
+    # and the first occurrence of `right` after `left`. Returns `nil` when
+    # either delimiter is missing.
+    #
+    # @param str [String]
+    # @param left [String]
+    # @param right [String]
+    # @return [String, nil]
+    def self.between(str, left, right)
+      validate!(str)
+      left_index = str.index(left)
+      return nil if left_index.nil?
+
+      start_pos = left_index + left.length
+      right_index = str.index(right, start_pos)
+      return nil if right_index.nil?
+
+      str[start_pos...right_index]
+    end
+
+    # Truncate a string to the first `max_words` words. When truncation
+    # happens, append `omission` to the result. The string is unchanged
+    # when the word count is less than or equal to `max_words`.
+    #
+    # @param str [String]
+    # @param max_words [Integer] maximum number of words to keep (must be positive)
+    # @param omission [String] string appended when truncation occurs (default: '…')
+    # @return [String]
+    def self.truncate_words(str, max_words, omission: '…')
+      validate!(str)
+      raise Error, 'max_words must be a positive Integer' unless max_words.is_a?(Integer) && max_words.positive?
+
+      words = str.split(/\s+/).reject(&:empty?)
+      return str if words.length <= max_words
+
+      "#{words.first(max_words).join(' ')}#{omission}"
+    end
+
+    # Wrap the string to lines of at most `width` characters, breaking on
+    # word boundaries. Words longer than `width` are kept intact on their own
+    # line rather than split mid-word. Existing newlines are honored as
+    # forced breaks — each input line is wrapped independently.
+    #
+    # @param str [String]
+    # @param width [Integer] maximum line width (must be positive)
+    # @return [String] newline-joined wrapped lines
+    def self.word_wrap(str, width)
+      validate!(str)
+      raise Error, 'width must be a positive Integer' unless width.is_a?(Integer) && width.positive?
+
+      str.each_line.map { |line| wrap_line(line.chomp, width) }.join("\n")
+    end
+
     class << self
       private
 
@@ -340,6 +411,28 @@ module Philiprehberger
           .downcase
           .split
       end
+
+      def wrap_line(line, width)
+        return '' if line.empty?
+
+        words = line.split(/\s+/).reject(&:empty?)
+        return '' if words.empty?
+
+        lines = []
+        current = +''
+        words.each do |word|
+          if current.empty?
+            current = word.dup
+          elsif current.length + 1 + word.length <= width
+            current << ' ' << word
+          else
+            lines << current
+            current = word.dup
+          end
+        end
+        lines << current unless current.empty?
+        lines.join("\n")
+      end
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-string_kit
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-26 00:00:00.000000000 Z
+date: 2026-06-01 00:00:00.000000000 Z
 dependencies: []
 description: String case conversion, slug generation, transliteration, padding, HTML
   stripping, whitespace normalization, word counting, reading time estimation, excerpt