string_magic 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c2974ab8c5a68c297377233418f680d5f92ddc66d1c2c4490744c136ac6982a
-  data.tar.gz: da5732a7df509fb6d1ff3c73990a477f9b1417fb0ffd50e4c18819fd495b17f8
+  metadata.gz: c860708ae5aa73e721fc45b4aa173a79c75a2645bcf244a416e7f758e089d2cd
+  data.tar.gz: ded9547fb9a55ab72c7f4a15cfee03a707811d4c4a7bbf46f66d4c1dc99f8b3c
 SHA512:
-  metadata.gz: b82312455117a5efdf8cc12d58dd825e0cc268c351199185c5430125eede62d4180ec71f5497bbec627dca9a3ebffee177d5a8480fd3fedfb469709145530f2b
-  data.tar.gz: 2520fb7095a7ccdfc3ea91e9e702e0906c37dc6f810b1f5e9231c4aeb8759747ccfce1a05a20488187463627e537c298bd864647a7b3309ddc894c5dd69c551e
+  metadata.gz: 4efe0e495f4dcbeb8ffffe2f8f049c79b79c81ab991049698a659a9d795d4c11988e0b060017734d60f1cd201732c9bcdb9f23f85c3d4cf8a050757ea1287626
+  data.tar.gz: 3ef437f7a57cfab7e031aadbbf64cbf76851ab684fcf5a4e0059fb0c74e312e34c53c44da42ef0acd5984c2748c3ba0c97bb0752a42816c1bd441c39503a4c02

data/CHANGELOG.md

@@ -1,3 +1,24 @@
+## [0.5.0] - 2025-08-12
+
+### Added
+
+- **StringMagic::Core::Validation** - Email, URL, phone, credit card validation and more
+- **StringMagic::Utilities::Slug** - Convert text to URL-safe slugs and filename-safe strings  
+- **StringMagic::Utilities::Inflection** - Pluralize, singularize, ordinalize, and humanize text
+
+### Enhanced
+
+- **StringMagic::Core::Transformation** - New case conversions and text manipulation methods
+- **StringMagic::Core::Analysis** - Improved entity extraction and sentiment analysis
+- **StringMagic::Formatting::Truncation** - Smart word, sentence, and character truncation
+- **StringMagic::Formatting::Highlighting** - HTML highlighting and URL auto-linking
+- **StringMagic::Advanced::Security** - Mask sensitive data like credit cards and emails
+
+### Changed
+
+- Modular code organization
+- All methods now available as both String instance methods and module methods
+
 ## [0.4.0] - 2025-01-01
 
 ### Added

data/README.md

@@ -1,75 +1,81 @@
-# StringMagic
+# StringMagic - v0.5.0
+[![Gem Version](https://badge.fury.io/rb/string_magic.svg)](https://badge.fury.io/rb/string_magic)
+[![Build Status](https://dl.circleci.com/status-badge/img/circleci/8MamMcAVAVNWTcUqkjQk7R/Sh2DQkMWqqCv4MFvAmYWDL/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/circleci/8MamMcAVAVNWTcUqkjQk7R/Sh2DQkMWqqCv4MFvAmYWDL/tree/main)
+[![License: MIT](https://img.shields.io/badge/License-MIT-lightgreen.svg)](LICENSE)
 
-[![Gem Version](https://d25lcipzij17d.cloudfront.net/badge.svg?id=rb&r=r&ts=1683906897&type=6e&v=0.4.0&x2=0)](https://badge.fury.io/rb/string_magic)
-[![CircleCI](https://dl.circleci.com/status-badge/img/circleci/8MamMcAVAVNWTcUqkjQk7R/Sh2DQkMWqqCv4MFvAmYWDL/tree/main.svg?style=svg&circle-token=CCIPRJ_PF8xu3Svcj2Ro4D8jhjCi7_71b7c0a7c781e09fc7194cd58cca67aecdc111b5)](https://dl.circleci.com/status-badge/redirect/circleci/8MamMcAVAVNWTcUqkjQk7R/Sh2DQkMWqqCv4MFvAmYWDL/tree/main)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+**StringMagic** super-charges Ruby's `String` with batteries-included helpers for formatting, validation, analysis, transformation, and security all in one tidy gem.
 
-## Summary
+## Why StringMagic?
+- Zero dependencies – pure Ruby
+- Non-destructive: original strings are never mutated
+- Thread-safe & fully tested (160+ RSpec examples, ~98% coverage)
+- Drop-in: optionally auto-mixes into String, or use module methods (`StringMagic.to_slug(...)`)
 
-A gem that enhances Ruby's string class with an array of versatile methods designed for enhanced text formatting, manipulation, and analysis.
-
-## Description
-
-The StringMagic gem enriches Ruby's string class by adding a suite of versatile methods. These methods offer extended capabilities for formatting, manipulating, and querying text, making string operations more efficient and expressive.
-
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/string_magic`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-## Installation
-
-Add this line to your Gemfile:
+## Quickstart Cheatsheet
 
 ```ruby
-gem 'string_magic'
+# Formatting
+"Hello world".truncate_words(1)             # => "Hello..."
+"user@domain.com".mask_emails               # => "u********@domain.com"
+"Ruby on Rails".highlight('Ruby')           # => "<mark>Ruby</mark> on Rails"
+
+# Validation
+"test@example.com".email?                   # => true
+"4111111111111111".credit_card?             # => true
+"racecar".palindrome?                       # => true
+
+# Transformation
+"CamelCase".to_snake_case                   # => "camel_case"
+"user input".to_filename_safe               # => "user_input"
+"second".ordinalize                         # => "2nd"
+
+# Analysis
+"Visit https://example.com".extract_urls    # => ["https://example.com"]
+"Great product!".sentiment_indicators       # => {:positive=>1.0, :negative=>0.0, :neutral=>0}
 ```
 
-And then execute:
-
-```ruby
-bundle install
-```
-
-Or install it globally:
-
-```ruby
+## Installation
+```bash
 gem install string_magic
 ```
-
-## Usage
-
+Or add to your Gemfile:
 ```ruby
-require 'string_magic'
-
-# Example usage
-string = "hello world"
-puts StringMagic.palindrome?(string)
+gem 'string_magic'
 ```
 
-## Development
+## Full Documentation
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run rake spec to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+### Core Operations
+- **Case conversion**: `to_snake_case`, `to_kebab_case`, `to_camel_case`, `to_pascal_case`, `to_title_case`
+- **Text manipulation**: `reverse_words`, `alternating_case`, `remove_duplicate_chars`, `remove_duplicate_words`
+- **HTML handling**: `remove_html_tags`, `escape_html`
 
-To install this gem onto your local machine, run:
+### Validation
+- Format checks: `email?`, `url?`, `phone?`, `credit_card?`
+- Text relations: `palindrome?`, `anagram_of?`
+- Password strength: `strong_password?`
 
-```ruby
-bundle exec rake install
-```
+### Analysis
+- **Entity extraction**: `extract_emails`, `extract_urls`, `extract_phones`, `extract_dates`
+- **Text metrics**: `readability_score`, `word_frequency`, `sentiment_indicators`
 
-To release a new version, update the version number in version.rb, and then run:
+### Formatting
+- **Truncation**: `truncate_words`, `truncate_sentences`, `truncate_characters`, `smart_truncate`
+- **Highlighting**: `highlight`, `remove_highlights`, `highlight_urls`
 
-```ruby
-bundle exec rake release
-```
+### Security
+- **Data masking**: `mask_sensitive_data`, `mask_credit_cards`, `mask_emails`, `mask_phones`
+- **Detection**: `contains_sensitive_data?`
 
-This will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+### Utilities
+- **Inflection**: `to_plural`, `to_singular`, `ordinalize`, `humanize`
+- **Slug generation**: `to_slug`, `to_url_slug`, `to_filename_safe`
 
 ## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/erscript/string-magic. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/erscript/string-magic/blob/main/CODE_OF_CONDUCT.md).
+1. Fork → `git checkout -b feature/awesome`
+2. Add specs for your change
+3. `bundle exec rspec`
+4. PR ✉️ – we love improvements!
 
 ## License
-
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-
-## Code of Conduct
-
-Everyone interacting in the StringMagic project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the [code of conduct](https://github.com/erscript/string-magic/blob/main/CODE_OF_CONDUCT.md).
+MIT - See [LICENSE](LICENSE) for details.

data/lib/string_magic/advanced/security.rb

@@ -1,38 +1,117 @@
+# frozen_string_literal: true
+
 module StringMagic
   module Advanced
     module Security
-      def mask_sensitive_data(text, options = {})
-        return text if text.nil? || text.empty?
+      # ------------------------------------------------------------
+      # Public API
+      # ------------------------------------------------------------
+
+      # Detects and masks sensitive data in the string.
+      #
+      # options:
+      #   :mask_char      → character to use for masking   (default '*')
+      #   :preserve_count → trailing digits to leave clear (default 4)
+      #   :types          → array of types to mask         (default [:credit_card, :ssn, :email, :phone])
+      #
+      def mask_sensitive_data(options = {})
+        return '' if empty?
 
-        mask_char = options[:mask_char] || "*"
-        options[:preserve_count] || 4
+        mask_char      = options.fetch(:mask_char, '*')
+        preserve_count = options.fetch(:preserve_count, 4)
+        types          = options.fetch(:types, %i[credit_card ssn email phone])
 
         patterns = {
-          credit_card: /\b\d{4}[-\s]?\d{4}[-\s]?\d{4}[-\s]?\d{4}\b/,
-          ssn: /\b\d{3}[-\s]?\d{2}[-\s]?\d{4}\b/,
-          email: /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/
+          credit_card: /\b(?:\d{4}[-\s]?){3}\d{4}\b/,
+          ssn:         /\b\d{3}[-\s]?\d{2}[-\s]?\d{4}\b/,
+          email:       /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/,
+          phone:       /(?:\+\d{1,3}[-.\s]?)?\(?\d{3}\)?[-.\s]?\d{3}[-.\s]?\d{4}(?!\d)/
         }
 
-        result = text.dup
+        result = dup
+        types.each do |type|
+          next unless patterns[type]
 
-        patterns.each do |type, pattern|
-          result.gsub!(pattern) do |match|
+          result.gsub!(patterns[type]) do |match|
             case type
-            when :credit_card
-              digits = match.gsub(/[-\s]/, "")
-              mask_char * 12 + digits[-4..]
-            when :ssn
-              digits = match.gsub(/[-\s]/, "")
-              mask_char * 5 + digits[-4..]
-            when :email
-              local, domain = match.split("@")
-              "#{mask_char * local.length}@#{domain}"
+            when :credit_card then mask_credit_card(match, mask_char, preserve_count)
+            when :ssn         then mask_ssn(match, mask_char, preserve_count)
+            when :email       then mask_email(match, mask_char)
+            when :phone       then mask_phone(match, mask_char, preserve_count)
             end
           end
         end
-
         result
       end
+
+      # Convenience wrappers
+      def mask_credit_cards(mask_char: '*', preserve_count: 4)
+        mask_sensitive_data(types: [:credit_card], mask_char: mask_char, preserve_count: preserve_count)
+      end
+
+      def mask_emails(mask_char: '*')
+        mask_sensitive_data(types: [:email], mask_char: mask_char)
+      end
+
+      def mask_phones(mask_char: '*', preserve_count: 4)
+        mask_sensitive_data(types: [:phone], mask_char: mask_char, preserve_count: preserve_count)
+      end
+
+      def contains_sensitive_data?
+        return false if empty?
+
+        [
+          /\b(?:\d{4}[-\s]?){3}\d{4}\b/,                 # Credit card
+          /\b\d{3}[-\s]?\d{2}[-\s]?\d{4}\b/,             # SSN
+          /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/ # Email
+        ].any? { |re| match?(re) }
+      end
+
+      # ------------------------------------------------------------
+      # Private helpers
+      # ------------------------------------------------------------
+      private
+
+      # Mask a phone number while preserving formatting characters and last n digits.
+      def mask_phone(original, mask_char, preserve_count)
+        digits_only      = original.gsub(/\D/, '')
+        return original if digits_only.length <= preserve_count
+
+        masked_part      = mask_char * (digits_only.length - preserve_count)
+        preserved_part   = digits_only[-preserve_count..]
+        replacement_pool = (masked_part + preserved_part).chars
+        index            = 0
+
+        original.gsub(/\d/) { replacement_pool[index].tap { index += 1 } }
+      end
+
+      def mask_credit_card(original, mask_char, preserve_count)
+        digits = original.gsub(/\D/, '')
+        masked_len = [digits.length - preserve_count, 0].max
+        mask_char * masked_len + digits[-preserve_count..]
+      end
+
+      def mask_ssn(original, mask_char, preserve_count)
+        mask_credit_card(original, mask_char, preserve_count)
+      end
+
+      # Email masking policy:
+      # - If local part length <= 4 → keep first char, then 8 mask chars (e.g. "mail" => "m********")
+      # - Else → keep first char, mask the remainder (no last-char preservation)
+      def mask_email(original, mask_char)
+        local, domain = original.split('@', 2)
+        if local.length <= 4
+          masked_local = local[0] + (mask_char * 8)
+        else
+          masked_local = local[0] + (mask_char * (local.length - 1))
+        end
+        "#{masked_local}@#{domain}"
+      end
     end
   end
 end
+
+# Optional automatic mix-in
+class String
+  include StringMagic::Advanced::Security
+end

data/lib/string_magic/core/analysis.rb

@@ -1,49 +1,140 @@
+# frozen_string_literal: true
+
 module StringMagic
   module Core
     module Analysis
-      def extract_entities(text)
-        raise MalformedInputError, "Input must be a string" unless text.is_a?(String)
+      # ------------------------------------------------------------------
+      # Entity extraction
+      # ------------------------------------------------------------------
+
+      def extract_entities
+        return default_entities_hash if empty?
 
         {
-          emails: text.scan(/\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/).uniq,
-          urls: text.scan(%r{(?:https?:)?//[^\s/$.?#][^\s,]*}).uniq,
-          phone_numbers: text.scan(/(?:\+\d{1,3}\s?)?\(?\d{3}\)?[-.\s]?\d{3}[-.\s]?\d{4}\b/).uniq,
-          dates: text.scan(%r{\b(?:\d{1,2}[-/]\d{1,2}[-/]\d{2,4}|(?:(?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)[a-z]*|(?:January|February|March|April|May|June|July|August|September|October|November|December)) \d{1,2},? \d{4}|\d{4}[-/]\d{1,2}[-/]\d{1,2})\b}i).uniq,
-          hashtags: text.scan(/#[[:word:]]+/).map { |tag| tag[1..] }.uniq,
-          mentions: text.scan(/@[[:word:]]+/).map { |mention| mention[1..] }.uniq
+          emails:        extract_emails,
+          urls:          extract_urls,
+          phone_numbers: extract_phones,
+          dates:         extract_dates,
+          hashtags:      extract_hashtags,
+          mentions:      extract_mentions
         }
       end
 
-      def readability_score(text)
-        return 0 if text.empty?
+      def extract_emails
+        return [] if empty?
+        scan(/\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/).uniq
+      end
+
+      def extract_urls
+        return [] if empty?
+        
+        # initial capture
+        urls = scan(%r{https?://[^\s<>"']+|www\.[^\s<>"']+})
+        
+        # strip trailing punctuation like . , ; : ! ? )
+        urls.map { |u| u.gsub(/[\.,;:!?)+]+\z/, '') }.uniq
+      end
+
+      def extract_phones
+        return [] if empty?
+        phone_re = /(?:\+\d{1,3}[-.\s]?)?\(?\d{3}\)?[-.\s]?\d{3}[-.\s]?\d{4}(?!\d)/
+        scan(phone_re).uniq
+      end
+
+      def extract_dates
+        return [] if empty?
+
+        patterns = [
+          %r{\b\d{1,2}[-/]\d{1,2}[-/]\d{2,4}\b},   # 01/31/2025  or 31-01-25
+          %r{\b\d{4}[-/]\d{1,2}[-/]\d{1,2}\b},     # 2025-01-31
+          /\b(?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)[a-z]*\.?\s+\d{1,2},?\s+\d{4}\b/i,
+          /\b\d{1,2}\s+(?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)[a-z]*\.?\s+\d{4}\b/i
+        ]
+
+        patterns.flat_map { |re| scan(re) }.uniq
+      end
+
+      def extract_hashtags
+        return [] if empty?
+        scan(/#(\w+)/).flatten.uniq
+      end
+
+      def extract_mentions
+        return [] if empty?
+        scan(/(?:^|\s)@([A-Za-z0-9_]+)/).flatten.uniq
+      end
+
+      # ------------------------------------------------------------------
+      # Text statistics
+      # ------------------------------------------------------------------
 
-        sentences = text.split(/[.!?]+/)
-                        .map(&:strip)
-                        .reject(&:empty?)
+      def readability_score
+        return 0.0 if empty?
 
-        return 0 if sentences.empty? || !text.match?(/[.!?]/)
+        sentences = split(/[.!?]+/).map(&:strip).reject(&:empty?)
+        return 0.0 if sentences.empty?
 
-        words = text.split(/\s+/)
-        return 0 if words.empty?
+        words = scan(/\b[\p{L}\p{N}'-]+\b/)
+        return 0.0 if words.empty?
 
-        syllables = words.sum { |word| calculate_syllables(word) }
+        syllables = words.sum { |w| calculate_syllables(w) }
+        return 0.0 if syllables.zero?
 
-        score = (0.39 * (words.length.to_f / sentences.length) +
-                11.8 * (syllables.to_f / words.length) - 15.59)
+        score = 0.39 * (words.size.to_f / sentences.size) +
+                11.8 * (syllables.to_f / words.size) - 15.59
 
-        [score.round(1), 0].max
+        score.round(1).clamp(0, Float::INFINITY)
       end
 
+      def word_frequency
+        return {} if empty?
+        downcase.scan(/\b[\p{L}\p{N}'-]+\b/).tally
+      end
+
+      def sentiment_indicators
+        return { positive: 0, negative: 0, neutral: 1 } if empty?
+
+        positive_words = %w[good great excellent amazing wonderful fantastic happy joy love like best awesome]
+        negative_words = %w[bad terrible awful horrible sad hate dislike worst annoying frustrating]
+
+        words = downcase.scan(/\b[\p{L}\p{N}'-]+\b/)
+        pos   = words.count { |w| positive_words.include?(w) }
+        neg   = words.count { |w| negative_words.include?(w) }
+        total = pos + neg
+
+        if total.zero?
+          { positive: 0, negative: 0, neutral: 1 }
+        else
+          { positive: (pos.to_f / total).round(2),
+            negative: (neg.to_f / total).round(2),
+            neutral: 0 }
+        end
+      end
+
+      # ------------------------------------------------------------------
+      # Private helpers
+      # ------------------------------------------------------------------
       private
 
+      def default_entities_hash
+        { emails: [], urls: [], phone_numbers: [], dates: [], hashtags: [], mentions: [] }
+      end
+
+      # Rough syllable estimator (en-US)
       def calculate_syllables(word)
-        word = word.downcase.gsub(/[^a-z]/, "")
-        return 0 if word.empty?
+        w = word.downcase.gsub(/[^a-z]/, '')
+        return 1 if w.length <= 2
 
-        count = word.scan(/[aeiou]+/i).size
-        count -= 1 if word.end_with?("e")
+        count = w.scan(/[aeiouy]+/).size
+        count -= 1 if w.end_with?('e') && count > 1
+        count += 1 if w.end_with?('le') && w[-3] !~ /[aeiouy]/i
         [count, 1].max
       end
     end
   end
 end
+
+# Optional auto-mix-in
+class String
+  include StringMagic::Core::Analysis
+end

data/lib/string_magic/core/transformation.rb

@@ -1,54 +1,102 @@
+# frozen_string_literal: true
+
+require 'cgi' # for HTML escaping
+
 module StringMagic
   module Core
     module Transformation
-      def titleize_names(text)
-        return text if text.nil? || text.empty?
+      # ------------------------------------------------------------
+      # Case conversions
+      # ------------------------------------------------------------
+
+      def to_snake_case
+        return '' if empty?
+
+        str = dup
+        str.gsub!(/::/, '/')
+        str.gsub!(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+        str.gsub!(/([a-z\d])([A-Z])/,  '\1_\2')
+        str.tr!('-', '_')
+        str.gsub!(/\s+/, '_')
+        str.downcase!
+        str.squeeze('_').gsub(/^_+|_+$/, '')
+      end
+
+      def to_kebab_case
+        to_snake_case.tr('_', '-')
+      end
+
+      # first_letter: :lower (default) or :upper
+      def to_camel_case(first_letter: :lower)
+        return '' if empty?
+
+        words = to_snake_case.split('_').map(&:capitalize)
+        words[0].downcase! if first_letter == :lower && words.any?
+        words.join
+      end
 
-        special_cases = {
-          "mcdonald" => "McDonald",
-          "o'reilly" => "O'Reilly",
-          "macbook" => "MacBook",
-          "iphone" => "iPhone",
-          "ipad" => "iPad",
-          "ebay" => "eBay"
-        }
+      def to_pascal_case
+        to_camel_case(first_letter: :upper)
+      end
+
+      def to_title_case
+        return '' if empty?
+
+        small = %w[a an and as at but by for if in nor of on or so the to up yet]
+        words = downcase.split(/\s+/)
+        words.map!.with_index do |w, i|
+          (i.zero? || i == words.size - 1 || !small.include?(w)) ? w.capitalize : w
+        end
+        words.join(' ')
+      end
+
+      # ------------------------------------------------------------
+      # Simple word / char utilities
+      # ------------------------------------------------------------
 
-        prefixes = Set.new(%w[van de la du das dos di da delle degli delle])
-        articles = Set.new(%w[a an the]) # Add this line
+      def reverse_words
+        return '' if empty?
+        split(/\s+/).reverse.join(' ')
+      end
 
-        words = text.downcase.split(/\s+/)
-        words.map.with_index do |word, index|
-          if special_cases.key?(word)
-            special_cases[word]
-          elsif prefixes.include?(word) && !index.zero?
-            word
-          elsif articles.include?(word) && !index.zero? # Add this condition
-            word.downcase
-          else
-            word.capitalize
-          end
-        end.join(" ")
+      def alternating_case
+        return '' if empty?
+        each_char.with_index.map { |c, i| i.even? ? c.upcase : c.downcase }.join
       end
 
-      def to_snake_case(string)
-        return "" if string.nil?
+      def remove_duplicate_chars
+        return '' if empty?
+        each_char.to_a.uniq.join
+      end
 
-        string.gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
-              .gsub(/([a-z\d])([A-Z])/, '\1_\2')
-              .tr("-", "_")
-              .downcase
+      def remove_duplicate_words
+        return '' if empty?
+        split(/\s+/).uniq.join(' ')
       end
 
-      def to_kebab_case(string)
-        to_snake_case(string).tr("_", "-")
+      # ------------------------------------------------------------
+      # Misc. text transformations
+      # ------------------------------------------------------------
+
+      def squeeze_whitespace
+        return '' if empty?
+        gsub(/\s+/, ' ').strip
       end
 
-      def to_pascal_case(string)
-        return "" if string.nil?
-        return string if string.match?(/^[A-Z][a-z]*([A-Z][a-z]*)*$/)
+      def remove_html_tags
+        return '' if empty?
+        gsub(/<[^>]*>/, '')
+      end
 
-        string.split(/[-_\s]+/).map(&:capitalize).join
+      def escape_html
+        return '' if empty?
+        CGI.escapeHTML(self)
       end
     end
   end
 end
+
+# Optional automatic mix-in
+class String
+  include StringMagic::Core::Transformation
+end

data/lib/string_magic/core/validation.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module StringMagic
+  module Core
+    module Validation
+      # ------------------------------------------------------------
+      # Basic format checks
+      # ------------------------------------------------------------
+
+      def email?
+        !!(self =~ /\A[\w+\-.]+@[a-z\d\-]+(\.[a-z\d\-]+)*\.[a-z]+\z/i)
+      end
+
+      def url?
+        !!(self =~ /\A#{URI::DEFAULT_PARSER.make_regexp(%w[http https])}\z/)
+      end
+
+      def phone?
+        digits = gsub(/\D/, '')
+        (10..15).cover?(digits.length)
+      end
+
+      # ------------------------------------------------------------
+      # Credit-card number (Luhn)
+      # ------------------------------------------------------------
+
+      def credit_card?
+        digits = gsub(/\D/, '')
+        return false unless (13..19).cover?(digits.length)
+
+        sum = digits.reverse.chars.each_with_index.sum do |ch, idx|
+          n = ch.to_i
+          n *= 2 if idx.odd?
+          n > 9 ? n - 9 : n
+        end
+        (sum % 10).zero?
+      end
+
+      # ------------------------------------------------------------
+      # Text relationships
+      # ------------------------------------------------------------
+
+      def palindrome?
+        cleaned = downcase.gsub(/[^a-z0-9]/, '')
+        cleaned == cleaned.reverse && !cleaned.empty?
+      end
+
+      def anagram_of?(other)
+        return false if other.nil? || other.empty?
+
+        norm = ->(s) { s.downcase.gsub(/[^a-z0-9]/, '').chars.sort.join }
+        !empty? && norm.call(self) == norm.call(other)
+      end
+
+      # ------------------------------------------------------------
+      # Number checks
+      # ------------------------------------------------------------
+
+      def numeric?
+        !!(self =~ /\A-?(?:\d+\.?\d*|\.\d+)\z/)
+      end
+
+      def integer?
+        !!(self =~ /\A-?\d+\z/)
+      end
+
+      # ------------------------------------------------------------
+      # Password strength
+      # ------------------------------------------------------------
+
+      def strong_password?(min_length: 8)
+        return false if length < min_length
+
+        /[A-Z]/.match?(self) &&
+          /[a-z]/.match?(self) &&
+          /\d/.match?(self) &&
+          /[^A-Za-z0-9]/.match?(self)
+      end
+    end
+  end
+end
+
+# Optional auto-mix-in
+class String
+  include StringMagic::Core::Validation
+end

data/lib/string_magic/formatting/highlighting.rb

@@ -1,19 +1,66 @@
+# frozen_string_literal: true
+
 module StringMagic
   module Formatting
     module Highlighting
-      def highlight(text, phrases, options = {})
-        return text if text.nil? || phrases.nil?
+      # ------------------------------------------------------------
+      # Generic phrase highlighting
+      # ------------------------------------------------------------
+      #
+      # highlight(%w[ruby rails], tag: 'span',
+      #            css_class: 'hit', case_sensitive: false)
+      #
+      def highlight(phrases, tag: 'mark', css_class: nil, case_sensitive: true)
+        return '' if empty?
+
+        phrases = Array(phrases).compact.reject(&:empty?)
+        return self if phrases.empty?
 
-        tag = options[:tag] || "mark"
-        css_class = options[:class]
-        phrases = Array(phrases)
+        klass = css_class ? %( class="#{css_class}") : ''
+        esc   = phrases.sort_by(&:length).reverse.map { |p| Regexp.escape(p) }
+        regex = Regexp.union(esc)
+        regex = Regexp.new(regex.source, Regexp::IGNORECASE) unless case_sensitive
 
-        class_attr = css_class ? %( class="#{css_class}") : ""
+        gsub(regex) { |m| "<#{tag}#{klass}>#{m}</#{tag}>" }
+      end
 
-        phrases.reduce(text) do |result, phrase|
-          result.gsub(/(#{Regexp.escape(phrase)})/i, "<#{tag}#{class_attr}>\\1</#{tag}>")
+      # ------------------------------------------------------------
+      # Remove previously added highlighting
+      # ------------------------------------------------------------
+      #
+      # remove_highlights            # strips ALL html tags
+      # remove_highlights('mark')    # strips only <mark>…</mark>
+      #
+      def remove_highlights(tag = nil)
+        return '' if empty?
+
+        if tag
+          gsub(/<#{Regexp.escape(tag)}[^>]*>(.*?)<\/#{Regexp.escape(tag)}>/im, '\1')
+        else
+          gsub(/<[^>]+>/, '')
         end
       end
+
+      # ------------------------------------------------------------
+      # Auto-link / highlight URLs
+      # ------------------------------------------------------------
+      #
+      # highlight_urls(css_class: 'link', target: '_blank')
+      #
+      def highlight_urls(tag: 'a', css_class: nil, target: nil)
+        return '' if empty?
+
+        klass  = css_class ? %( class="#{css_class}") : ''
+        tgt    = target    ? %( target="#{target}")  : ''
+        url_re = %r{https?://[^\s<>"']+}i
+
+        gsub(url_re) { |url| %(<#{tag} href="#{url}"#{klass}#{tgt}>#{url}</#{tag}>) }
+      end
     end
   end
 end
+
+# Optional automatic mix-in
+class String
+  include StringMagic::Formatting::Highlighting
+end

data/lib/string_magic/formatting/truncation.rb

@@ -1,25 +1,78 @@
+# frozen_string_literal: true
+
 module StringMagic
   module Formatting
     module Truncation
-      def truncate_words(text, count, options = {})
-        return text if text.nil? || count.nil? || count < 1
+      # ------------------------------------------------------------
+      # Word-based
+      # ------------------------------------------------------------
+      def truncate_words(limit, suffix: '...', separator: ' ')
+        return '' if empty?
+        words = split(separator)
+        return self if words.size <= limit
+        words.first(limit).join(separator) + suffix
+      end
+
+      # ------------------------------------------------------------
+      # Sentence-based
+      # ------------------------------------------------------------
+      def truncate_sentences(limit, suffix: '...')
+        return '' if empty?
+        sentences = split(/(?<=[.!?])\s+/)
+        return self if sentences.size <= limit
+        result = sentences.first(limit).join(' ')
+        result.chomp!('.')
+        result.chomp!('!')
+        result.chomp!('?')
+        result += suffix unless result == self
+      end
 
-        suffix = options[:suffix] || "..."
-        words = text.split(/\s+/)
-        return text if words.length <= count
+      # ------------------------------------------------------------
+      # Character-based
+      # ------------------------------------------------------------
+      #
+      # break_on_word: true  → keep whole words
+      # break_on_word: false → may cut mid-word (default)
+      #
+      def truncate_characters(limit, suffix: '...', break_on_word: false)
+        return '' if empty? || length <= limit
+        
+        # When break_on_word is true, we want the result to be exactly `limit` chars total
+        target_content_len = limit - suffix.length
+        return suffix[0, limit] if target_content_len <= 0
 
-        words[0...count].join(" ") + suffix
+        if break_on_word
+          cut = rindex(' ', target_content_len) || target_content_len
+          self[0, cut].rstrip + suffix
+        else
+          self[0, target_content_len] + suffix
+        end
       end
 
-      def truncate_sentences(text, count, options = {})
-        return text if text.nil? || count.nil? || count < 1
+      # ------------------------------------------------------------
+      # "Smart" truncate: sentence ▸ word ▸ hard cut
+      # ------------------------------------------------------------
+      def smart_truncate(limit, suffix: '...')
+        return '' if empty? || length <= limit
+        hard_len = limit - suffix.length
+        return suffix[0, limit] if hard_len.negative?
+
+        # Try sentence boundary
+        sent_break = rindex(/[.!?]\s/, hard_len)
+        return self[0..sent_break].rstrip + suffix if sent_break && sent_break > limit * 0.5
 
-        suffix = options[:suffix] || "..."
-        sentences = text.split(/(?<=[.!?])\s+/)
-        return text if sentences.length <= count
+        # Try word boundary
+        word_break = rindex(' ', hard_len)
+        return self[0, word_break].rstrip + suffix if word_break && word_break > limit * 0.3
 
-        sentences[0...count].join(" ") + suffix
+        # Fallback
+        self[0, hard_len] + suffix
       end
     end
   end
 end
+
+# Optional auto-mix-in
+class String
+  include StringMagic::Formatting::Truncation
+end

data/lib/string_magic/utilities/inflection.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module StringMagic
+  module Utilities
+    module Inflection
+      # ------------------------------------------------------------
+      # Plural ↔ singular
+      # ------------------------------------------------------------
+
+      def to_plural
+        return '' if empty?
+
+        case downcase
+        when /(s|sh|ch|x|z)\z/                 then self + 'es'
+        when /[^aeiou]y\z/i                    then chop + 'ies'
+        when /(f|fe)\z/                        then sub(/(f|fe)\z/, 'ves')
+        else                                       self + 's'
+        end
+      end
+
+      def to_singular
+        return '' if empty?
+
+        down = downcase
+        if    down.end_with?('ies')           then sub(/ies\z/i, 'y')
+        elsif down.end_with?('ves') && length > 3
+          sub(/ves\z/i, down[-4] == 'i' ? 'fe' : 'f') # knives → knife, leaves → leaf
+        elsif down =~ /(ses|shes|ches|xes|zes)\z/i    then sub(/es\z/i, '')
+        elsif down.end_with?('s') && length > 1       then chop
+        else                                           self
+        end
+      end
+
+      # ------------------------------------------------------------
+      # Ordinalisation
+      # ------------------------------------------------------------
+      #
+      # '1'.ordinalize  #=> '1st'
+      #
+      def ordinalize
+        return self unless /\A-?\d+\z/.match?(self)
+
+        num = to_i
+        suffix = if (11..13).cover?(num % 100)
+                   'th'
+                 else
+                   { 1 => 'st', 2 => 'nd', 3 => 'rd' }.fetch(num % 10, 'th')
+                 end
+        self + suffix
+      end
+
+      # ------------------------------------------------------------
+      # Human-readable
+      # ------------------------------------------------------------
+
+      def humanize
+        return '' if empty?
+        gsub('_', ' ')
+          .gsub(/([a-z])([A-Z])/, '\1 \2')
+          .downcase
+          .strip
+          .capitalize
+      end
+    end
+  end
+end
+
+# Optional auto-mix-in
+class String
+  include StringMagic::Utilities::Inflection
+end

data/lib/string_magic/utilities/slug.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module StringMagic
+  module Utilities
+    module Slug
+      # ------------------------------------------------------------------
+      # Public helpers
+      # ------------------------------------------------------------------
+
+      def to_slug(separator: '-', preserve_case: false)
+        return '' if empty?
+
+        result = dup
+        result.downcase! unless preserve_case
+        result = transliterate_accents(result)
+        result.gsub!(/<[^>]*>/, '')                       # strip HTML
+        result.gsub!(/[^A-Za-z0-9]+/, separator)          # non-alnum → sep
+        result.gsub!(/^#{Regexp.escape(separator)}+|#{Regexp.escape(separator)}+$/, '')
+        result
+      end
+
+      def to_url_slug
+        to_slug(separator: '-', preserve_case: false)
+      end
+
+      def to_filename_safe(replacement: '_', preserve_case: false)
+        return '' if empty?
+        result = transliterate_accents(dup)
+        result.downcase! unless preserve_case
+        result.gsub!(/[^0-9A-Za-z\.\-]+/, replacement)               # keep only safe chars
+        # convert file extension: ".txt" → "_txt"
+        result.gsub!(/\.([a-z0-9]{1,5})\z/i, "#{replacement}\\1")
+        result.gsub!(/\.+$/, '')                                      # drop any remaining trailing dots
+        result.gsub!(/#{Regexp.escape(replacement)}+/, replacement)   # collapse runs
+        result.gsub!(/^#{Regexp.escape(replacement)}+|#{Regexp.escape(replacement)}+$/, '') # trim
+        result = 'untitled'  if result.empty?
+        result = "#{result}_file" if reserved_filename?(result)
+        result
+      end
+
+      def slugify_path(separator: '/')
+        return '' if empty?
+        split('/').map { |seg| seg.to_slug }.reject(&:empty?).join(separator)
+      end
+
+      def extract_slug_from_url
+        return '' if empty?
+        clean = split('/').last.to_s.split(/[?#]/).first
+        clean.gsub!(/\.\w+$/, '') if clean.match?(/\.\w+$/)
+        clean
+      end
+
+      # ------------------------------------------------------------------
+      # Private helpers
+      # ------------------------------------------------------------------
+      private
+
+      def transliterate_accents(text)
+        accents = {
+          'À'=>'A','Á'=>'A','Â'=>'A','Ã'=>'A','Ä'=>'A','Å'=>'A',
+          'à'=>'a','á'=>'a','â'=>'a','ã'=>'a','ä'=>'a','å'=>'a',
+          'È'=>'E','É'=>'E','Ê'=>'E','Ë'=>'E',
+          'è'=>'e','é'=>'e','ê'=>'e','ë'=>'e',
+          'Ì'=>'I','Í'=>'I','Î'=>'I','Ï'=>'I',
+          'ì'=>'i','í'=>'i','î'=>'i','ï'=>'i',
+          'Ò'=>'O','Ó'=>'O','Ô'=>'O','Õ'=>'O','Ö'=>'O',
+          'ò'=>'o','ó'=>'o','ô'=>'o','õ'=>'o','ö'=>'o',
+          'Ù'=>'U','Ú'=>'U','Û'=>'U','Ü'=>'U',
+          'ù'=>'u','ú'=>'u','û'=>'u','ü'=>'u',
+          'Ñ'=>'N','ñ'=>'n',
+          'Ç'=>'C','ç'=>'c',
+          'ß'=>'ss'
+        }
+        accents.each { |from, to| text.gsub!(from, to) }
+        text
+      end
+
+      def reserved_filename?(name)
+        %w[
+          CON PRN AUX NUL COM1 COM2 COM3 COM4 COM5 COM6 COM7 COM8 COM9
+          LPT1 LPT2 LPT3 LPT4 LPT5 LPT6 LPT7 LPT8 LPT9
+        ].include?(name.upcase)
+      end
+    end
+  end
+end
+
+# Optional auto-mix-in
+class String
+  include StringMagic::Utilities::Slug
+end

data/lib/string_magic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module StringMagic
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/lib/string_magic.rb

@@ -2,10 +2,24 @@
 
 require_relative "string_magic/version"
 require_relative "string_magic/core/analysis"
-require_relative "string_magic/core/transformation"
+require_relative "string_magic/core/transformation" 
+require_relative "string_magic/core/validation"
 require_relative "string_magic/formatting/highlighting"
 require_relative "string_magic/formatting/truncation"
 require_relative "string_magic/advanced/security"
+require_relative "string_magic/utilities/slug"
+require_relative "string_magic/utilities/inflection"
+
+class String
+  include StringMagic::Core::Analysis
+  include StringMagic::Core::Transformation
+  include StringMagic::Core::Validation
+  include StringMagic::Formatting::Highlighting
+  include StringMagic::Formatting::Truncation
+  include StringMagic::Advanced::Security
+  include StringMagic::Utilities::Slug
+  include StringMagic::Utilities::Inflection
+end
 
 module StringMagic
   class Error < StandardError; end
@@ -13,68 +27,10 @@ module StringMagic
 
   extend Core::Analysis
   extend Core::Transformation
+  extend Core::Validation
   extend Formatting::Highlighting
   extend Formatting::Truncation
   extend Advanced::Security
-
-  def self.hello_world
-    "hello world!"
-  end
-
-  def self.word_count(string)
-    string.split.size
-  end
-
-  def self.palindrome?(string)
-    cleaned = string.downcase.gsub(/[^a-z0-9]/, "")
-    cleaned == cleaned.reverse
-  end
-
-  def self.capitalize_words(string)
-    string.split.map(&:capitalize).join(" ")
-  end
-
-  def self.reverse_words(string)
-    string.split.reverse.join(" ")
-  end
-
-  def self.remove_duplicates(string)
-    string.chars.uniq.join
-  end
-
-  def self.count_vowels(string)
-    string.downcase.count("aeiou")
-  end
-
-  def self.to_pig_latin(string)
-    string.split.map do |word|
-      if word[0] =~ /[aeiou]/i
-        word + "ay"
-      else
-        word[1..-1] + word[0] + "ay"
-      end
-    end.join(" ")
-  end
-
-  def self.alternating_case(string)
-    string.chars.map.with_index { |char, i| i.even? ? char.upcase : char.downcase }.join
-  end
-
-  def self.camel_case(string)
-    string.split.map(&:capitalize).join
-  end
-
-  def self.snake_case(string)
-    string.downcase.gsub(/\s+/, "_")
-  end
-
-  def self.title_case(string)
-    string.split.map(&:capitalize).join(" ")
-  end
-
-  def self.anagram?(string1, string2)
-    processed_string1 = string1.downcase.gsub(/[^a-z0-9]/, "").chars.sort.join
-    processed_string2 = string2.downcase.gsub(/[^a-z0-9]/, "").chars.sort.join
-    processed_string1 == processed_string2
-  end
-end
+  extend Utilities::Slug
+  extend Utilities::Inflection
+end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: string_magic
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Emad Rahimi
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-01-02 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -72,8 +71,11 @@ files:
 - lib/string_magic/advanced/security.rb
 - lib/string_magic/core/analysis.rb
 - lib/string_magic/core/transformation.rb
+- lib/string_magic/core/validation.rb
 - lib/string_magic/formatting/highlighting.rb
 - lib/string_magic/formatting/truncation.rb
+- lib/string_magic/utilities/inflection.rb
+- lib/string_magic/utilities/slug.rb
 - lib/string_magic/version.rb
 - sig/string_magic.rbs
 homepage: https://github.com/erscript/string-magic
@@ -83,7 +85,6 @@ metadata:
   homepage_uri: https://github.com/erscript/string-magic
   source_code_uri: https://github.com/erscript/string-magic
   changelog_uri: https://github.com/erscript/string-magic/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -98,8 +99,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: The StringMagic gem enriches Ruby's string class with an array of versatile
   methods designed for enhanced text formatting, manipulation, and analysis.