liyao001 / regex-generator

Generate regular expressions from sample texts.

Regex Generator

Regex Generator is a tool to generate simple regular expressions. The goal is that people with less experience can create regex smoothly.

Regex Generator tries to help you create a first version of a regular expression to recognize certain texts. It is designed to create regular expressions by putting together well-known snippets. This can be used as a starting point for regular expressions.

Hopefully nobody will need to use substring() anymore.

Usage

Online

Go to Regex Generator and try it online.

The page supports several search parameters to change the initial state of the options:

• sampleText changes the initial sample text of the regex generator
• flags changes the flags used to generate the language snippets. Any combination of the following characters are allowed:
  • i case insensitive
  • s dot matches line breaks
  • m multiline
  • P this controls the "Generate Only Patterns" check box
  • W this controls the "Match Whole Line" check box
  • L this controls the "Generate Lower Case" check box
• selection controls the matches that have been selected by the user

Example: https://regex-generator.olafneumann.org/?sampleText=Some%20text...&flags=imL&selection=5%7CMultiple%20characters

Docker

You can also start it via Docker. Please find the generated images in this repository. Just use the following command and use Regex Generator via port 80 of your local machine:

docker run -d -p 80:80 noxone/regexgenerator

Of course the docker version supports the same search parameters as the actual website.

Development

Build

1. Clone the project

2. In the project's root directory execute

   gradlew clean build

   Or use docker to build the project:

   docker build . -t noxone/regexgenerator

3. Find the output in directory ./build/distributions/

Live Development

For a nice development experience use

gradlew run --continuous

Using this command the page will reload automatically for every source file change.

Reports

Unit Tests

Well, we don't have enough unit tests. But there are a few. See the results.

Detekt

Detekt is a code style checker for Kotlin. It is integrated in the build process to keep the code clean.

You can find the Detekt report for this project here.

Project goal

As written in the introduction the aim of the project is to enable everybody to use regular expressions. The use of substring() is nearly always unnecessary and if code is written in a reasonable manner you barely need that method.

There are a lot of very nice tools to build, understand and even debug your regex. Regex Generator tries to add a little bit to these tools to give you at least a starting point how the regex you need might look like.

Hopefully this regex generator continues to grow to eventually support a really wide range of functions and regular expressions.

Languages

Regex Generator is currently able to generate code snippets in the following languages:

• C (using regex.h)
• C#
• Go
• grep (command line tool)
• Java
• JavaScript
• Kotlin
• PHP
• Python
• Ruby
• Swift
• Visual Basic .NET

If you miss a language, just open a new issue or if you like, program the corresponding generator and open a pull request.

Patterns

Currently, about 30 patterns of different complexity are integrated in Regex Generator. It is able to recognize simple repetitions and combinations of multiple patterns.

To know more about the patterns, it's probably best to have a look into the code.

The list of included patterns is certainly not exhaustive. Nevertheless, it should cover a good number of use cases for beginners to start their regex with. Suggestions for additional patterns are very welcome and will be gladly included in the list. This is easily done via the issues.

More ideas

More ideas for new features or how to improve the application are very welcome. Please add them to the Github issues.