You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
RegexAssistant is an open source Regular Expression (Regex) find and replace tool for Windows.
6
5
It has an easy to use UI that can build and test regex, and the results are seen real time as expression is typed into the GUI.
7
6
It has a cheat-sheet token window which list the main regex tokens and common patterns. Items in the token list can be inserted into the Expression (regex) field by double clicking the desired token.
8
7
9
8
## Downloads
10
9
Use the following link to download the latest release binaries: [Download](https://github.com/David-Maisonave/RegexAssistant/releases/latest)
The results are displayed in real time to quickly let the user see when an expression is working, and exactly when it stops working.
17
-
18
-
### Compatibility Option
14
+
#### Compatibility Option
19
15
The compatibility option allows the user to select the target regex implementation to display results for.
20
16
Currently available targets are Boost, Scintilla, POSIX, STD Regex, Perl, and SED.
21
-
22
-
### Regex Replace
17
+
#### Regex Replace
23
18
Regex replace is supported when compatibility is switch to boost or STD types. The token list has example regex replacement patterns at the bottom of the list.
24
19
These patters can help the user to quickly test there replace expression, and user can easily undo the results by clicking the Undo button.
25
-
26
-
### Cheat-sheet (Token List)
20
+
#### Cheat-sheet (Token List)
27
21
A list window displays the regex tokens
28
22
The first column displays the token itself. The second column gives a description.
29
23
The Third column gives example usage, and the last column displays matches for the examples.
30
24
31
25
When the user double clicks a token in the first column, the token gets inserted into the expression at the cursor position.
32
26
33
-
#### Cheat-sheet Common Patterns
27
+
#####Cheat-sheet Common Patterns
34
28
The token window list many common patterns that the user can use just by double clicking on the desired patterns.
35
29
Here's a list of just a few of the many patterns that are listed.
36
30
##### Phone pattern
@@ -45,50 +39,55 @@ Here's a list of just a few of the many patterns that are listed.
45
39
##### Error reporting pattern
46
40
##### GUID pattern
47
41
48
-
### Convert FileSystem and SQL Wildcards to Regex
49
-
#### Convert FileSystem
42
+
####Convert FileSystem and SQL Wildcards to Regex
43
+
#####Convert FileSystem
50
44
This option is for users who are more familiar with windows file system wildcards (*?).
51
45
It allows the user to convert an expression using the file system wildcards into a regex expression, using regex wildcards.
52
-
53
-
#### Convert SQL
46
+
##### Convert SQL
54
47
This option is for users who are more familiar with SQL wildcards (%_#*?).
55
48
It allows the user to convert an expression using the SQL wildcards into a regex expression, using regex wildcards.
56
49
57
-
# RegexAssistant Source Code
58
-
## Requirements
59
50
60
-
### Visual Studio 2017
61
51
52
+
## RegexAssistant Build Instructions
53
+
### Summary
54
+
RegexAssistant can be built using Visual Studio (2017 or 2019) with the solution file RegexAssistant.sln.
55
+
It requires 2 external libaries (Boost and Scintilla). These 2 libraries are **not** included in the repository.
56
+
57
+
#### Visual Studio Requirement
58
+
##### Visual Studio 2017
62
59
**Community*, *Professional* or *Enterprise* Edition
63
60
* VC++ 2017 v141 toolset
64
61
* Windows XP support for C++
65
62
* MFC and ATL support
66
63
* Windows 10 SDK
67
-
68
-
### Visual Studio 2019
69
-
64
+
##### Visual Studio 2019
70
65
**Community*, *Professional* or *Enterprise* Edition
71
66
* MSVC v142 Buildtools
72
67
* C++ MFC for v142 Buildtools
73
68
* Windows 10 SDK
74
69
75
-
## Folder Structure
76
-
77
-
Source base code for the RegexAssistant program is kept in the sub-folder RegexAssistant.
78
-
RegexAssistant requires two libraries (Boost and Scintilla). These to libraries are not yet included in the project.
79
-
80
-
# Roadmap
81
-
1. Add logic to allow window to shrink down further
82
-
3. Add logic to remember last window size and position (to include monitor)
83
-
4. Add split line to allow user to change size ratio of the token window against the sample window.
84
-
5. Add button that will replace the target text with clipboard content
85
-
6. Add button that will append the target text field with clipboard content
86
-
7. Add command line option that will replace target text with clipboard content when the program starts
87
-
8. Add command line option to populate the regex input field on program startup
88
-
9. Add command line option to perform a regex replace on a file or multiple files matching DOS wildcards
89
-
10. Add context menu item to replace (or append) sample with multiple sets of examples designed for each pattern listed in the token list
90
-
11. Add Build button which disables real time results
91
-
12. Add a build wizard option that will let user go step by step creating an expression.
92
-
13. Add logic to perform file find, rename, delete, & move based on the regex patterns
93
-
14. Add drag and drop logic for sample window.
70
+
#### External libaries (Boost and Scintilla)
71
+
1. Download [Boost version 1.77](https://www.boost.org/users/download/) or greater. Extract the boost folder and save it to the same location as the solution (**RegexAssistant.sln**) file. Rename the folder from **boost_1_77_0** to **boost**.
72
+
2. Download [Scintilla version 5.1.1](https://www.scintilla.org/scite511.zip) or greater. Extract only the **scintilla** folder, and put it at the same locations as the solution (**RegexAssistant.sln**) file.
73
+
74
+
The RegexAssistant folder should look like the following:
75
+
76
+
#### Build Solution
77
+
Open the solution using Visual Studio, and press the F7 key to build the solution.
78
+
79
+
80
+
## To-Do
81
+
* Add logic to allow window to shrink down further
82
+
* Add logic to remember last window size and position (to include monitor)
83
+
* Add split line to allow user to change size ratio of the token window against the sample window.
84
+
* Add button that will replace the target text with clipboard content
85
+
* Add button that will append the target text field with clipboard content
86
+
* Add command line option that will replace target text with clipboard content when the program starts
87
+
* Add command line option to populate the regex input field on program startup
88
+
* Add command line option to perform a regex replace on a file or multiple files matching DOS wildcards
89
+
* Add context menu item to replace (or append) sample with multiple sets of examples designed for each pattern listed in the token list
90
+
* Add Build button which disables real time results
91
+
* Add logic to perform file find, rename, delete, & move based on the regex patterns
0 commit comments