Download the PHP package hoa/regex without Composer
On this page you can find all versions of the php package hoa/regex. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package regex
Short Description The Hoa\Regex library.
License BSD-3-Clause
Homepage https://hoa-project.net/
Informations about the package regex
Hoa is a modular, extensible and
structured set of PHP libraries.
Moreover, Hoa aims at being a bridge between industrial and research worlds.
Hoa\Regex
This library provides tools to analyze regular expressions and generate strings based on regular expressions (Perl Compatible Regular Expressions).
Installation
With Composer, to include this library into
your dependencies, you need to
require hoa/regex
:
For more installation procedures, please read the Source page.
Testing
Before running the test suites, the development dependencies must be installed:
Then, to run all the test suites:
For more information, please read the contributor guide.
Quick usage
As a quick overview, we propose to see two examples. First, analyze a regular expression, i.e. lex, parse and produce an AST. Second, generate strings based on a regular expression by visiting its AST with an isotropic random approach.
Analyze regular expressions
We need the Hoa\Compiler
library to lex, parse
and produce an AST of the following regular expression: ab(c|d){2,4}e?
. Thus:
We read that the whole expression is composed of a single concatenation of two
tokens: a
and b
, followed by a quantification, followed by another
quantification. The first quantification is an alternation of (a choice betwen)
two tokens: c
and d
, between 2 to 4 times. The second quantification is the
e
token that can appear zero or one time.
We can visit the tree with the help of the Hoa\Visitor
library.
Generate strings based on regular expressions
To generate strings based on the AST of a regular expressions, we will use the
Hoa\Regex\Visitor\Isotropic
visitor:
Strings are generated at random and match the given regular expression.
Documentation
The
hack book of Hoa\Regex
contains detailed information about how to use this library and how it works.
To generate the documentation locally, execute the following commands:
More documentation can be found on the project's website: hoa-project.net.
Getting help
There are mainly two ways to get help:
- On the
#hoaproject
IRC channel, - On the forum at users.hoa-project.net.
Contribution
Do you want to contribute? Thanks! A detailed contributor guide explains everything you need to know.
License
Hoa is under the New BSD License (BSD-3-Clause). Please, see
LICENSE
for details.
All versions of regex with dependencies
hoa/exception Version ~1.0
hoa/math Version ~1.0
hoa/protocol Version ~1.0
hoa/ustring Version ~4.0
hoa/visitor Version ~2.0