refspec.h 1.91 KB
Newer Older
Vicent Marti committed
1
/*
Edward Thomson committed
2
 * Copyright (C) the libgit2 contributors. All rights reserved.
Vicent Marti committed
3 4 5 6
 *
 * This file is part of libgit2, distributed under the GNU GPL v2 with
 * a Linking Exception. For full terms see the included COPYING file.
 */
Carlos Martín Nieto committed
7 8 9 10
#ifndef INCLUDE_refspec_h__
#define INCLUDE_refspec_h__

#include "git2/refspec.h"
11
#include "buffer.h"
12
#include "vector.h"
Carlos Martín Nieto committed
13 14

struct git_refspec {
15
	char *string;
Carlos Martín Nieto committed
16 17
	char *src;
	char *dst;
18
	unsigned int force :1,
19
		push : 1,
20 21
		pattern :1,
		matching :1;
Carlos Martín Nieto committed
22 23
};

24 25
#define GIT_REFSPEC_TAGS "refs/tags/*:refs/tags/*"

Carlos Martín Nieto committed
26
int git_refspec_parse(struct git_refspec *refspec, const char *str);
27 28 29 30
int git_refspec__parse(
	struct git_refspec *refspec,
	const char *str,
	bool is_fetch);
Carlos Martín Nieto committed
31

32 33
void git_refspec__free(git_refspec *refspec);

34 35 36 37 38 39 40
/**
 * Transform a reference to its target following the refspec's rules,
 * and writes the results into a git_buf.
 *
 * @param out where to store the target name
 * @param spec the refspec
 * @param name the name of the reference to transform
41
 * @return 0 or error if buffer allocation fails
42 43 44
 */
int git_refspec_transform_r(git_buf *out, const git_refspec *spec, const char *name);

45 46 47 48 49 50 51 52 53 54 55
/**
 * Transform a reference from its target following the refspec's rules,
 * and writes the results into a git_buf.
 *
 * @param out where to store the source name
 * @param spec the refspec
 * @param name the name of the reference to transform
 * @return 0 or error if buffer allocation fails
 */
int git_refspec_transform_l(git_buf *out, const git_refspec *spec, const char *name);

56 57
int git_refspec__serialize(git_buf *out, const git_refspec *refspec);

58 59 60 61 62 63 64 65
/**
 * Determines if a refspec is a wildcard refspec.
 *
 * @param spec the refspec
 * @return 1 if the refspec is a wildcard, 0 otherwise
 */
int git_refspec_is_wildcard(const git_refspec *spec);

66 67 68 69 70 71
/**
 * DWIM `spec` with `refs` existing on the remote, append the dwim'ed
 * result in `out`.
 */
int git_refspec__dwim_one(git_vector *out, git_refspec *spec, git_vector *refs);

Carlos Martín Nieto committed
72
#endif