Documentation: clarify use of .git{ignore,attributes} versus .git/info/*
[git/jnareb-git/bp-gitweb.git] / ws.c
blobd09b9df89a7e19367640d4c6ad64ff828d01d26f
1 /*
2 * Whitespace rules
4 * Copyright (c) 2007 Junio C Hamano
5 */
7 #include "cache.h"
8 #include "attr.h"
10 static struct whitespace_rule {
11 const char *rule_name;
12 unsigned rule_bits;
13 } whitespace_rule_names[] = {
14 { "trailing-space", WS_TRAILING_SPACE },
15 { "space-before-tab", WS_SPACE_BEFORE_TAB },
16 { "indent-with-non-tab", WS_INDENT_WITH_NON_TAB },
19 unsigned parse_whitespace_rule(const char *string)
21 unsigned rule = WS_DEFAULT_RULE;
23 while (string) {
24 int i;
25 size_t len;
26 const char *ep;
27 int negated = 0;
29 string = string + strspn(string, ", \t\n\r");
30 ep = strchr(string, ',');
31 if (!ep)
32 len = strlen(string);
33 else
34 len = ep - string;
36 if (*string == '-') {
37 negated = 1;
38 string++;
39 len--;
41 if (!len)
42 break;
43 for (i = 0; i < ARRAY_SIZE(whitespace_rule_names); i++) {
44 if (strncmp(whitespace_rule_names[i].rule_name,
45 string, len))
46 continue;
47 if (negated)
48 rule &= ~whitespace_rule_names[i].rule_bits;
49 else
50 rule |= whitespace_rule_names[i].rule_bits;
51 break;
53 string = ep;
55 return rule;
58 static void setup_whitespace_attr_check(struct git_attr_check *check)
60 static struct git_attr *attr_whitespace;
62 if (!attr_whitespace)
63 attr_whitespace = git_attr("whitespace", 10);
64 check[0].attr = attr_whitespace;
67 unsigned whitespace_rule(const char *pathname)
69 struct git_attr_check attr_whitespace_rule;
71 setup_whitespace_attr_check(&attr_whitespace_rule);
72 if (!git_checkattr(pathname, 1, &attr_whitespace_rule)) {
73 const char *value;
75 value = attr_whitespace_rule.value;
76 if (ATTR_TRUE(value)) {
77 /* true (whitespace) */
78 unsigned all_rule = 0;
79 int i;
80 for (i = 0; i < ARRAY_SIZE(whitespace_rule_names); i++)
81 all_rule |= whitespace_rule_names[i].rule_bits;
82 return all_rule;
83 } else if (ATTR_FALSE(value)) {
84 /* false (-whitespace) */
85 return 0;
86 } else if (ATTR_UNSET(value)) {
87 /* reset to default (!whitespace) */
88 return whitespace_rule_cfg;
89 } else {
90 /* string */
91 return parse_whitespace_rule(value);
93 } else {
94 return whitespace_rule_cfg;
98 /* The returned string should be freed by the caller. */
99 char *whitespace_error_string(unsigned ws)
101 struct strbuf err;
102 strbuf_init(&err, 0);
103 if (ws & WS_TRAILING_SPACE)
104 strbuf_addstr(&err, "trailing whitespace");
105 if (ws & WS_SPACE_BEFORE_TAB) {
106 if (err.len)
107 strbuf_addstr(&err, ", ");
108 strbuf_addstr(&err, "space before tab in indent");
110 if (ws & WS_INDENT_WITH_NON_TAB) {
111 if (err.len)
112 strbuf_addstr(&err, ", ");
113 strbuf_addstr(&err, "indent with spaces");
115 return strbuf_detach(&err, NULL);
118 /* If stream is non-NULL, emits the line after checking. */
119 unsigned check_and_emit_line(const char *line, int len, unsigned ws_rule,
120 FILE *stream, const char *set,
121 const char *reset, const char *ws)
123 unsigned result = 0;
124 int written = 0;
125 int trailing_whitespace = -1;
126 int trailing_newline = 0;
127 int i;
129 /* Logic is simpler if we temporarily ignore the trailing newline. */
130 if (len > 0 && line[len - 1] == '\n') {
131 trailing_newline = 1;
132 len--;
135 /* Check for trailing whitespace. */
136 if (ws_rule & WS_TRAILING_SPACE) {
137 for (i = len - 1; i >= 0; i--) {
138 if (isspace(line[i])) {
139 trailing_whitespace = i;
140 result |= WS_TRAILING_SPACE;
142 else
143 break;
147 /* Check for space before tab in initial indent. */
148 for (i = 0; i < len; i++) {
149 if (line[i] == ' ')
150 continue;
151 if (line[i] != '\t')
152 break;
153 if ((ws_rule & WS_SPACE_BEFORE_TAB) && written < i) {
154 result |= WS_SPACE_BEFORE_TAB;
155 if (stream) {
156 fputs(ws, stream);
157 fwrite(line + written, i - written, 1, stream);
158 fputs(reset, stream);
160 } else if (stream)
161 fwrite(line + written, i - written, 1, stream);
162 if (stream)
163 fwrite(line + i, 1, 1, stream);
164 written = i + 1;
167 /* Check for indent using non-tab. */
168 if ((ws_rule & WS_INDENT_WITH_NON_TAB) && i - written >= 8) {
169 result |= WS_INDENT_WITH_NON_TAB;
170 if (stream) {
171 fputs(ws, stream);
172 fwrite(line + written, i - written, 1, stream);
173 fputs(reset, stream);
175 written = i;
178 if (stream) {
179 /* Now the rest of the line starts at written.
180 * The non-highlighted part ends at trailing_whitespace. */
181 if (trailing_whitespace == -1)
182 trailing_whitespace = len;
184 /* Emit non-highlighted (middle) segment. */
185 if (trailing_whitespace - written > 0) {
186 fputs(set, stream);
187 fwrite(line + written,
188 trailing_whitespace - written, 1, stream);
189 fputs(reset, stream);
192 /* Highlight errors in trailing whitespace. */
193 if (trailing_whitespace != len) {
194 fputs(ws, stream);
195 fwrite(line + trailing_whitespace,
196 len - trailing_whitespace, 1, stream);
197 fputs(reset, stream);
199 if (trailing_newline)
200 fputc('\n', stream);
202 return result;