 aedcb7dc75
			
		
	
	aedcb7dc75
	
	
	
		
			
			Make 'branch.c' use 'ref-filter' APIs for iterating through refs sorting. This removes most of the code used in 'branch.c' replacing it with calls to the 'ref-filter' library. Make 'branch.c' use the 'filter_refs()' function provided by 'ref-filter' to filter out tags based on the options set. We provide a sorting option provided for 'branch.c' by using the sorting options provided by 'ref-filter'. Also by default, we sort by 'refname'. Since 'HEAD' is alphabatically before 'refs/...' we end up with an array consisting of the 'HEAD' ref then the local branches and finally the remote-tracking branches. Also remove the 'ignore' variable from ref_array_item as it was previously used for the '--merged' option and now that is handled by ref-filter. Modify some of the tests in t1430 to check the stderr for a warning regarding the broken ref. This is done as ref-filter throws a warning for broken refs rather than directly printing them. Add tests and documentation for the same. Mentored-by: Christian Couder <christian.couder@gmail.com> Mentored-by: Matthieu Moy <matthieu.moy@grenoble-inp.fr> Signed-off-by: Karthik Nayak <karthik.188@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
		
			
				
	
	
		
			111 lines
		
	
	
		
			3.3 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			111 lines
		
	
	
		
			3.3 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| #ifndef REF_FILTER_H
 | |
| #define REF_FILTER_H
 | |
| 
 | |
| #include "sha1-array.h"
 | |
| #include "refs.h"
 | |
| #include "commit.h"
 | |
| #include "parse-options.h"
 | |
| 
 | |
| /* Quoting styles */
 | |
| #define QUOTE_NONE 0
 | |
| #define QUOTE_SHELL 1
 | |
| #define QUOTE_PERL 2
 | |
| #define QUOTE_PYTHON 4
 | |
| #define QUOTE_TCL 8
 | |
| 
 | |
| #define FILTER_REFS_INCLUDE_BROKEN 0x0001
 | |
| #define FILTER_REFS_TAGS           0x0002
 | |
| #define FILTER_REFS_BRANCHES       0x0004
 | |
| #define FILTER_REFS_REMOTES        0x0008
 | |
| #define FILTER_REFS_OTHERS         0x0010
 | |
| #define FILTER_REFS_ALL            (FILTER_REFS_TAGS | FILTER_REFS_BRANCHES | \
 | |
| 				    FILTER_REFS_REMOTES | FILTER_REFS_OTHERS)
 | |
| #define FILTER_REFS_DETACHED_HEAD  0x0020
 | |
| #define FILTER_REFS_KIND_MASK      (FILTER_REFS_ALL | FILTER_REFS_DETACHED_HEAD)
 | |
| 
 | |
| struct atom_value;
 | |
| 
 | |
| struct ref_sorting {
 | |
| 	struct ref_sorting *next;
 | |
| 	int atom; /* index into used_atom array (internal) */
 | |
| 	unsigned reverse : 1,
 | |
| 		version : 1;
 | |
| };
 | |
| 
 | |
| struct ref_array_item {
 | |
| 	unsigned char objectname[20];
 | |
| 	int flag;
 | |
| 	unsigned int kind;
 | |
| 	const char *symref;
 | |
| 	struct commit *commit;
 | |
| 	struct atom_value *value;
 | |
| 	char refname[FLEX_ARRAY];
 | |
| };
 | |
| 
 | |
| struct ref_array {
 | |
| 	int nr, alloc;
 | |
| 	struct ref_array_item **items;
 | |
| 	struct rev_info *revs;
 | |
| };
 | |
| 
 | |
| struct ref_filter {
 | |
| 	const char **name_patterns;
 | |
| 	struct sha1_array points_at;
 | |
| 	struct commit_list *with_commit;
 | |
| 
 | |
| 	enum {
 | |
| 		REF_FILTER_MERGED_NONE = 0,
 | |
| 		REF_FILTER_MERGED_INCLUDE,
 | |
| 		REF_FILTER_MERGED_OMIT
 | |
| 	} merge;
 | |
| 	struct commit *merge_commit;
 | |
| 
 | |
| 	unsigned int with_commit_tag_algo : 1,
 | |
| 		match_as_path : 1,
 | |
| 		detached : 1;
 | |
| 	unsigned int kind,
 | |
| 		lines;
 | |
| 	int abbrev,
 | |
| 		verbose;
 | |
| };
 | |
| 
 | |
| struct ref_filter_cbdata {
 | |
| 	struct ref_array *array;
 | |
| 	struct ref_filter *filter;
 | |
| };
 | |
| 
 | |
| /*  Macros for checking --merged and --no-merged options */
 | |
| #define _OPT_MERGED_NO_MERGED(option, filter, h) \
 | |
| 	{ OPTION_CALLBACK, 0, option, (filter), N_("commit"), (h), \
 | |
| 	  PARSE_OPT_LASTARG_DEFAULT | PARSE_OPT_NONEG, \
 | |
| 	  parse_opt_merge_filter, (intptr_t) "HEAD" \
 | |
| 	}
 | |
| #define OPT_MERGED(f, h) _OPT_MERGED_NO_MERGED("merged", f, h)
 | |
| #define OPT_NO_MERGED(f, h) _OPT_MERGED_NO_MERGED("no-merged", f, h)
 | |
| 
 | |
| /*
 | |
|  * API for filtering a set of refs. Based on the type of refs the user
 | |
|  * has requested, we iterate through those refs and apply filters
 | |
|  * as per the given ref_filter structure and finally store the
 | |
|  * filtered refs in the ref_array structure.
 | |
|  */
 | |
| int filter_refs(struct ref_array *array, struct ref_filter *filter, unsigned int type);
 | |
| /*  Clear all memory allocated to ref_array */
 | |
| void ref_array_clear(struct ref_array *array);
 | |
| /*  Parse format string and sort specifiers */
 | |
| int parse_ref_filter_atom(const char *atom, const char *ep);
 | |
| /*  Used to verify if the given format is correct and to parse out the used atoms */
 | |
| int verify_ref_format(const char *format);
 | |
| /*  Sort the given ref_array as per the ref_sorting provided */
 | |
| void ref_array_sort(struct ref_sorting *sort, struct ref_array *array);
 | |
| /*  Print the ref using the given format and quote_style */
 | |
| void show_ref_array_item(struct ref_array_item *info, const char *format, int quote_style);
 | |
| /*  Callback function for parsing the sort option */
 | |
| int parse_opt_ref_sorting(const struct option *opt, const char *arg, int unset);
 | |
| /*  Default sort option based on refname */
 | |
| struct ref_sorting *ref_default_sorting(void);
 | |
| /*  Function to parse --merged and --no-merged options */
 | |
| int parse_opt_merge_filter(const struct option *opt, const char *arg, int unset);
 | |
| 
 | |
| #endif /*  REF_FILTER_H  */
 |