philiprehberger-string_kit 0.1.5 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a101ff6299427781a2e36187c45ea562262a55e42ccbd16603914bd88d98e8db
-  data.tar.gz: 191f68c44b3f23ee978204ca0826470ee5e7301c4e50742c1748e3b561940ccd
+  metadata.gz: 107a691dbf6789259b13f7186ea60b5cd1b026bfefc695e41dfe47a8244350e2
+  data.tar.gz: 1c211206ef60437262aee4bbabaf6f730460d99cd2f31306794ca60fdf51c9e9
 SHA512:
-  metadata.gz: 25e22e494fc0b416cec981127cdd30b211a85ea18330d69fabec6487b95b8cc376013cfb56268cf2cc756a23c28ad3fc6d423dd421ff9b05ac382f27f2838ca0
-  data.tar.gz: 225abafbcd6f1542197d745ba6cfb155007002449f8632c778b58d28eeb2bb627d38d08b22c1cdbe6c888fabc04fb6f3e67807325bbb7116953e0bfa8db6b05b
+  metadata.gz: 7997a306ea22f20b323d3c06ad8e6f2142905765f2b4b5a2c5312417f6300a7287a994469ff4dbf8071078a24b95ad4447326c4d552c98e02a3e34850b4b8cac
+  data.tar.gz: c0be14da1d59836b63530ff4cdc6ecab888791cb5c746719f5aa7d8e403b0e500bb3a00495016bbfddcbb0a34b61dd86271e7fb0be36816331158226c170b3c3

data/CHANGELOG.md

@@ -7,6 +7,21 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-04-03
+
+### Added
+- Add `slug` method for URL-safe slug generation with custom separator support
+- Add `pad` method for left, right, and center string padding
+- Add `transliterate` method to replace accented/diacritical characters with ASCII equivalents
+- Add `dot_case` method for dot.case conversion
+- Add `path_case` method for path/case conversion
+- Add `reverse_case` method to swap upper and lower case characters
+
+## [0.1.6] - 2026-03-31
+
+### Added
+- Add GitHub issue templates, dependabot config, and PR template
+
 ## [0.1.5] - 2026-03-31
 
 ### Changed

data/README.md

@@ -35,6 +35,26 @@ Philiprehberger::StringKit.camel_case('hello world')       # => "helloWorld"
 Philiprehberger::StringKit.pascal_case('hello world')      # => "HelloWorld"
 Philiprehberger::StringKit.snake_case('Hello World')       # => "hello_world"
 Philiprehberger::StringKit.constant_case('hello world')    # => "HELLO_WORLD"
+Philiprehberger::StringKit.dot_case('SomeString')          # => "some.string"
+Philiprehberger::StringKit.path_case('SomeString')         # => "some/string"
+Philiprehberger::StringKit.reverse_case('Hello')           # => "hELLO"
+```
+
+### Slug Generation and Transliteration
+
+```ruby
+Philiprehberger::StringKit.slug('Hello World!')                  # => "hello-world"
+Philiprehberger::StringKit.slug('Hello World!', separator: '_')  # => "hello_world"
+Philiprehberger::StringKit.transliterate('cr\u00E8me br\u00FBl\u00E9e')          # => "creme brulee"
+```
+
+### String Padding
+
+```ruby
+Philiprehberger::StringKit.pad('hi', 5)                   # => "hi   "
+Philiprehberger::StringKit.pad('hi', 5, side: :left)      # => "   hi"
+Philiprehberger::StringKit.pad('hi', 6, side: :both)      # => "  hi  "
+Philiprehberger::StringKit.pad('hi', 5, char: '*')        # => "hi***"
 ```
 
 ### Text Processing
@@ -65,6 +85,12 @@ Philiprehberger::StringKit.dedent("    hello\n    world")      # => "hello\nworl
 | `StringKit.pascal_case(str)` | Convert string to PascalCase |
 | `StringKit.snake_case(str)` | Convert string to snake_case |
 | `StringKit.constant_case(str)` | Convert string to CONSTANT_CASE |
+| `StringKit.dot_case(str)` | Convert string to dot.case |
+| `StringKit.path_case(str)` | Convert string to path/case |
+| `StringKit.reverse_case(str)` | Swap upper and lower case characters |
+| `StringKit.slug(str, separator:)` | Generate URL-safe slug |
+| `StringKit.pad(str, length, char:, side:)` | Pad string to target length |
+| `StringKit.transliterate(str)` | Replace accented characters with ASCII equivalents |
 | `StringKit.strip_html(str)` | Remove HTML tags from string |
 | `StringKit.normalize_whitespace(str)` | Collapse whitespace to single spaces |
 | `StringKit.word_count(str)` | Count words in string |

data/lib/philiprehberger/string_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module StringKit
-    VERSION = '0.1.5'
+    VERSION = '0.2.0'
   end
 end

data/lib/philiprehberger/string_kit.rb

@@ -8,6 +8,53 @@ module Philiprehberger
 
     WORD_BOUNDARY = /[^a-zA-Z0-9\u00C0-\u024F]+/
 
+    TRANSLITERATION_MAP = {
+      "\u00C0" => 'A', "\u00C1" => 'A', "\u00C2" => 'A', "\u00C3" => 'A', "\u00C4" => 'A', "\u00C5" => 'A',
+      "\u00E0" => 'a', "\u00E1" => 'a', "\u00E2" => 'a', "\u00E3" => 'a', "\u00E4" => 'a', "\u00E5" => 'a',
+      "\u00C6" => 'AE', "\u00E6" => 'ae',
+      "\u00C7" => 'C', "\u00E7" => 'c',
+      "\u00C8" => 'E', "\u00C9" => 'E', "\u00CA" => 'E', "\u00CB" => 'E',
+      "\u00E8" => 'e', "\u00E9" => 'e', "\u00EA" => 'e', "\u00EB" => 'e',
+      "\u00CC" => 'I', "\u00CD" => 'I', "\u00CE" => 'I', "\u00CF" => 'I',
+      "\u00EC" => 'i', "\u00ED" => 'i', "\u00EE" => 'i', "\u00EF" => 'i',
+      "\u00D0" => 'D', "\u00F0" => 'd',
+      "\u00D1" => 'N', "\u00F1" => 'n',
+      "\u00D2" => 'O', "\u00D3" => 'O', "\u00D4" => 'O', "\u00D5" => 'O', "\u00D6" => 'O', "\u00D8" => 'O',
+      "\u00F2" => 'o', "\u00F3" => 'o', "\u00F4" => 'o', "\u00F5" => 'o', "\u00F6" => 'o', "\u00F8" => 'o',
+      "\u00D9" => 'U', "\u00DA" => 'U', "\u00DB" => 'U', "\u00DC" => 'U',
+      "\u00F9" => 'u', "\u00FA" => 'u', "\u00FB" => 'u', "\u00FC" => 'u',
+      "\u00DD" => 'Y', "\u00FD" => 'y', "\u00FF" => 'y',
+      "\u00DE" => 'Th', "\u00FE" => 'th',
+      "\u00DF" => 'ss',
+      "\u0100" => 'A', "\u0101" => 'a', "\u0102" => 'A', "\u0103" => 'a', "\u0104" => 'A', "\u0105" => 'a',
+      "\u0106" => 'C', "\u0107" => 'c', "\u0108" => 'C', "\u0109" => 'c', "\u010A" => 'C', "\u010B" => 'c',
+      "\u010C" => 'C', "\u010D" => 'c',
+      "\u010E" => 'D', "\u010F" => 'd', "\u0110" => 'D', "\u0111" => 'd',
+      "\u0112" => 'E', "\u0113" => 'e', "\u0114" => 'E', "\u0115" => 'e', "\u0116" => 'E', "\u0117" => 'e',
+      "\u0118" => 'E', "\u0119" => 'e', "\u011A" => 'E', "\u011B" => 'e',
+      "\u011C" => 'G', "\u011D" => 'g', "\u011E" => 'G', "\u011F" => 'g', "\u0120" => 'G', "\u0121" => 'g',
+      "\u0122" => 'G', "\u0123" => 'g',
+      "\u0124" => 'H', "\u0125" => 'h', "\u0126" => 'H', "\u0127" => 'h',
+      "\u0128" => 'I', "\u0129" => 'i', "\u012A" => 'I', "\u012B" => 'i', "\u012C" => 'I', "\u012D" => 'i',
+      "\u012E" => 'I', "\u012F" => 'i', "\u0130" => 'I', "\u0131" => 'i',
+      "\u0134" => 'J', "\u0135" => 'j',
+      "\u0136" => 'K', "\u0137" => 'k',
+      "\u0139" => 'L', "\u013A" => 'l', "\u013B" => 'L', "\u013C" => 'l', "\u013D" => 'L', "\u013E" => 'l',
+      "\u0141" => 'L', "\u0142" => 'l',
+      "\u0143" => 'N', "\u0144" => 'n', "\u0145" => 'N', "\u0146" => 'n', "\u0147" => 'N', "\u0148" => 'n',
+      "\u014C" => 'O', "\u014D" => 'o', "\u014E" => 'O', "\u014F" => 'o', "\u0150" => 'O', "\u0151" => 'o',
+      "\u0152" => 'OE', "\u0153" => 'oe',
+      "\u0154" => 'R', "\u0155" => 'r', "\u0156" => 'R', "\u0157" => 'r', "\u0158" => 'R', "\u0159" => 'r',
+      "\u015A" => 'S', "\u015B" => 's', "\u015C" => 'S', "\u015D" => 's', "\u015E" => 'S', "\u015F" => 's',
+      "\u0160" => 'S', "\u0161" => 's',
+      "\u0162" => 'T', "\u0163" => 't', "\u0164" => 'T', "\u0165" => 't', "\u0166" => 'T', "\u0167" => 't',
+      "\u0168" => 'U', "\u0169" => 'u', "\u016A" => 'U', "\u016B" => 'u', "\u016C" => 'U', "\u016D" => 'u',
+      "\u016E" => 'U', "\u016F" => 'u', "\u0170" => 'U', "\u0171" => 'u', "\u0172" => 'U', "\u0173" => 'u',
+      "\u0174" => 'W', "\u0175" => 'w',
+      "\u0176" => 'Y', "\u0177" => 'y', "\u0178" => 'Y',
+      "\u0179" => 'Z', "\u017A" => 'z', "\u017B" => 'Z', "\u017C" => 'z', "\u017D" => 'Z', "\u017E" => 'z'
+    }.freeze
+
     # Convert string to Title Case
     #
     # @param str [String]
@@ -157,6 +204,80 @@ module Philiprehberger
       lines.map { |line| line.length > min_indent ? line[min_indent..] : line.lstrip }.join
     end
 
+    # Generate a URL-safe slug
+    #
+    # @param str [String]
+    # @param separator [String] separator character (default: '-')
+    # @return [String]
+    def self.slug(str, separator: '-')
+      validate!(str)
+      result = transliterate(str)
+      result = result.downcase
+      result = result.gsub(/[^a-z0-9\s-]/, '')
+      result = result.strip.gsub(/[\s-]+/, separator)
+      result.gsub(/#{Regexp.escape(separator)}+/, separator)
+    end
+
+    # Pad string to target length
+    #
+    # @param str [String]
+    # @param length [Integer] target length
+    # @param char [String] padding character (default: ' ')
+    # @param side [Symbol] :left, :right, or :both (default: :right)
+    # @return [String]
+    def self.pad(str, length, char: ' ', side: :right)
+      validate!(str)
+      return str if str.length >= length
+
+      diff = length - str.length
+      case side
+      when :left
+        (char * diff) + str
+      when :both
+        left_pad = diff / 2
+        right_pad = diff - left_pad
+        (char * left_pad) + str + (char * right_pad)
+      else
+        str + (char * diff)
+      end
+    end
+
+    # Replace accented/diacritical characters with ASCII equivalents
+    #
+    # @param str [String]
+    # @return [String]
+    def self.transliterate(str)
+      validate!(str)
+      str.gsub(/[^\x00-\x7F]/) { |char| TRANSLITERATION_MAP.fetch(char, char) }
+    end
+
+    # Convert string to dot.case
+    #
+    # @param str [String]
+    # @return [String]
+    def self.dot_case(str)
+      validate!(str)
+      separate_words(str).join('.')
+    end
+
+    # Convert string to path/case
+    #
+    # @param str [String]
+    # @return [String]
+    def self.path_case(str)
+      validate!(str)
+      separate_words(str).join('/')
+    end
+
+    # Swap upper and lower case characters
+    #
+    # @param str [String]
+    # @return [String]
+    def self.reverse_case(str)
+      validate!(str)
+      str.swapcase
+    end
+
     class << self
       private
 

metadata

@@ -1,17 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-string_kit
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.2.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-04-04 00:00:00.000000000 Z
 dependencies: []
-description: String case conversion, HTML stripping, whitespace normalization, word
-  counting, reading time estimation, excerpt extraction, indentation, and more.
+description: String case conversion, slug generation, transliteration, padding, HTML
+  stripping, whitespace normalization, word counting, reading time estimation, excerpt
+  extraction, indentation, and more.
 email:
 - me@philiprehberger.com
 executables: []
@@ -23,11 +24,11 @@ files:
 - README.md
 - lib/philiprehberger/string_kit.rb
 - lib/philiprehberger/string_kit/version.rb
-homepage: https://github.com/philiprehberger/rb-string-kit
+homepage: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-string_kit
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/philiprehberger/rb-string-kit
+  homepage_uri: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-string_kit
   source_code_uri: https://github.com/philiprehberger/rb-string-kit
   changelog_uri: https://github.com/philiprehberger/rb-string-kit/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/philiprehberger/rb-string-kit/issues