config_backend.h 2.55 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_config_file_h__
#define INCLUDE_config_file_h__

10 11
#include "common.h"

12
#include "git2/sys/config.h"
13 14
#include "git2/config.h"

15 16 17 18 19 20 21 22 23 24 25 26 27
/**
 * Create a configuration file backend for ondisk files
 *
 * These are the normal `.gitconfig` files that Core Git
 * processes. Note that you first have to add this file to a
 * configuration object before you can query it for configuration
 * variables.
 *
 * @param out the new backend
 * @param path where the config file is located
 */
extern int git_config_backend_from_file(git_config_backend **out, const char *path);

28
/**
29 30 31 32 33 34 35 36 37 38 39 40
 * Create a readonly configuration file backend from another backend
 *
 * This copies the complete contents of the source backend to the
 * new backend. The new backend will be completely read-only and
 * cannot be modified.
 *
 * @param out the new snapshotted backend
 * @param source the backend to copy
 */
extern int git_config_backend_snapshot(git_config_backend **out, git_config_backend *source);

/**
41 42 43 44
 * Create an in-memory configuration file backend
 *
 * @param out the new backend
 * @param cfg the configuration that is to be parsed
45
 * @param len the length of the string pointed to by `cfg`
46
 */
47
extern int git_config_backend_from_string(git_config_backend **out, const char *cfg, size_t len);
48

49
GIT_INLINE(int) git_config_backend_open(git_config_backend *cfg, unsigned int level, const git_repository *repo)
50
{
51
	return cfg->open(cfg, level, repo);
52 53
}

54
GIT_INLINE(void) git_config_backend_free(git_config_backend *cfg)
55
{
56 57
	if (cfg)
		cfg->free(cfg);
58 59
}

60
GIT_INLINE(int) git_config_backend_get_string(
61
	git_config_entry **out, git_config_backend *cfg, const char *name)
Russell Belfer committed
62 63 64 65
{
	return cfg->get(cfg, name, out);
}

66
GIT_INLINE(int) git_config_backend_set_string(
Ben Straub committed
67
	git_config_backend *cfg, const char *name, const char *value)
68 69 70 71
{
	return cfg->set(cfg, name, value);
}

72
GIT_INLINE(int) git_config_backend_delete(
Ben Straub committed
73
	git_config_backend *cfg, const char *name)
Russell Belfer committed
74 75 76 77
{
	return cfg->del(cfg, name);
}

78
GIT_INLINE(int) git_config_backend_foreach(
Ben Straub committed
79
	git_config_backend *cfg,
80
	int (*fn)(const git_config_entry *entry, void *data),
81 82
	void *data)
{
83
	return git_config_backend_foreach_match(cfg, NULL, fn, data);
84 85
}

86
GIT_INLINE(int) git_config_backend_lock(git_config_backend *cfg)
87 88 89 90
{
	return cfg->lock(cfg);
}

91
GIT_INLINE(int) git_config_backend_unlock(git_config_backend *cfg, int success)
92 93 94 95
{
	return cfg->unlock(cfg, success);
}

96
#endif