README.md in regexp-examples-0.2.0 vs README.md in regexp-examples-0.2.1
- old
+ new
@@ -1,7 +1,9 @@
# regexp-examples
[](http://badge.fury.io/rb/regexp-examples)
+[](https://travis-ci.org/tom-lord/regexp-examples/builds)
+
Extends the Regexp class with the method: Regexp#examples
This method generates a list of (some\*) strings that will match the given regular expression
@@ -29,22 +31,26 @@
* Boolean "Or" groups, e.g. `/a|b|c/`
* Character sets (inluding ranges and negation!), e.g. `/[abc]/`, `/[A-Z0-9]/`, `/[^a-z]/`
* Escaped characters, e.g. `/\n/`, `/\w/`, `/\D/` (and so on...)
* Non-capture groups, e.g. `/(?:foo)/`
* Capture groups, e.g. `/(group)/`
- * Including named groups, e.g. `/?(<name>group)/`
+ * Including named groups, e.g. `/(?<name>group)/`
* ...And backreferences(!!!), e.g. `/(this|that) \1/` `/(?<name>foo) \k<name>/`
* Groups work fine, even if nested! e.g. `/(even(this(works?))) \1 \2 \3/`
* **Arbitrarily complex combinations of all the above!**
## Not-Yet-Supported syntax
-I plan to add the following features to the gem (in order of most -> least likely), but have not yet got round to it:
+I plan to add the following features to the gem, but have not yet got round to it:
* Throw exceptions if illegal syntax (see below) is used
* POSIX bracket expressions, e.g. `/[[:alnum:]]/`, `/[[:space:]]/`
* Options, e.g. `/pattern/i`, `/foo.*bar/m`
-* Unicode characters, e.g. `/\p{L}/`, `/\p{Arabic}/`
+* Escape sequences, e.g. `/\xa1/`
+* Unicode characters, e.g. `/\u06E9/`
+* Named properties, e.g. `/\p{L}/` ("Letter"), `/\p{Arabic}/` ("Arabic character"), `/\p{^Ll}/` ("Not a lowercase letter")
+* Control characters, e.g. `/\cA/` ... `/\cZ/`
+* Subexpression calls, e.g. `/(?<name> ... \g<name>* )/` (Note: These could get _really_ ugly to implement, and may even be impossible, so I highly doubt it's worth the effort!)
## Impossible features ("illegal syntax")
The following features in the regex language can never be properly implemented into this gem because, put simply, they are not technically "regular"!
If you'd like to understand this in more detail, there are many good blog posts out on the internet. The [wikipedia entry](http://en.wikipedia.org/wiki/Regular_expression)'s not bad either.