annotate vendor/github.com/dlclark/regexp2/ATTRIB @ 66:787b5ee0289d draft

Use vendored modules Signed-off-by: Izuru Yakumo <yakumo.izuru@chaotic.ninja>
author yakumo.izuru
date Sun, 23 Jul 2023 13:18:53 +0000
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
66
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
1 ============
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
2 These pieces of code were ported from dotnet/corefx:
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
3
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
4 syntax/charclass.go (from RegexCharClass.cs): ported to use the built-in Go unicode classes. Canonicalize is
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
5 a direct port, but most of the other code required large changes because the C# implementation
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
6 used a string to represent the CharSet data structure and I cleaned that up in my implementation.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
7
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
8 syntax/code.go (from RegexCode.cs): ported literally with various cleanups and layout to make it more Go-ish.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
9
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
10 syntax/escape.go (from RegexParser.cs): ported Escape method and added some optimizations. Unescape is inspired by
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
11 the C# implementation but couldn't be directly ported because of the lack of do-while syntax in Go.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
12
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
13 syntax/parser.go (from RegexpParser.cs and RegexOptions.cs): ported parser struct and associated methods as
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
14 literally as possible. Several language differences required changes. E.g. lack pre/post-fix increments as
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
15 expressions, lack of do-while loops, lack of overloads, etc.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
16
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
17 syntax/prefix.go (from RegexFCD.cs and RegexBoyerMoore.cs): ported as literally as possible and added support
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
18 for unicode chars that are longer than the 16-bit char in C# for the 32-bit rune in Go.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
19
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
20 syntax/replacerdata.go (from RegexReplacement.cs): conceptually ported and re-organized to handle differences
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
21 in charclass implementation, and fix odd code layout between RegexParser.cs, Regex.cs, and RegexReplacement.cs.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
22
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
23 syntax/tree.go (from RegexTree.cs and RegexNode.cs): ported literally as possible.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
24
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
25 syntax/writer.go (from RegexWriter.cs): ported literally with minor changes to make it more Go-ish.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
26
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
27 match.go (from RegexMatch.cs): ported, simplified, and changed to handle Go's lack of inheritence.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
28
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
29 regexp.go (from Regex.cs and RegexOptions.cs): conceptually serves the same "starting point", but is simplified
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
30 and changed to handle differences in C# strings and Go strings/runes.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
31
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
32 replace.go (from RegexReplacement.cs): ported closely and then cleaned up to combine the MatchEvaluator and
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
33 simple string replace implementations.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
34
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
35 runner.go (from RegexRunner.cs): ported literally as possible.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
36
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
37 regexp_test.go (from CaptureTests.cs and GroupNamesAndNumbers.cs): conceptually ported, but the code was
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
38 manually structured like Go tests.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
39
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
40 replace_test.go (from RegexReplaceStringTest0.cs): conceptually ported
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
41
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
42 rtl_test.go (from RightToLeft.cs): conceptually ported
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
43 ---
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
44 dotnet/corefx was released under this license:
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
45
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
46 The MIT License (MIT)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
47
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
48 Copyright (c) Microsoft Corporation
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
49
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
50 Permission is hereby granted, free of charge, to any person obtaining a copy
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
51 of this software and associated documentation files (the "Software"), to deal
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
52 in the Software without restriction, including without limitation the rights
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
53 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
54 copies of the Software, and to permit persons to whom the Software is
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
55 furnished to do so, subject to the following conditions:
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
56
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
57 The above copyright notice and this permission notice shall be included in all
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
58 copies or substantial portions of the Software.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
59
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
60 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
61 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
62 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
63 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
64 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
65 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
66 SOFTWARE.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
67
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
68 ============
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
69 These pieces of code are copied from the Go framework:
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
70
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
71 - The overall directory structure of regexp2 was inspired by the Go runtime regexp package.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
72 - The optimization in the escape method of syntax/escape.go is from the Go runtime QuoteMeta() func in regexp/regexp.go
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
73 - The method signatures in regexp.go are designed to match the Go framework regexp methods closely
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
74 - func regexp2.MustCompile and func quote are almost identifical to the regexp package versions
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
75 - BenchmarkMatch* and TestProgramTooLong* funcs in regexp_performance_test.go were copied from the framework
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
76 regexp/exec_test.go
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
77 ---
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
78 The Go framework was released under this license:
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
79
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
80 Copyright (c) 2012 The Go Authors. All rights reserved.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
81
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
82 Redistribution and use in source and binary forms, with or without
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
83 modification, are permitted provided that the following conditions are
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
84 met:
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
85
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
86 * Redistributions of source code must retain the above copyright
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
87 notice, this list of conditions and the following disclaimer.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
88 * Redistributions in binary form must reproduce the above
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
89 copyright notice, this list of conditions and the following disclaimer
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
90 in the documentation and/or other materials provided with the
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
91 distribution.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
92 * Neither the name of Google Inc. nor the names of its
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
93 contributors may be used to endorse or promote products derived from
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
94 this software without specific prior written permission.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
95
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
96 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
97 "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
98 LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
99 A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
100 OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
101 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
102 LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
103 DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
104 THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
105 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
106 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
107
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
108 ============
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
109 Some test data were gathered from the Mono project.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
110
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
111 regexp_mono_test.go: ported from https://github.com/mono/mono/blob/master/mcs/class/System/Test/System.Text.RegularExpressions/PerlTrials.cs
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
112 ---
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
113 Mono tests released under this license:
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
114
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
115 Permission is hereby granted, free of charge, to any person obtaining
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
116 a copy of this software and associated documentation files (the
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
117 "Software"), to deal in the Software without restriction, including
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
118 without limitation the rights to use, copy, modify, merge, publish,
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
119 distribute, sublicense, and/or sell copies of the Software, and to
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
120 permit persons to whom the Software is furnished to do so, subject to
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
121 the following conditions:
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
122
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
123 The above copyright notice and this permission notice shall be
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
124 included in all copies or substantial portions of the Software.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
125
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
126 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
127 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
128 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
129 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
130 LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
131 OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
132 WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
133