no_regex 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a468f27fb587ec14c92c7a9164acc0afbe38f904fbc765bd206d589cc5e90c4e
-  data.tar.gz: 3c6b9c9d8c6179034637022cc010bfd19ff02968ca5a8bf174fb8ac548b7058f
+  metadata.gz: 14eee48041a9af9e8eb4d1b7fc16ad89ea2655897e5171dd1f7061cb5a982a92
+  data.tar.gz: 45673b07974a3814c9d3db94fac6177ce8ca98f428e38de42dbd1e5ab3132034
 SHA512:
-  metadata.gz: 1f380a614f7a93833d25e748240033b7ef88585140f0a4b2289c402f4336a1b974eff1ffcfa312ceec15831b07193941b7d3ec268cf6655ff44b16c61b35ea10
-  data.tar.gz: 21083b7f2f777552af3541f00e0a9f8a4cf99f65e0c98d29b7904f5f0509842118a88b94a06eb3e41e07600feddd8d31c10529fd5ce92a803231904aaeba4b6a
+  metadata.gz: c2697530e3cb7641968aae80d95026f5efc990ee327765697fb084517a3aa2de88facb9eb7139c40e6f68d5a0ac1321818337f75cabe7cc1bc95a626285d0a45
+  data.tar.gz: 620a663f1a22948421f04c3f975301e15f0cbc623065c1814fb38f1d003644c5f4acae264365f4ba5e5197b48c914495fc5ef67049be3992aa1a6647764c9bd1

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## [0.2.0] - 2025-21-07
+### Changed
+- `is_number?` now accepts all numeric formats (integers and decimals, positive and negative)
+    - Previously only accepted positive integers
+    - Use `is_integer` for strictly whole numbers
+- Added "Transform Your Code" section to README for better first impressions

data/README.md

@@ -1,10 +1,245 @@
-# NoRegex
+# NoRegex
 
 Write Ruby without regex! A gem that provides simple, readable methods to replace complex regular expressions for string validation and manipulation.
 
+## Transform Your Code
+
+**BEFORE** - From complex regex patterns:
+```ruby
+validates :email, format: { with: /\A[\w+\-.]+@[a-z\d\-]+(\.[a-z\d\-]+)*\.[a-z]+\z/i }
+validates :phone, format: { with: /\A\+?[\d\s\-\(\)]+\z/ }
+
+if params[:search].match?(/\A\d+\z/)
+# It's a number
+end
+
+user_input.gsub(/[`a-zA-Z0-9]/, '')
+```
+
+**AFTER** - To simple, readable methods!
+```ruby
+validates :email, format: { with: is_email? }
+validates :phone, format: { with: is_phone_number? }
+
+if params[:search].is_number?
+# It's a number
+end
+
+user_input.remove_special_chars
+```
+
+No more googling regex patterns or debugging cryptic expressions!
+
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'no_regex'
+gem 'no_regex'
+```
+
+And then execute:
+
+```bash
+$ bundle install
+```
+
+Or install it yourself as:
+
+```bash
+$ gem install no_regex
+```
+
+## Rails Integration
+
+To use the `format: { with: is_number? }` syntax in your Rails models or form objects, you need to extend your class with `NoRegex::PatternMethods`:
+
+```ruby
+class User < ApplicationRecord
+extend NoRegex::PatternMethods
+
+validates :email, format: { with: is_email? }
+validates :phone, format: { with: is_phone_number? }
+end
+```
+
+For form objects:
+```ruby
+class MyFormObject
+include ActiveModel::Model
+extend NoRegex::PatternMethods
+
+validates :search_term, format: { with: is_number? }
+end
+```
+
+This makes all the pattern methods available to your validations. Once extended, you can use any of the validation methods in the Format Validations section.
+
+
+## Usage
+
+NoRegex extends Ruby's String, Integer, Float, and other classes with intuitive methods that eliminate the need for regex:
+
+### String Methods
+
+```ruby
+require 'no_regex'
+
+# Validation methods - return true/false
+"12345".is_number?                    # => true
+"test@example.com".is_email?          # => true
+"https://example.com".is_url?         # => true
+"john_doe".is_username?               # => true
+
+# Manipulation methods - return modified strings
+"hello-world".remove_dashes           # => "helloworld"
+"abc123xyz".keep_numbers              # => "123"
+"HelloWorld".to_snake_case            # => "hello_world"
+
+# Extraction methods - return arrays
+"Contact: test@example.com".extract_emails  # => ["test@example.com"]
+"Price: $123".extract_numbers               # => ["123"]
+```
+
+### Numeric Methods
+
+```ruby
+42.is_positive?                       # => true
+123.to_currency                       # => "$123"
+3.14.to_percentage                    # => "314.0%"
+```
+
+### Validation Methods
+
+- `is_number?` - Check if string contains a number
+- `is_letters?` - Check if string contains only letters
+- `is_integer?` - Check if string is an integer
+- `is_decimal?` - Check if string is a decimal number
+- `is_alphanumeric?` - Check if string contains only letters and numbers
+- `is_email?` - Check if string is a valid email format
+- `is_blank?` - Check if string is nil or contains only whitespace
+- `is_url?` - Check if string is a valid URL format
+- `is_phone_number?` - Check if string is a valid phone number
+- `is_zip_code?` - Check if string is a valid ZIP code
+- `is_hex_color?` - Check if string is a valid hex color
+- `is_username?` - Check if string is a valid username (letters, numbers, _, -)
+- `is_positive_number?` - Check if string is a positive number
+- `is_uuid?` - Check if string is a valid UUID
+- `is_credit_card?` - Check if string is a valid credit card number
+- `is_ssn?` - Check if string is a valid SSN
+- `is_ipv4?` - Check if string is a valid IPv4 address
+- `is_time_24h?` - Check if string is valid 24-hour time format
+- `is_date_yyyy_mm_dd?` - Check if string is valid YYYY-MM-DD date format
+
+### Manipulation Methods
+
+- `remove_dashes` - Remove all dashes from string
+- `remove_spaces` - Remove all spaces from string
+- `remove_special_chars` - Remove all special characters, keeping only letters and numbers
+- `remove_numbers` - Remove all numbers from string
+- `remove_letters` - Remove all letters from string
+- `keep_numbers` - Keep only numbers in string
+- `keep_letters` - Keep only letters in string
+
+### Conversion Methods
+
+- `to_snake_case` - Convert string to snake_case
+- `to_camel_case` - Convert string to camelCase
+
+### Extraction Methods
+
+- `extract_numbers` - Extract all numbers from string (returns array)
+- `extract_emails` - Extract all email addresses from string (returns array)
+
+### Utility Methods
+
+- `word_count` - Count words in string
+- `truncate(length, ellipsis)` - Truncate string to specified length with ellipsis
+
+
+### Format Validators
+
+```ruby
+validates :field, format: { with: is_number? }          # Only digits
+validates :field, format: { with: is_letters? }         # Only letters
+validates :field, format: { with: is_integer? }         # Integers
+validates :field, format: { with: is_decimal? }         # Decimals
+validates :field, format: { with: is_alphanumeric? }    # Letters and numbers
+validates :field, format: { with: is_email? }           # Email format
+validates :field, format: { with: is_phone_number? }    # Phone format
+validates :field, format: { with: is_url? }             # URL format
+validates :field, format: { with: is_zip_code? }        # ZIP code
+validates :field, format: { with: is_hex_color? }       # Hex colors
+validates :field, format: { with: is_username? }        # Usernames
+validates :field, format: { with: is_positive_number? } # Positive numbers
+validates :field, format: { with: is_uuid? }            # UUIDs
+validates :field, format: { with: is_credit_card? }     # Credit cards
+validates :field, format: { with: is_ssn? }             # SSN format
+validates :field, format: { with: is_ipv4? }            # IP addresses
+validates :field, format: { with: is_time_24h? }        # 24-hour time
+validates :field, format: { with: is_date_yyyy_mm_dd? } # YYYY-MM-DD dates
+```
+
+### Custom Validators (Alternative Approach)
+
+```ruby
+class User < ApplicationRecord
+validates :phone, number: true
+validates :name, letters: { message: "can only contain letters" }
+validates :username, alphanumeric: true
+validates :email, email_format: true
+validates :website, url_format: { allow_blank: true }
+end
+```
+
+## Examples
+
+```ruby
+# Validation
+"12345".is_number?                    # => true
+"abc123".is_letters?                  # => false
+"test@example.com".is_email?          # => true
+"https://example.com".is_url?         # => true
+
+# Manipulation
+"hello-world-123".remove_dashes       # => "helloworld123"
+"hello world 123".remove_numbers      # => "hello world "
+"abc123xyz".keep_numbers              # => "123"
+"abc123xyz".keep_letters              # => "abcxyz"
+"Hello@World#123!".remove_special_chars # => "HelloWorld123"
+
+# Conversion
+"HelloWorld".to_snake_case            # => "hello_world"
+"hello_world".to_camel_case           # => "helloWorld"
+
+# Extraction
+"Contact: test@example.com or admin@site.org".extract_emails
+# => ["test@example.com", "admin@site.org"]
+
+"Price is $123 or $456".extract_numbers  # => ["123", "456"]
+
+# Utilities
+"Hello world, this is a test".word_count  # => 6
+"This is a very long string".truncate(15)  # => "This is a ve..."
+
+# Numeric Methods
+42.is_positive?                       # => true
+-10.is_negative?                      # => true
+100.to_currency                       # => "$100"
+1234.to_formatted                     # => "1,234"
+0.75.to_percentage                    # => "75.0%"
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/Derity/no_regex
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/no_regex/pattern_methods.rb

@@ -3,9 +3,10 @@
 module NoRegex
   module PatternMethods
     # Define methods that return regex patterns
+    #
     def is_number?
-      # Examples: "12345", "0", "999"
-      /\A\d+\z/
+      # Examples: "123", "-456", "12.34", "-0.5", "0", "999.99"
+      /\A-?\d+(\.\d+)?\z/
     end
 
     def is_letters?

data/lib/no_regex/string_extensions.rb

@@ -4,7 +4,7 @@
 class String
   # Check methods - return true/false
   def is_number?
-    match?(/\A\d+\z/)
+    match?(/\A-?\d+(\.\d+)?\z/)
   end
 
   def is_letters?

data/lib/no_regex/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module NoRegex
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end
 

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: no_regex
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
-- Your Name
+- David Wright
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
@@ -54,11 +54,12 @@ dependencies:
 description: Replace complex regex patterns with simple, readable methods for string
   validation and manipulation
 email:
-- your.email@example.com
+- derity@derity.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - README.md
 - lib/no_regex.rb
 - lib/no_regex/aliases.rb
@@ -67,13 +68,13 @@ files:
 - lib/no_regex/rails_validators.rb
 - lib/no_regex/string_extensions.rb
 - lib/no_regex/version.rb
-homepage: https://github.com/yourusername/no_regex
+homepage: https://github.com/Derity/no_regex
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/yourusername/no_regex
-  source_code_uri: https://github.com/yourusername/no_regex
-  changelog_uri: https://github.com/yourusername/no_regex/blob/main/CHANGELOG.md
+  homepage_uri: https://github.com/Derity/no_regex
+  source_code_uri: https://github.com/Derity/no_regex
+  changelog_uri: https://github.com/Derity/no_regex/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib