Doc: add more detail for git-format-patch
[git.git] / list-objects-filter-options.c
blob1cb20c659c82b151a652da0528d0673ac629cc6c
1 #include "cache.h"
2 #include "commit.h"
3 #include "config.h"
4 #include "revision.h"
5 #include "argv-array.h"
6 #include "list-objects.h"
7 #include "list-objects-filter.h"
8 #include "list-objects-filter-options.h"
11 * Parse value of the argument to the "filter" keyword.
12 * On the command line this looks like:
13 * --filter=<arg>
14 * and in the pack protocol as:
15 * "filter" SP <arg>
17 * The filter keyword will be used by many commands.
18 * See Documentation/rev-list-options.txt for allowed values for <arg>.
20 * Capture the given arg as the "filter_spec". This can be forwarded to
21 * subordinate commands when necessary (although it's better to pass it through
22 * expand_list_objects_filter_spec() first). We also "intern" the arg for the
23 * convenience of the current command.
25 static int gently_parse_list_objects_filter(
26 struct list_objects_filter_options *filter_options,
27 const char *arg,
28 struct strbuf *errbuf)
30 const char *v0;
32 if (filter_options->choice) {
33 if (errbuf) {
34 strbuf_addstr(
35 errbuf,
36 _("multiple filter-specs cannot be combined"));
38 return 1;
41 filter_options->filter_spec = strdup(arg);
43 if (!strcmp(arg, "blob:none")) {
44 filter_options->choice = LOFC_BLOB_NONE;
45 return 0;
47 } else if (skip_prefix(arg, "blob:limit=", &v0)) {
48 if (git_parse_ulong(v0, &filter_options->blob_limit_value)) {
49 filter_options->choice = LOFC_BLOB_LIMIT;
50 return 0;
53 } else if (skip_prefix(arg, "tree:", &v0)) {
54 if (!git_parse_ulong(v0, &filter_options->tree_exclude_depth)) {
55 if (errbuf) {
56 strbuf_addstr(
57 errbuf,
58 _("expected 'tree:<depth>'"));
60 return 1;
62 filter_options->choice = LOFC_TREE_DEPTH;
63 return 0;
65 } else if (skip_prefix(arg, "sparse:oid=", &v0)) {
66 struct object_context oc;
67 struct object_id sparse_oid;
70 * Try to parse <oid-expression> into an OID for the current
71 * command, but DO NOT complain if we don't have the blob or
72 * ref locally.
74 if (!get_oid_with_context(the_repository, v0, GET_OID_BLOB,
75 &sparse_oid, &oc))
76 filter_options->sparse_oid_value = oiddup(&sparse_oid);
77 filter_options->choice = LOFC_SPARSE_OID;
78 return 0;
80 } else if (skip_prefix(arg, "sparse:path=", &v0)) {
81 if (errbuf) {
82 strbuf_addstr(
83 errbuf,
84 _("sparse:path filters support has been dropped"));
86 return 1;
89 * Please update _git_fetch() in git-completion.bash when you
90 * add new filters
93 if (errbuf)
94 strbuf_addf(errbuf, _("invalid filter-spec '%s'"), arg);
96 memset(filter_options, 0, sizeof(*filter_options));
97 return 1;
100 int parse_list_objects_filter(struct list_objects_filter_options *filter_options,
101 const char *arg)
103 struct strbuf buf = STRBUF_INIT;
104 if (gently_parse_list_objects_filter(filter_options, arg, &buf))
105 die("%s", buf.buf);
106 return 0;
109 int opt_parse_list_objects_filter(const struct option *opt,
110 const char *arg, int unset)
112 struct list_objects_filter_options *filter_options = opt->value;
114 if (unset || !arg) {
115 list_objects_filter_set_no_filter(filter_options);
116 return 0;
119 return parse_list_objects_filter(filter_options, arg);
122 void expand_list_objects_filter_spec(
123 const struct list_objects_filter_options *filter,
124 struct strbuf *expanded_spec)
126 strbuf_init(expanded_spec, strlen(filter->filter_spec));
127 if (filter->choice == LOFC_BLOB_LIMIT)
128 strbuf_addf(expanded_spec, "blob:limit=%lu",
129 filter->blob_limit_value);
130 else if (filter->choice == LOFC_TREE_DEPTH)
131 strbuf_addf(expanded_spec, "tree:%lu",
132 filter->tree_exclude_depth);
133 else
134 strbuf_addstr(expanded_spec, filter->filter_spec);
137 void list_objects_filter_release(
138 struct list_objects_filter_options *filter_options)
140 free(filter_options->filter_spec);
141 free(filter_options->sparse_oid_value);
142 memset(filter_options, 0, sizeof(*filter_options));
145 void partial_clone_register(
146 const char *remote,
147 const struct list_objects_filter_options *filter_options)
150 * Record the name of the partial clone remote in the
151 * config and in the global variable -- the latter is
152 * used throughout to indicate that partial clone is
153 * enabled and to expect missing objects.
155 if (repository_format_partial_clone &&
156 *repository_format_partial_clone &&
157 strcmp(remote, repository_format_partial_clone))
158 die(_("cannot change partial clone promisor remote"));
160 git_config_set("core.repositoryformatversion", "1");
161 git_config_set("extensions.partialclone", remote);
163 repository_format_partial_clone = xstrdup(remote);
166 * Record the initial filter-spec in the config as
167 * the default for subsequent fetches from this remote.
169 core_partial_clone_filter_default =
170 xstrdup(filter_options->filter_spec);
171 git_config_set("core.partialclonefilter",
172 core_partial_clone_filter_default);
175 void partial_clone_get_default_filter_spec(
176 struct list_objects_filter_options *filter_options)
179 * Parse default value, but silently ignore it if it is invalid.
181 if (!core_partial_clone_filter_default)
182 return;
183 gently_parse_list_objects_filter(filter_options,
184 core_partial_clone_filter_default,
185 NULL);