sizuhiko/hexpress

hexpress is a PHP library that human way to define regular expressions

, _(*1)

hexpress

hexpress is a PHP library that human way to define regular expressions, _(*2)

hexpress is ported from Ruby's hexpress., _(*3)

The hexpress is another take at the concept of "Verbal Hexpressions"., _(*4)

hexpress requires PHP >= 5.5, _(*5)

Using

``` php use Hexpress\Hexpress;, <sub>(*6)</sub>

$pattern = (new Hexpress()) ->start("http") ->maybe("s") ->with("://") ->maybe(function($hex) { $hex->words()->with("."); }) ->find(function($hex) { $hex->matching(function($hex) {$hex->word()->with("-");})->many(); }) ->has(".") ->either(["com", "org"]) ->maybe("/") ->ending();, <sub>(*7)</sub>

After `use Hexpress\Hexpress` you'll have access to the Hexpress class, which allows you to chain methods to build up a regex pattern.

You can see this pattern by calling either `Hexpress#__toString()` or `Hexpress#toRegExp`:

``` php
echo $pattern;             #=> "^https?\:\/\/(?:(?:\w)+\.)?([\w\-]+)\.(?:com|org)\/?$"
echo $pattern->toRegExp(); #=> "/^https?\:\/\/(?:(?:\w)+\.)?([\w\-]+)\.(?:com|org)\/?$/"

You can even do advanced composure of multiple patterns:, <sub>(*8)</sub>

``` php $protocol = (new Hexpress())->start("http")->maybe("s")->with("://"); $tld = (new Hexpress())->with(".")->either(["org", "com", "net"]); $link = (new Hexpress())->has($protocol)->find(function($hex) {$hex->words();})->including($tld);, <sub>(*9)</sub>

echo $link; #=> "^https?:\/\/((?:\w)+).(?:org|com|net)", <sub>(*10)</sub>

Hexpressions are very flexible.

## TODO

- PHP Document and API reference
- lookahead assertions
- lookbehind assertions
- back reference
- conditional subpattern
- once-only subpattern
- Internal option setting

## Installing

Add this line to your application's composer.json:

``` json
    "require": {
        "sizuhiko/hexpress": ">=1.0"
    },

And then execute:, <sub>(*11)</sub>

$ composer install

Or install it yourself as:, <sub>(*12)</sub>

$ composer require "sizuhiko/hexpress:>=1.0"

Contributing to this Library

Please feel free to contribute to the library with new issues, requests, unit tests and code fixes or new features. If you want to contribute some code, create a feature branch from develop, and send us your pull request., <sub>(*13)</sub>