attr_file.h 4.47 KB
Newer Older
1
/*
Edward Thomson committed
2
 * Copyright (C) the libgit2 contributors. All rights reserved.
3 4 5 6 7 8 9
 *
 * This file is part of libgit2, distributed under the GNU GPL v2 with
 * a Linking Exception. For full terms see the included COPYING file.
 */
#ifndef INCLUDE_attr_file_h__
#define INCLUDE_attr_file_h__

10
#include "git2/oid.h"
11 12
#include "git2/attr.h"
#include "vector.h"
13
#include "pool.h"
14
#include "buffer.h"
15
#include "fileops.h"
16

Russell Belfer committed
17 18 19
#define GIT_ATTR_FILE			".gitattributes"
#define GIT_ATTR_FILE_INREPO	"info/attributes"
#define GIT_ATTR_FILE_SYSTEM	"gitattributes"
20
#define GIT_ATTR_FILE_XDG		"attributes"
Russell Belfer committed
21

22 23 24 25
#define GIT_ATTR_FNMATCH_NEGATIVE	(1U << 0)
#define GIT_ATTR_FNMATCH_DIRECTORY	(1U << 1)
#define GIT_ATTR_FNMATCH_FULLPATH	(1U << 2)
#define GIT_ATTR_FNMATCH_MACRO		(1U << 3)
26
#define GIT_ATTR_FNMATCH_IGNORE		(1U << 4)
27
#define GIT_ATTR_FNMATCH_HASWILD	(1U << 5)
28
#define GIT_ATTR_FNMATCH_ALLOWSPACE	(1U << 6)
29
#define GIT_ATTR_FNMATCH_ICASE		(1U << 7)
30
#define GIT_ATTR_FNMATCH_MATCH_ALL	(1U << 8)
31 32
#define GIT_ATTR_FNMATCH_ALLOWNEG   (1U << 9)
#define GIT_ATTR_FNMATCH_ALLOWMACRO (1U << 10)
33
#define GIT_ATTR_FNMATCH_LEADINGDIR (1U << 11)
Russell Belfer committed
34
#define GIT_ATTR_FNMATCH_NOLEADINGDIR (1U << 12)
35 36

#define GIT_ATTR_FNMATCH__INCOMING \
Russell Belfer committed
37 38
	(GIT_ATTR_FNMATCH_ALLOWSPACE | GIT_ATTR_FNMATCH_ALLOWNEG | \
	 GIT_ATTR_FNMATCH_ALLOWMACRO | GIT_ATTR_FNMATCH_NOLEADINGDIR)
39

40 41 42 43 44 45 46 47
typedef enum {
	GIT_ATTR_FILE__IN_MEMORY  = 0,
	GIT_ATTR_FILE__FROM_FILE  = 1,
	GIT_ATTR_FILE__FROM_INDEX = 2,

	GIT_ATTR_FILE_NUM_SOURCES = 3
} git_attr_file_source;

48 49 50 51
extern const char *git_attr__true;
extern const char *git_attr__false;
extern const char *git_attr__unset;

52 53 54
typedef struct {
	char *pattern;
	size_t length;
55
	unsigned int flags;
56 57
} git_attr_fnmatch;

58
typedef struct {
59 60
	git_attr_fnmatch match;
	git_vector assigns;		/* vector of <git_attr_assignment*> */
61
} git_attr_rule;
62 63

typedef struct {
64
	git_refcount unused;
65
	const char *name;
Linquize committed
66
	uint32_t name_hash;
67 68 69
} git_attr_name;

typedef struct {
70
	git_refcount rc;		/* for macros */
71
	char *name;
Linquize committed
72 73
	uint32_t name_hash;
	const char *value;
74 75
} git_attr_assignment;

76 77 78
typedef struct git_attr_file_entry git_attr_file_entry;

typedef struct {
79
	git_refcount rc;
80
	git_mutex lock;
81 82
	git_attr_file_entry *entry;
	git_attr_file_source source;
83 84
	git_vector rules;			/* vector of <rule*> or <fnmatch*> */
	git_pool pool;
85 86
	union {
		git_oid oid;
Vicent Marti committed
87
		git_futils_filestamp stamp;
88
	} cache_data;
89 90 91 92 93 94
} git_attr_file;

struct git_attr_file_entry {
	git_attr_file *file[GIT_ATTR_FILE_NUM_SOURCES];
	const char *path; /* points into fullpath */
	char fullpath[GIT_FLEX_ARRAY];
95
};
96

97 98 99 100 101
typedef int (*git_attr_file_parser)(
	git_repository *repo,
	git_attr_file *file,
	const char *data);

102
typedef struct {
103 104 105 106
	git_buf  full;
	char    *path;
	char    *basename;
	int      is_dir;
107 108 109 110 111 112
} git_attr_path;

/*
 * git_attr_file API
 */

113 114
int git_attr_file__new(
	git_attr_file **out,
115 116
	git_attr_file_entry *entry,
	git_attr_file_source source);
117 118 119 120 121 122

void git_attr_file__free(git_attr_file *file);

int git_attr_file__load(
	git_attr_file **out,
	git_repository *repo,
123 124 125
	git_attr_file_entry *ce,
	git_attr_file_source source,
	git_attr_file_parser parser);
126

127
int git_attr_file__load_standalone(
128
	git_attr_file **out, const char *path);
129

130 131
int git_attr_file__out_of_date(
	git_repository *repo, git_attr_file *file);
132

133
int git_attr_file__parse_buffer(
134
	git_repository *repo, git_attr_file *attrs, const char *data);
135

136 137
int git_attr_file__clear_rules(
	git_attr_file *file, bool need_lock);
138

139
int git_attr_file__lookup_one(
140
	git_attr_file *file,
141
	git_attr_path *path,
142 143 144 145 146 147
	const char *attr,
	const char **value);

/* loop over rules in file from bottom to top */
#define git_attr_file__foreach_matching_rule(file, path, iter, rule)	\
	git_vector_rforeach(&(file)->rules, (iter), (rule)) \
148
		if (git_attr_rule__match((rule), (path)))
149

150
uint32_t git_attr_file__name_hash(const char *name);
151 152 153 154 155 156


/*
 * other utilities
 */

157
extern int git_attr_fnmatch__parse(
158
	git_attr_fnmatch *spec,
159
	git_pool *pool,
160
	const char *source,
161 162
	const char **base);

163
extern bool git_attr_fnmatch__match(
164
	git_attr_fnmatch *rule,
165
	git_attr_path *path);
166

167 168
extern void git_attr_rule__free(git_attr_rule *rule);

169
extern bool git_attr_rule__match(
170
	git_attr_rule *rule,
171
	git_attr_path *path);
172 173 174 175 176

extern git_attr_assignment *git_attr_rule__lookup_assignment(
	git_attr_rule *rule, const char *name);

extern int git_attr_path__init(
177
	git_attr_path *info, const char *path, const char *base);
178

179 180
extern void git_attr_path__free(git_attr_path *info);

181 182
extern int git_attr_assignment__parse(
	git_repository *repo, /* needed to expand macros */
183
	git_pool *pool,
184 185 186
	git_vector *assigns,
	const char **scan);

187
#endif