Skip to content
Make difficult regular expressions easy! Ruby port of the awesome VerbalExpressions repo - https://github.com/jehna/VerbalExpressions
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib Added concept of "letter" Jun 3, 2014
spec Correction Jun 3, 2014
.document Jeweler install for gem management Jul 23, 2013
.gitignore
.rspec
.travis.yml Create .travis.yml Jul 26, 2013
Gemfile
Gemfile.lock add simplecov, change test to be consistent Aug 6, 2013
LICENSE Initial commit Jul 22, 2013
README.md
Rakefile
VERSION Version bump to 0.1.5 Jun 3, 2014
verbal_expressions.gemspec

README.md

verbal_expressions

Build Status Gem Version

Ruby Regular Expressions made easy

VerbalExpressions is a Ruby library that helps to construct difficult regular expressions - ported from the awesome JavaScript VerbalExpressions.

How to get started

Just install with gem install verbal_expressions, then require the library and you're good to go!

require 'verbal_expressions'

Examples

Here's a couple of simple examples to give an idea of how VerbalExpressions works:

Testing if we have a valid URL

# Create an example of how to test for correctly formed URLs
tester = VerEx.new do
  start_of_line
  find 'http'
  maybe 's'
  find '://'
  maybe 'www.'
  anything_but ' '
  end_of_line
end

# Create an example URL
test_url = "https://www.google.com"

# Use it just like a regular Ruby regex:
puts 'Hooray!  It works!' if tester.match(test_url)
puts 'This works too!' if tester =~ test_url

# Print the generated regex:
puts tester.source # => /^(http)(s)?(\:\/\/)(www\.)?([^\ ]*)$/

Replacing strings

# Create a test string
replace_me = "Replace bird with a duck"

# Create an expression that seeks for word "bird"
expression = VerEx.new { find 'bird' }

# Execute the expression like a normal Regexp object
result = replace_me.gsub( expression, "duck" );

puts result # Outputs "Replace duck with a duck"

Regex Capturing

# Grab the number of goals

tester = VerEx.new do
  find 'scored '
  begin_capture 'goals' # Can be named or unnamed
  word
  end_capture
end

match = tester.match('Jerry scored 5 goals!')
puts match['goals'] # => 5

# Alternative capture syntax

tester = VerEx.new do
  find 'scored '
  capture('goals') { word }
end

API documentation

I haven't added much documentation to this repo yet, but you can find the documentation for the original JavaScript repo on their wiki. Most of the methods have been ported as of v0.1.0 of the JavaScript repo. Just be sure to use the syntax explained above rather than the dot notation :)

Contributions

Clone the repo and fork! Pull requests are warmly welcomed!

Issues

  • I haven't yet ported the modifier code because Ruby Regexp handles modifiers a little differently.
  • Because or is reserved in Ruby, or is currently aliased to alternatively. Unfortunately, then is also reserved, so you must use find instead. I'm very open to better name ideas :)

Thanks!

Thank you to @jehna for coming up with the awesome original idea!

Bitdeli Badge

You can’t perform that action at this time.