philiprehberger-string_kit 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a290f7b9aa5a9534b5f0f55086b416671e860b89bd58df4dae1558e8451f489
-  data.tar.gz: e4162f06038b8da1ad5f3b67249e3c1776fe9213014c2287a305addc163a978e
+  metadata.gz: f38ef0d79a14fb2d1ee763b52cd9e01ade47d478944f766676f6e32ac1d89eda
+  data.tar.gz: b7f0c00dee4c9fd5d7287a16b41b9e7bd5f701068d7c2d52a878a6991cc261ef
 SHA512:
-  metadata.gz: df68e8c923b8ab6693894e01068317abbb4254ab10063d5859c81dbc2e1c585160e7ec4fa94189329b25ad86ae8b6b6728fa153c990fd74537b22653796abd51
-  data.tar.gz: d41749d919b01bff185fe0bd555b65a0b7c2989e27fb9cb7d0b33cd301fdeabb1491467637eee0ac09b5eb9d29c0d4481d47c73f0a9fbadc7c2fa2e93cf2f84e
+  metadata.gz: ddb00275a54597ae4a4b0b9265acdf50360ce8b537787d7c7fef89705dbc9173e73dfb67ded292672151ddde4dac6798bb027d0806b6fdf270df68b52489f715
+  data.tar.gz: 9652f8595c23648bfe3a42b633e04f758c16d49db5c912237b669d80e8053a28db67ddf7b7758cf08d32be4e0a4ef7a858dcf9ea15b0439b9207223b091dca0a

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [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,30 @@ 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..."
+```
+
 ## API
 
 | Method | Description |
@@ -118,6 +144,9 @@ 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 |
 
 ## Development
 

data/lib/philiprehberger/string_kit/version.rb

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

data/lib/philiprehberger/string_kit.rb

@@ -325,6 +325,62 @@ 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
+
     class << self
       private
 

metadata

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