philiprehberger-string_kit 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f38ef0d79a14fb2d1ee763b52cd9e01ade47d478944f766676f6e32ac1d89eda
-  data.tar.gz: b7f0c00dee4c9fd5d7287a16b41b9e7bd5f701068d7c2d52a878a6991cc261ef
+  metadata.gz: 72e46f8edcca8e48d21af91556ac0e4126553b361787cb01a3afd322a1549b1f
+  data.tar.gz: 0dfb5daf94589ea718e366fa58e4bee558a5bd082940b0cf6b32d5c6cd53226a
 SHA512:
-  metadata.gz: ddb00275a54597ae4a4b0b9265acdf50360ce8b537787d7c7fef89705dbc9173e73dfb67ded292672151ddde4dac6798bb027d0806b6fdf270df68b52489f715
-  data.tar.gz: 9652f8595c23648bfe3a42b633e04f758c16d49db5c912237b669d80e8053a28db67ddf7b7758cf08d32be4e0a4ef7a858dcf9ea15b0439b9207223b091dca0a
+  metadata.gz: 0a4f5c0b411e7f40dcb455e199c93bc6cda99486a7286ce80cc17ca82d499a8f502f14c879863de900abe241cd2980c2ba26bf29d90fe0bd97cc7b2271c44d94
+  data.tar.gz: 451a1b8a585ec486fee920b9ef1f881e8b8ff1a1a8c264d94f65acbcb0baea4e803063bb8ffca006b3a10b79f28cd013a0788f579e2aba98b40af69f9a6d2a96

data/CHANGELOG.md

@@ -7,6 +7,11 @@ 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

data/README.md

@@ -117,6 +117,21 @@ Philiprehberger::StringKit.truncate_words('Two words', 5)
 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 |
@@ -147,6 +162,7 @@ Philiprehberger::StringKit.truncate_words('a b c d e', 2, omission: '...')
 | `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.4.0'
+    VERSION = '0.5.0'
   end
 end

data/lib/philiprehberger/string_kit.rb

@@ -381,6 +381,21 @@ module Philiprehberger
       "#{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
 
@@ -396,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.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-31 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