]> git.ipfire.org Git - thirdparty/git.git/blob - grep.h
Merge branch 'ab/grep-simplify-extended-expression'
[thirdparty/git.git] / grep.h
1 #ifndef GREP_H
2 #define GREP_H
3 #include "color.h"
4 #ifdef USE_LIBPCRE2
5 #define PCRE2_CODE_UNIT_WIDTH 8
6 #include <pcre2.h>
7 #if (PCRE2_MAJOR >= 10 && PCRE2_MINOR >= 36) || PCRE2_MAJOR >= 11
8 #define GIT_PCRE2_VERSION_10_36_OR_HIGHER
9 #endif
10 #if (PCRE2_MAJOR >= 10 && PCRE2_MINOR >= 34) || PCRE2_MAJOR >= 11
11 #define GIT_PCRE2_VERSION_10_34_OR_HIGHER
12 #endif
13 #else
14 typedef int pcre2_code;
15 typedef int pcre2_match_data;
16 typedef int pcre2_compile_context;
17 typedef int pcre2_general_context;
18 #endif
19 #ifndef PCRE2_MATCH_INVALID_UTF
20 /* PCRE2_MATCH_* dummy also with !USE_LIBPCRE2, for test-pcre2-config.c */
21 #define PCRE2_MATCH_INVALID_UTF 0
22 #endif
23 #include "thread-utils.h"
24 #include "userdiff.h"
25
26 struct repository;
27
28 enum grep_pat_token {
29 GREP_PATTERN,
30 GREP_PATTERN_HEAD,
31 GREP_PATTERN_BODY,
32 GREP_AND,
33 GREP_OPEN_PAREN,
34 GREP_CLOSE_PAREN,
35 GREP_NOT,
36 GREP_OR
37 };
38
39 enum grep_context {
40 GREP_CONTEXT_HEAD,
41 GREP_CONTEXT_BODY
42 };
43
44 enum grep_header_field {
45 GREP_HEADER_FIELD_MIN = 0,
46 GREP_HEADER_AUTHOR = GREP_HEADER_FIELD_MIN,
47 GREP_HEADER_COMMITTER,
48 GREP_HEADER_REFLOG,
49
50 /* Must be at the end of the enum */
51 GREP_HEADER_FIELD_MAX
52 };
53
54 enum grep_color {
55 GREP_COLOR_CONTEXT,
56 GREP_COLOR_FILENAME,
57 GREP_COLOR_FUNCTION,
58 GREP_COLOR_LINENO,
59 GREP_COLOR_COLUMNNO,
60 GREP_COLOR_MATCH_CONTEXT,
61 GREP_COLOR_MATCH_SELECTED,
62 GREP_COLOR_SELECTED,
63 GREP_COLOR_SEP,
64 NR_GREP_COLORS
65 };
66
67 struct grep_pat {
68 struct grep_pat *next;
69 const char *origin;
70 int no;
71 enum grep_pat_token token;
72 char *pattern;
73 size_t patternlen;
74 enum grep_header_field field;
75 regex_t regexp;
76 pcre2_code *pcre2_pattern;
77 pcre2_match_data *pcre2_match_data;
78 pcre2_compile_context *pcre2_compile_context;
79 pcre2_general_context *pcre2_general_context;
80 const uint8_t *pcre2_tables;
81 uint32_t pcre2_jit_on;
82 unsigned fixed:1;
83 unsigned is_fixed:1;
84 unsigned ignore_case:1;
85 unsigned word_regexp:1;
86 };
87
88 enum grep_expr_node {
89 GREP_NODE_ATOM,
90 GREP_NODE_NOT,
91 GREP_NODE_AND,
92 GREP_NODE_TRUE,
93 GREP_NODE_OR
94 };
95
96 enum grep_pattern_type {
97 GREP_PATTERN_TYPE_UNSPECIFIED = 0,
98 GREP_PATTERN_TYPE_BRE,
99 GREP_PATTERN_TYPE_ERE,
100 GREP_PATTERN_TYPE_FIXED,
101 GREP_PATTERN_TYPE_PCRE
102 };
103
104 struct grep_expr {
105 enum grep_expr_node node;
106 unsigned hit;
107 union {
108 struct grep_pat *atom;
109 struct grep_expr *unary;
110 struct {
111 struct grep_expr *left;
112 struct grep_expr *right;
113 } binary;
114 } u;
115 };
116
117 struct grep_opt {
118 struct grep_pat *pattern_list;
119 struct grep_pat **pattern_tail;
120 struct grep_pat *header_list;
121 struct grep_pat **header_tail;
122 struct grep_expr *pattern_expression;
123
124 /*
125 * NEEDSWORK: See if we can remove this field, because the repository
126 * should probably be per-source. That is, grep.c functions using this
127 * field should probably start using "repo" in "struct grep_source"
128 * instead.
129 *
130 * This is potentially the cause of at least one bug - "git grep"
131 * using the textconv attributes from the superproject on the
132 * submodules. See the failing "git grep --textconv" tests in
133 * t7814-grep-recurse-submodules.sh for more information.
134 */
135 struct repository *repo;
136
137 int linenum;
138 int columnnum;
139 int invert;
140 int ignore_case;
141 int status_only;
142 int name_only;
143 int unmatch_name_only;
144 int count;
145 int word_regexp;
146 int all_match;
147 int no_body_match;
148 int body_hit;
149 #define GREP_BINARY_DEFAULT 0
150 #define GREP_BINARY_NOMATCH 1
151 #define GREP_BINARY_TEXT 2
152 int binary;
153 int allow_textconv;
154 int use_reflog_filter;
155 int relative;
156 int pathname;
157 int null_following_name;
158 int only_matching;
159 int color;
160 int max_depth;
161 int funcname;
162 int funcbody;
163 int extended_regexp_option;
164 enum grep_pattern_type pattern_type_option;
165 int ignore_locale;
166 char colors[NR_GREP_COLORS][COLOR_MAXLEN];
167 unsigned pre_context;
168 unsigned post_context;
169 unsigned last_shown;
170 int show_hunk_mark;
171 int file_break;
172 int heading;
173 int max_count;
174 void *priv;
175
176 void (*output)(struct grep_opt *opt, const void *data, size_t size);
177 void *output_priv;
178 };
179
180 #define GREP_OPT_INIT { \
181 .relative = 1, \
182 .pathname = 1, \
183 .max_depth = -1, \
184 .max_count = -1, \
185 .pattern_type_option = GREP_PATTERN_TYPE_UNSPECIFIED, \
186 .colors = { \
187 [GREP_COLOR_CONTEXT] = "", \
188 [GREP_COLOR_FILENAME] = GIT_COLOR_MAGENTA, \
189 [GREP_COLOR_FUNCTION] = "", \
190 [GREP_COLOR_LINENO] = GIT_COLOR_GREEN, \
191 [GREP_COLOR_COLUMNNO] = GIT_COLOR_GREEN, \
192 [GREP_COLOR_MATCH_CONTEXT] = GIT_COLOR_BOLD_RED, \
193 [GREP_COLOR_MATCH_SELECTED] = GIT_COLOR_BOLD_RED, \
194 [GREP_COLOR_SELECTED] = "", \
195 [GREP_COLOR_SEP] = GIT_COLOR_CYAN, \
196 }, \
197 .only_matching = 0, \
198 .color = -1, \
199 .output = std_output, \
200 }
201
202 int grep_config(const char *var, const char *value, void *);
203 void grep_init(struct grep_opt *, struct repository *repo);
204
205 void append_grep_pat(struct grep_opt *opt, const char *pat, size_t patlen, const char *origin, int no, enum grep_pat_token t);
206 void append_grep_pattern(struct grep_opt *opt, const char *pat, const char *origin, int no, enum grep_pat_token t);
207 void append_header_grep_pattern(struct grep_opt *, enum grep_header_field, const char *);
208 void compile_grep_patterns(struct grep_opt *opt);
209 void free_grep_patterns(struct grep_opt *opt);
210 int grep_buffer(struct grep_opt *opt, const char *buf, unsigned long size);
211
212 /* The field parameter is only used to filter header patterns
213 * (where appropriate). If filtering isn't desirable
214 * GREP_HEADER_FIELD_MAX should be supplied.
215 */
216 int grep_next_match(struct grep_opt *opt,
217 const char *bol, const char *eol,
218 enum grep_context ctx, regmatch_t *pmatch,
219 enum grep_header_field field, int eflags);
220
221 struct grep_source {
222 char *name;
223
224 enum grep_source_type {
225 GREP_SOURCE_OID,
226 GREP_SOURCE_FILE,
227 GREP_SOURCE_BUF,
228 } type;
229 void *identifier;
230 struct repository *repo; /* if GREP_SOURCE_OID */
231
232 const char *buf;
233 unsigned long size;
234
235 char *path; /* for attribute lookups */
236 struct userdiff_driver *driver;
237 };
238
239 void grep_source_init_file(struct grep_source *gs, const char *name,
240 const char *path);
241 void grep_source_init_oid(struct grep_source *gs, const char *name,
242 const char *path, const struct object_id *oid,
243 struct repository *repo);
244 void grep_source_clear_data(struct grep_source *gs);
245 void grep_source_clear(struct grep_source *gs);
246 void grep_source_load_driver(struct grep_source *gs,
247 struct index_state *istate);
248
249
250 int grep_source(struct grep_opt *opt, struct grep_source *gs);
251
252 struct grep_opt *grep_opt_dup(const struct grep_opt *opt);
253
254 /*
255 * Mutex used around access to the attributes machinery if
256 * opt->use_threads. Must be initialized/destroyed by callers!
257 */
258 extern int grep_use_locks;
259 extern pthread_mutex_t grep_attr_mutex;
260
261 #endif