# regex
Regex is a regular expression toolkit for regex-base with:
* text-replacement operations with named captures;
* special datatypes for matches and captures;
* compile-time checking of RE syntax;
* a unified means of controlling case-sensitivity and multi-line options;
* high-level AWK-like tools for building text processing apps;
* the option of using match operators with reduced polymorphism on the
text and/or result types;
* regular expression macros including:
+ a number of useful RE macros;
+ a test bench for testing and documenting new macro environments;
* built-in support for the TDFA and PCRE backends;
* comprehensive documentation and copious examples.
See the [About page](http://about.regex.uk) for details.
## Road Map
☒ 2017-01-26 v0.0.0.1 Pre-release (I)
☒ 2017-01-30 v0.0.0.2 Pre-release (II)
☒ 2017-02-19 v0.1.0.0 [Proposed core API with presentable Haddocks](https://github.com/iconnect/regex/milestone/1)
☐ 2017-02-26 v0.1.1.0 [Tutorials and examples finalized](https://github.com/iconnect/regex/milestone/2)
☐ 2017-03-20 v1.0.0.0 [First stable release](https://github.com/iconnect/regex/milestone/3)
☐ 2017-08-31 v2.0.0.0 [Fast text replacement with benchmarks](https://github.com/iconnect/regex/milestone/4)
See the [Roadmap page](http://roadmap.regex.uk) for details.
## Build Status
[![Hackage](http://regex.uk/badges/hackage.svg)](https://hackage.haskell.org/package/regex) [![BSD3 License](http://regex.uk/badges/license.svg)](https://tldrlegal.com/license/bsd-3-clause-license-%28revised%29) [![Un*x build](http://regex.uk/badges/unix-build.svg)](https://travis-ci.org/iconnect/regex) [![Windows build](http://regex.uk/badges/windows-build.svg)](https://ci.appveyor.com/project/engineerirngirisconnectcouk/regex/branch/master) [![Coverage](http://regex.uk/badges/coverage.svg)](https://coveralls.io/github/iconnect/regex?branch=master)
See [build status page](http://regex.uk/build-status) for details.
## Installing the Package
The package can be easily installed with cabal or stack on GHC-8.0,
7.10 or 7.8 for the above platforms. See the
[Installation page](http://installation.regex.uk) for details.
## The Tutorial Tests and Examples
See the [Tutorial page](http://tutorial.regex.uk) and
[Examples page](http://examples.regex.uk) for details.
## Helping Out
If you have any feedback or suggestion then please drop us a line.
`t` [@hregex](https://twitter.com/hregex)
`e` maintainers@regex.uk
`w` http://issues.regex.uk
The [Contact page](http://contact.regex.uk) has more details.
## The API
The Haddocks can be found at http://hs.regex.uk.
## The Macro Tables
The macro environments are an important part of the package and
are documented [here](http://macros.regex.uk).
## The regex.uk Directory
A handy overview of the regex.uk domain can be found
[here](http://directory.regex.uk).
## The Changelog
The `changelog` is posted [here](http://changelog.regex.uk).
## The Authors
This library was written and is currently maintained by
[Chris Dornan](mailto:chris.dornan@irisconnect.com) aka
[@cdornan](https://twitter.com/cdornan)