Blame src/attr_file.h

Packit Service 20376f
/*
Packit Service 20376f
 * Copyright (C) the libgit2 contributors. All rights reserved.
Packit Service 20376f
 *
Packit Service 20376f
 * This file is part of libgit2, distributed under the GNU GPL v2 with
Packit Service 20376f
 * a Linking Exception. For full terms see the included COPYING file.
Packit Service 20376f
 */
Packit Service 20376f
#ifndef INCLUDE_attr_file_h__
Packit Service 20376f
#define INCLUDE_attr_file_h__
Packit Service 20376f
Packit Service 20376f
#include "git2/oid.h"
Packit Service 20376f
#include "git2/attr.h"
Packit Service 20376f
#include "vector.h"
Packit Service 20376f
#include "pool.h"
Packit Service 20376f
#include "buffer.h"
Packit Service 20376f
#include "fileops.h"
Packit Service 20376f
Packit Service 20376f
#define GIT_ATTR_FILE			".gitattributes"
Packit Service 20376f
#define GIT_ATTR_FILE_INREPO	"attributes"
Packit Service 20376f
#define GIT_ATTR_FILE_SYSTEM	"gitattributes"
Packit Service 20376f
#define GIT_ATTR_FILE_XDG		"attributes"
Packit Service 20376f
Packit Service 20376f
#define GIT_ATTR_FNMATCH_NEGATIVE	(1U << 0)
Packit Service 20376f
#define GIT_ATTR_FNMATCH_DIRECTORY	(1U << 1)
Packit Service 20376f
#define GIT_ATTR_FNMATCH_FULLPATH	(1U << 2)
Packit Service 20376f
#define GIT_ATTR_FNMATCH_MACRO		(1U << 3)
Packit Service 20376f
#define GIT_ATTR_FNMATCH_IGNORE		(1U << 4)
Packit Service 20376f
#define GIT_ATTR_FNMATCH_HASWILD	(1U << 5)
Packit Service 20376f
#define GIT_ATTR_FNMATCH_ALLOWSPACE	(1U << 6)
Packit Service 20376f
#define GIT_ATTR_FNMATCH_ICASE		(1U << 7)
Packit Service 20376f
#define GIT_ATTR_FNMATCH_MATCH_ALL	(1U << 8)
Packit Service 20376f
#define GIT_ATTR_FNMATCH_ALLOWNEG   (1U << 9)
Packit Service 20376f
#define GIT_ATTR_FNMATCH_ALLOWMACRO (1U << 10)
Packit Service 20376f
#define GIT_ATTR_FNMATCH_LEADINGDIR (1U << 11)
Packit Service 20376f
#define GIT_ATTR_FNMATCH_NOLEADINGDIR (1U << 12)
Packit Service 20376f
Packit Service 20376f
#define GIT_ATTR_FNMATCH__INCOMING \
Packit Service 20376f
	(GIT_ATTR_FNMATCH_ALLOWSPACE | GIT_ATTR_FNMATCH_ALLOWNEG | \
Packit Service 20376f
	 GIT_ATTR_FNMATCH_ALLOWMACRO | GIT_ATTR_FNMATCH_NOLEADINGDIR)
Packit Service 20376f
Packit Service 20376f
typedef enum {
Packit Service 20376f
	GIT_ATTR_FILE__IN_MEMORY   = 0,
Packit Service 20376f
	GIT_ATTR_FILE__FROM_FILE   = 1,
Packit Service 20376f
	GIT_ATTR_FILE__FROM_INDEX  = 2,
Packit Service 20376f
Packit Service 20376f
	GIT_ATTR_FILE_NUM_SOURCES  = 3
Packit Service 20376f
} git_attr_file_source;
Packit Service 20376f
Packit Service 20376f
extern const char *git_attr__true;
Packit Service 20376f
extern const char *git_attr__false;
Packit Service 20376f
extern const char *git_attr__unset;
Packit Service 20376f
Packit Service 20376f
typedef struct {
Packit Service 20376f
	char *pattern;
Packit Service 20376f
	size_t length;
Packit Service 20376f
	char *containing_dir;
Packit Service 20376f
	size_t containing_dir_length;
Packit Service 20376f
	unsigned int flags;
Packit Service 20376f
} git_attr_fnmatch;
Packit Service 20376f
Packit Service 20376f
typedef struct {
Packit Service 20376f
	git_attr_fnmatch match;
Packit Service 20376f
	git_vector assigns;		/* vector of <git_attr_assignment*> */
Packit Service 20376f
} git_attr_rule;
Packit Service 20376f
Packit Service 20376f
typedef struct {
Packit Service 20376f
	git_refcount unused;
Packit Service 20376f
	const char *name;
Packit Service 20376f
	uint32_t name_hash;
Packit Service 20376f
} git_attr_name;
Packit Service 20376f
Packit Service 20376f
typedef struct {
Packit Service 20376f
	git_refcount rc;		/* for macros */
Packit Service 20376f
	char *name;
Packit Service 20376f
	uint32_t name_hash;
Packit Service 20376f
	const char *value;
Packit Service 20376f
} git_attr_assignment;
Packit Service 20376f
Packit Service 20376f
typedef struct git_attr_file_entry git_attr_file_entry;
Packit Service 20376f
Packit Service 20376f
typedef struct {
Packit Service 20376f
	git_refcount rc;
Packit Service 20376f
	git_mutex lock;
Packit Service 20376f
	git_attr_file_entry *entry;
Packit Service 20376f
	git_attr_file_source source;
Packit Service 20376f
	git_vector rules;			/* vector of <rule*> or <fnmatch*> */
Packit Service 20376f
	git_pool pool;
Packit Service 20376f
	unsigned int nonexistent:1;
Packit Service 20376f
	int session_key;
Packit Service 20376f
	union {
Packit Service 20376f
		git_oid oid;
Packit Service 20376f
		git_futils_filestamp stamp;
Packit Service 20376f
	} cache_data;
Packit Service 20376f
} git_attr_file;
Packit Service 20376f
Packit Service 20376f
struct git_attr_file_entry {
Packit Service 20376f
	git_attr_file *file[GIT_ATTR_FILE_NUM_SOURCES];
Packit Service 20376f
	const char *path; /* points into fullpath */
Packit Service 20376f
	char fullpath[GIT_FLEX_ARRAY];
Packit Service 20376f
};
Packit Service 20376f
Packit Service 20376f
typedef struct {
Packit Service 20376f
	git_buf  full;
Packit Service 20376f
	char    *path;
Packit Service 20376f
	char    *basename;
Packit Service 20376f
	int      is_dir;
Packit Service 20376f
} git_attr_path;
Packit Service 20376f
Packit Service 20376f
/* A git_attr_session can provide an "instance" of reading, to prevent cache
Packit Service 20376f
 * invalidation during a single operation instance (like checkout).
Packit Service 20376f
 */
Packit Service 20376f
Packit Service 20376f
typedef struct {
Packit Service 20376f
	int key;
Packit Service 20376f
	unsigned int init_setup:1,
Packit Service 20376f
		init_sysdir:1;
Packit Service 20376f
	git_buf sysdir;
Packit Service 20376f
	git_buf tmp;
Packit Service 20376f
} git_attr_session;
Packit Service 20376f
Packit Service 20376f
extern int git_attr_session__init(git_attr_session *attr_session, git_repository *repo);
Packit Service 20376f
extern void git_attr_session__free(git_attr_session *session);
Packit Service 20376f
Packit Service 20376f
extern int git_attr_get_many_with_session(
Packit Service 20376f
	const char **values_out,
Packit Service 20376f
	git_repository *repo,
Packit Service 20376f
	git_attr_session *attr_session,
Packit Service 20376f
	uint32_t flags,
Packit Service 20376f
	const char *path,
Packit Service 20376f
	size_t num_attr,
Packit Service 20376f
	const char **names);
Packit Service 20376f
Packit Service 20376f
typedef int (*git_attr_file_parser)(
Packit Service 20376f
	git_repository *repo,
Packit Service 20376f
	git_attr_file *file,
Packit Service 20376f
	const char *data);
Packit Service 20376f
Packit Service 20376f
/*
Packit Service 20376f
 * git_attr_file API
Packit Service 20376f
 */
Packit Service 20376f
Packit Service 20376f
int git_attr_file__new(
Packit Service 20376f
	git_attr_file **out,
Packit Service 20376f
	git_attr_file_entry *entry,
Packit Service 20376f
	git_attr_file_source source);
Packit Service 20376f
Packit Service 20376f
void git_attr_file__free(git_attr_file *file);
Packit Service 20376f
Packit Service 20376f
int git_attr_file__load(
Packit Service 20376f
	git_attr_file **out,
Packit Service 20376f
	git_repository *repo,
Packit Service 20376f
	git_attr_session *attr_session,
Packit Service 20376f
	git_attr_file_entry *ce,
Packit Service 20376f
	git_attr_file_source source,
Packit Service 20376f
	git_attr_file_parser parser);
Packit Service 20376f
Packit Service 20376f
int git_attr_file__load_standalone(
Packit Service 20376f
	git_attr_file **out, const char *path);
Packit Service 20376f
Packit Service 20376f
int git_attr_file__out_of_date(
Packit Service 20376f
	git_repository *repo, git_attr_session *session, git_attr_file *file);
Packit Service 20376f
Packit Service 20376f
int git_attr_file__parse_buffer(
Packit Service 20376f
	git_repository *repo, git_attr_file *attrs, const char *data);
Packit Service 20376f
Packit Service 20376f
int git_attr_file__clear_rules(
Packit Service 20376f
	git_attr_file *file, bool need_lock);
Packit Service 20376f
Packit Service 20376f
int git_attr_file__lookup_one(
Packit Service 20376f
	git_attr_file *file,
Packit Service 20376f
	git_attr_path *path,
Packit Service 20376f
	const char *attr,
Packit Service 20376f
	const char **value);
Packit Service 20376f
Packit Service 20376f
/* loop over rules in file from bottom to top */
Packit Service 20376f
#define git_attr_file__foreach_matching_rule(file, path, iter, rule)	\
Packit Service 20376f
	git_vector_rforeach(&(file)->rules, (iter), (rule)) \
Packit Service 20376f
		if (git_attr_rule__match((rule), (path)))
Packit Service 20376f
Packit Service 20376f
uint32_t git_attr_file__name_hash(const char *name);
Packit Service 20376f
Packit Service 20376f
Packit Service 20376f
/*
Packit Service 20376f
 * other utilities
Packit Service 20376f
 */
Packit Service 20376f
Packit Service 20376f
extern int git_attr_fnmatch__parse(
Packit Service 20376f
	git_attr_fnmatch *spec,
Packit Service 20376f
	git_pool *pool,
Packit Service 20376f
	const char *source,
Packit Service 20376f
	const char **base);
Packit Service 20376f
Packit Service 20376f
extern bool git_attr_fnmatch__match(
Packit Service 20376f
	git_attr_fnmatch *rule,
Packit Service 20376f
	git_attr_path *path);
Packit Service 20376f
Packit Service 20376f
extern void git_attr_rule__free(git_attr_rule *rule);
Packit Service 20376f
Packit Service 20376f
extern bool git_attr_rule__match(
Packit Service 20376f
	git_attr_rule *rule,
Packit Service 20376f
	git_attr_path *path);
Packit Service 20376f
Packit Service 20376f
extern git_attr_assignment *git_attr_rule__lookup_assignment(
Packit Service 20376f
	git_attr_rule *rule, const char *name);
Packit Service 20376f
Packit Service 20376f
typedef enum { GIT_DIR_FLAG_TRUE = 1, GIT_DIR_FLAG_FALSE = 0, GIT_DIR_FLAG_UNKNOWN = -1 } git_dir_flag;
Packit Service 20376f
Packit Service 20376f
extern int git_attr_path__init(
Packit Service 20376f
	git_attr_path *info, const char *path, const char *base, git_dir_flag is_dir);
Packit Service 20376f
Packit Service 20376f
extern void git_attr_path__free(git_attr_path *info);
Packit Service 20376f
Packit Service 20376f
extern int git_attr_assignment__parse(
Packit Service 20376f
	git_repository *repo, /* needed to expand macros */
Packit Service 20376f
	git_pool *pool,
Packit Service 20376f
	git_vector *assigns,
Packit Service 20376f
	const char **scan);
Packit Service 20376f
Packit Service 20376f
#endif