* [PATCH 1/4] refs: move to using the '.optimize' functions
2025-10-15 21:25 [PATCH 0/4] refs: cleanup code around optimizations Karthik Nayak
@ 2025-10-15 21:25 ` Karthik Nayak
2025-10-15 22:05 ` Justin Tobler
2025-10-15 21:25 ` [PATCH 2/4] refs: cleanup code around optimization Karthik Nayak
` (3 subsequent siblings)
4 siblings, 1 reply; 14+ messages in thread
From: Karthik Nayak @ 2025-10-15 21:25 UTC (permalink / raw)
To: git; +Cc: Karthik Nayak, ps, jltobler
The `struct ref_store` variable, exposes two ways to optimize a reftable
backend:
1. pack_refs
2. optimize
The former was specific to the 'files' + 'packed' refs backend. The
latter is more generic and covers all backends. While the naming is
different, both of these functions perform the same functionality.
In the following commit, we will consolidate this code to only maintain
the 'optimize' functions. In preparation, modify the backends so that
they exclusively implement the `optimize` callback, only. All users of
the refs subsystem already use the 'optimize' function so there is no
changes needed on the callee side.
Signed-off-by: Karthik Nayak <karthik.188@gmail.com>
---
refs/debug.c | 8 ++++----
refs/files-backend.c | 14 ++------------
refs/packed-backend.c | 6 +++---
refs/reftable-backend.c | 13 +++----------
4 files changed, 12 insertions(+), 29 deletions(-)
diff --git a/refs/debug.c b/refs/debug.c
index 01499b9033..40cd1d9c15 100644
--- a/refs/debug.c
+++ b/refs/debug.c
@@ -116,11 +116,11 @@ static int debug_transaction_abort(struct ref_store *refs,
return res;
}
-static int debug_pack_refs(struct ref_store *ref_store, struct pack_refs_opts *opts)
+static int debug_optimize(struct ref_store *ref_store, struct pack_refs_opts *opts)
{
struct debug_ref_store *drefs = (struct debug_ref_store *)ref_store;
- int res = drefs->refs->be->pack_refs(drefs->refs, opts);
- trace_printf_key(&trace_refs, "pack_refs: %d\n", res);
+ int res = drefs->refs->be->optimize(drefs->refs, opts);
+ trace_printf_key(&trace_refs, "optimize: %d\n", res);
return res;
}
@@ -430,7 +430,7 @@ struct ref_storage_be refs_be_debug = {
.transaction_finish = debug_transaction_finish,
.transaction_abort = debug_transaction_abort,
- .pack_refs = debug_pack_refs,
+ .optimize = debug_optimize,
.rename_ref = debug_rename_ref,
.copy_ref = debug_copy_ref,
diff --git a/refs/files-backend.c b/refs/files-backend.c
index ed8a1729d6..92d90fc508 100644
--- a/refs/files-backend.c
+++ b/refs/files-backend.c
@@ -1444,8 +1444,8 @@ static int should_pack_refs(struct files_ref_store *refs,
return 0;
}
-static int files_pack_refs(struct ref_store *ref_store,
- struct pack_refs_opts *opts)
+static int files_optimize(struct ref_store *ref_store,
+ struct pack_refs_opts *opts)
{
struct files_ref_store *refs =
files_downcast(ref_store, REF_STORE_WRITE | REF_STORE_ODB,
@@ -1512,15 +1512,6 @@ static int files_pack_refs(struct ref_store *ref_store,
return 0;
}
-static int files_optimize(struct ref_store *ref_store, struct pack_refs_opts *opts)
-{
- /*
- * For the "files" backend, "optimizing" is the same as "packing".
- * So, we just call the existing worker function for packing.
- */
- return files_pack_refs(ref_store, opts);
-}
-
/*
* People using contrib's git-new-workdir have .git/logs/refs ->
* /some/other/path/.git/logs/refs, and that may live on another device.
@@ -3969,7 +3960,6 @@ struct ref_storage_be refs_be_files = {
.transaction_finish = files_transaction_finish,
.transaction_abort = files_transaction_abort,
- .pack_refs = files_pack_refs,
.optimize = files_optimize,
.rename_ref = files_rename_ref,
.copy_ref = files_copy_ref,
diff --git a/refs/packed-backend.c b/refs/packed-backend.c
index 1ab0c50393..20cf9fab18 100644
--- a/refs/packed-backend.c
+++ b/refs/packed-backend.c
@@ -1773,8 +1773,8 @@ static int packed_transaction_finish(struct ref_store *ref_store,
return ret;
}
-static int packed_pack_refs(struct ref_store *ref_store UNUSED,
- struct pack_refs_opts *pack_opts UNUSED)
+static int packed_optimize(struct ref_store *ref_store UNUSED,
+ struct pack_refs_opts *pack_opts UNUSED)
{
/*
* Packed refs are already packed. It might be that loose refs
@@ -2129,7 +2129,7 @@ struct ref_storage_be refs_be_packed = {
.transaction_finish = packed_transaction_finish,
.transaction_abort = packed_transaction_abort,
- .pack_refs = packed_pack_refs,
+ .optimize = packed_optimize,
.rename_ref = NULL,
.copy_ref = NULL,
diff --git a/refs/reftable-backend.c b/refs/reftable-backend.c
index 6bbfd5618d..43cc66a48e 100644
--- a/refs/reftable-backend.c
+++ b/refs/reftable-backend.c
@@ -1700,11 +1700,11 @@ static int reftable_be_transaction_finish(struct ref_store *ref_store UNUSED,
return ret;
}
-static int reftable_be_pack_refs(struct ref_store *ref_store,
- struct pack_refs_opts *opts)
+static int reftable_be_optimize(struct ref_store *ref_store,
+ struct pack_refs_opts *opts)
{
struct reftable_ref_store *refs =
- reftable_be_downcast(ref_store, REF_STORE_WRITE | REF_STORE_ODB, "pack_refs");
+ reftable_be_downcast(ref_store, REF_STORE_WRITE | REF_STORE_ODB, "optimize_refs");
struct reftable_stack *stack;
int ret;
@@ -1733,12 +1733,6 @@ static int reftable_be_pack_refs(struct ref_store *ref_store,
return ret;
}
-static int reftable_be_optimize(struct ref_store *ref_store,
- struct pack_refs_opts *opts)
-{
- return reftable_be_pack_refs(ref_store, opts);
-}
-
struct write_create_symref_arg {
struct reftable_ref_store *refs;
struct reftable_stack *stack;
@@ -2761,7 +2755,6 @@ struct ref_storage_be refs_be_reftable = {
.transaction_finish = reftable_be_transaction_finish,
.transaction_abort = reftable_be_transaction_abort,
- .pack_refs = reftable_be_pack_refs,
.optimize = reftable_be_optimize,
.rename_ref = reftable_be_rename_ref,
.copy_ref = reftable_be_copy_ref,
--
2.51.0
^ permalink raw reply related [flat|nested] 14+ messages in thread* Re: [PATCH 1/4] refs: move to using the '.optimize' functions
2025-10-15 21:25 ` [PATCH 1/4] refs: move to using the '.optimize' functions Karthik Nayak
@ 2025-10-15 22:05 ` Justin Tobler
2025-10-16 10:37 ` Patrick Steinhardt
2025-10-16 12:03 ` Karthik Nayak
0 siblings, 2 replies; 14+ messages in thread
From: Justin Tobler @ 2025-10-15 22:05 UTC (permalink / raw)
To: Karthik Nayak; +Cc: git, ps
On 25/10/15 11:25PM, Karthik Nayak wrote:
> The `struct ref_store` variable, exposes two ways to optimize a reftable
s/variable,/variable/
> backend:
>
> 1. pack_refs
> 2. optimize
>
> The former was specific to the 'files' + 'packed' refs backend. The
> latter is more generic and covers all backends. While the naming is
> different, both of these functions perform the same functionality.
>
> In the following commit, we will consolidate this code to only maintain
> the 'optimize' functions. In preparation, modify the backends so that
> they exclusively implement the `optimize` callback, only. All users of
> the refs subsystem already use the 'optimize' function so there is no
> changes needed on the callee side.
>
> Signed-off-by: Karthik Nayak <karthik.188@gmail.com>
> ---
> refs/debug.c | 8 ++++----
> refs/files-backend.c | 14 ++------------
> refs/packed-backend.c | 6 +++---
> refs/reftable-backend.c | 13 +++----------
> 4 files changed, 12 insertions(+), 29 deletions(-)
>
> diff --git a/refs/debug.c b/refs/debug.c
> index 01499b9033..40cd1d9c15 100644
> --- a/refs/debug.c
> +++ b/refs/debug.c
> @@ -116,11 +116,11 @@ static int debug_transaction_abort(struct ref_store *refs,
> return res;
> }
>
> -static int debug_pack_refs(struct ref_store *ref_store, struct pack_refs_opts *opts)
> +static int debug_optimize(struct ref_store *ref_store, struct pack_refs_opts *opts)
> {
> struct debug_ref_store *drefs = (struct debug_ref_store *)ref_store;
> - int res = drefs->refs->be->pack_refs(drefs->refs, opts);
> - trace_printf_key(&trace_refs, "pack_refs: %d\n", res);
> + int res = drefs->refs->be->optimize(drefs->refs, opts);
> + trace_printf_key(&trace_refs, "optimize: %d\n", res);
> return res;
> }
>
> @@ -430,7 +430,7 @@ struct ref_storage_be refs_be_debug = {
> .transaction_finish = debug_transaction_finish,
> .transaction_abort = debug_transaction_abort,
>
> - .pack_refs = debug_pack_refs,
> + .optimize = debug_optimize,
question: Was the debug backend not using either of these callbacks?
From the commit message, it sounds like all the backends were using the
optimize callback.
> .rename_ref = debug_rename_ref,
> .copy_ref = debug_copy_ref,
>
> diff --git a/refs/files-backend.c b/refs/files-backend.c
> index ed8a1729d6..92d90fc508 100644
> --- a/refs/files-backend.c
> +++ b/refs/files-backend.c
> @@ -1444,8 +1444,8 @@ static int should_pack_refs(struct files_ref_store *refs,
> return 0;
> }
>
> -static int files_pack_refs(struct ref_store *ref_store,
> - struct pack_refs_opts *opts)
> +static int files_optimize(struct ref_store *ref_store,
> + struct pack_refs_opts *opts)
> {
> struct files_ref_store *refs =
> files_downcast(ref_store, REF_STORE_WRITE | REF_STORE_ODB,
> @@ -1512,15 +1512,6 @@ static int files_pack_refs(struct ref_store *ref_store,
> return 0;
> }
>
> -static int files_optimize(struct ref_store *ref_store, struct pack_refs_opts *opts)
> -{
> - /*
> - * For the "files" backend, "optimizing" is the same as "packing".
> - * So, we just call the existing worker function for packing.
> - */
> - return files_pack_refs(ref_store, opts);
> -}
> -
> /*
> * People using contrib's git-new-workdir have .git/logs/refs ->
> * /some/other/path/.git/logs/refs, and that may live on another device.
> @@ -3969,7 +3960,6 @@ struct ref_storage_be refs_be_files = {
> .transaction_finish = files_transaction_finish,
> .transaction_abort = files_transaction_abort,
>
> - .pack_refs = files_pack_refs,
> .optimize = files_optimize,
Ok, we are removing the "pack_refs" callback and its implementations
from all the backends in favor of using the just using the more generic
"optimize" callback. Make sense.
It does look like we still have `refs_pack_refs()` which references the
"optimize" callback. It looks like there are no users, but should we
also remove it as part of this patch?
-Justin
^ permalink raw reply [flat|nested] 14+ messages in thread* Re: [PATCH 1/4] refs: move to using the '.optimize' functions
2025-10-15 22:05 ` Justin Tobler
@ 2025-10-16 10:37 ` Patrick Steinhardt
2025-10-16 12:07 ` Karthik Nayak
2025-10-16 12:03 ` Karthik Nayak
1 sibling, 1 reply; 14+ messages in thread
From: Patrick Steinhardt @ 2025-10-16 10:37 UTC (permalink / raw)
To: Justin Tobler; +Cc: Karthik Nayak, git
On Wed, Oct 15, 2025 at 05:05:46PM -0500, Justin Tobler wrote:
> On 25/10/15 11:25PM, Karthik Nayak wrote:
> > diff --git a/refs/debug.c b/refs/debug.c
> > index 01499b9033..40cd1d9c15 100644
> > --- a/refs/debug.c
> > +++ b/refs/debug.c
> > @@ -116,11 +116,11 @@ static int debug_transaction_abort(struct ref_store *refs,
> > return res;
> > }
> >
> > -static int debug_pack_refs(struct ref_store *ref_store, struct pack_refs_opts *opts)
> > +static int debug_optimize(struct ref_store *ref_store, struct pack_refs_opts *opts)
> > {
> > struct debug_ref_store *drefs = (struct debug_ref_store *)ref_store;
> > - int res = drefs->refs->be->pack_refs(drefs->refs, opts);
> > - trace_printf_key(&trace_refs, "pack_refs: %d\n", res);
> > + int res = drefs->refs->be->optimize(drefs->refs, opts);
> > + trace_printf_key(&trace_refs, "optimize: %d\n", res);
> > return res;
> > }
> >
> > @@ -430,7 +430,7 @@ struct ref_storage_be refs_be_debug = {
> > .transaction_finish = debug_transaction_finish,
> > .transaction_abort = debug_transaction_abort,
> >
> > - .pack_refs = debug_pack_refs,
> > + .optimize = debug_optimize,
>
> question: Was the debug backend not using either of these callbacks?
> From the commit message, it sounds like all the backends were using the
> optimize callback.
Doesn't look like it. Overall I kind of doubt the value that this
backend has. I have never had even a single use case for it, and I have
been working with references extensively over the last two or three
years by now.
Maybe we should just drop it eventually?
Patrick
^ permalink raw reply [flat|nested] 14+ messages in thread* Re: [PATCH 1/4] refs: move to using the '.optimize' functions
2025-10-16 10:37 ` Patrick Steinhardt
@ 2025-10-16 12:07 ` Karthik Nayak
2025-10-16 12:11 ` Patrick Steinhardt
0 siblings, 1 reply; 14+ messages in thread
From: Karthik Nayak @ 2025-10-16 12:07 UTC (permalink / raw)
To: Patrick Steinhardt, Justin Tobler; +Cc: git
[-- Attachment #1: Type: text/plain, Size: 2149 bytes --]
Patrick Steinhardt <ps@pks.im> writes:
> On Wed, Oct 15, 2025 at 05:05:46PM -0500, Justin Tobler wrote:
>> On 25/10/15 11:25PM, Karthik Nayak wrote:
>> > diff --git a/refs/debug.c b/refs/debug.c
>> > index 01499b9033..40cd1d9c15 100644
>> > --- a/refs/debug.c
>> > +++ b/refs/debug.c
>> > @@ -116,11 +116,11 @@ static int debug_transaction_abort(struct ref_store *refs,
>> > return res;
>> > }
>> >
>> > -static int debug_pack_refs(struct ref_store *ref_store, struct pack_refs_opts *opts)
>> > +static int debug_optimize(struct ref_store *ref_store, struct pack_refs_opts *opts)
>> > {
>> > struct debug_ref_store *drefs = (struct debug_ref_store *)ref_store;
>> > - int res = drefs->refs->be->pack_refs(drefs->refs, opts);
>> > - trace_printf_key(&trace_refs, "pack_refs: %d\n", res);
>> > + int res = drefs->refs->be->optimize(drefs->refs, opts);
>> > + trace_printf_key(&trace_refs, "optimize: %d\n", res);
>> > return res;
>> > }
>> >
>> > @@ -430,7 +430,7 @@ struct ref_storage_be refs_be_debug = {
>> > .transaction_finish = debug_transaction_finish,
>> > .transaction_abort = debug_transaction_abort,
>> >
>> > - .pack_refs = debug_pack_refs,
>> > + .optimize = debug_optimize,
>>
>> question: Was the debug backend not using either of these callbacks?
>> From the commit message, it sounds like all the backends were using the
>> optimize callback.
>
> Doesn't look like it. Overall I kind of doubt the value that this
> backend has. I have never had even a single use case for it, and I have
> been working with references extensively over the last two or three
> years by now.
>
> Maybe we should just drop it eventually?
>
> Patrick
I'd be happy to drop it too as a Git developer. But I can merit in
keeping it. It does wrap around all reference subsystem calls and if
tracing is enabled it would log these reference calls. This can be used
in bug reports.
However, a counter argument would be that these only track the surface
level APIs to each backend, but not really the internal details.
Considering this and also the fact that we need to update the backend
for every change made, I'm for dropping it too.
Karthik
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 690 bytes --]
^ permalink raw reply [flat|nested] 14+ messages in thread* Re: [PATCH 1/4] refs: move to using the '.optimize' functions
2025-10-16 12:07 ` Karthik Nayak
@ 2025-10-16 12:11 ` Patrick Steinhardt
0 siblings, 0 replies; 14+ messages in thread
From: Patrick Steinhardt @ 2025-10-16 12:11 UTC (permalink / raw)
To: Karthik Nayak; +Cc: Justin Tobler, git
On Thu, Oct 16, 2025 at 07:07:33AM -0500, Karthik Nayak wrote:
> Patrick Steinhardt <ps@pks.im> writes:
> > On Wed, Oct 15, 2025 at 05:05:46PM -0500, Justin Tobler wrote:
> >> On 25/10/15 11:25PM, Karthik Nayak wrote:
> >> > @@ -430,7 +430,7 @@ struct ref_storage_be refs_be_debug = {
> >> > .transaction_finish = debug_transaction_finish,
> >> > .transaction_abort = debug_transaction_abort,
> >> >
> >> > - .pack_refs = debug_pack_refs,
> >> > + .optimize = debug_optimize,
> >>
> >> question: Was the debug backend not using either of these callbacks?
> >> From the commit message, it sounds like all the backends were using the
> >> optimize callback.
> >
> > Doesn't look like it. Overall I kind of doubt the value that this
> > backend has. I have never had even a single use case for it, and I have
> > been working with references extensively over the last two or three
> > years by now.
> >
> > Maybe we should just drop it eventually?
> >
> > Patrick
>
> I'd be happy to drop it too as a Git developer. But I can merit in
> keeping it. It does wrap around all reference subsystem calls and if
> tracing is enabled it would log these reference calls. This can be used
> in bug reports.
>
> However, a counter argument would be that these only track the surface
> level APIs to each backend, but not really the internal details.
>
> Considering this and also the fact that we need to update the backend
> for every change made, I'm for dropping it too.
Digging a bit deeper: I think this actually _is_ exposed via our tracing
API. So if you run Git with GIT_TRACE_REFS= set it will indeed use that
debug backend. TIL.
So with that I'll reverse my stance and say that this probably makes
sense to keep.
Patrick
^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: [PATCH 1/4] refs: move to using the '.optimize' functions
2025-10-15 22:05 ` Justin Tobler
2025-10-16 10:37 ` Patrick Steinhardt
@ 2025-10-16 12:03 ` Karthik Nayak
1 sibling, 0 replies; 14+ messages in thread
From: Karthik Nayak @ 2025-10-16 12:03 UTC (permalink / raw)
To: Justin Tobler; +Cc: git, ps
[-- Attachment #1: Type: text/plain, Size: 3560 bytes --]
Justin Tobler <jltobler@gmail.com> writes:
> On 25/10/15 11:25PM, Karthik Nayak wrote:
>> The `struct ref_store` variable, exposes two ways to optimize a reftable
>
> s/variable,/variable/
>
Will fix.
>> diff --git a/refs/debug.c b/refs/debug.c
>> index 01499b9033..40cd1d9c15 100644
>> --- a/refs/debug.c
>> +++ b/refs/debug.c
>> @@ -116,11 +116,11 @@ static int debug_transaction_abort(struct ref_store *refs,
>> return res;
>> }
>>
>> -static int debug_pack_refs(struct ref_store *ref_store, struct pack_refs_opts *opts)
>> +static int debug_optimize(struct ref_store *ref_store, struct pack_refs_opts *opts)
>> {
>> struct debug_ref_store *drefs = (struct debug_ref_store *)ref_store;
>> - int res = drefs->refs->be->pack_refs(drefs->refs, opts);
>> - trace_printf_key(&trace_refs, "pack_refs: %d\n", res);
>> + int res = drefs->refs->be->optimize(drefs->refs, opts);
>> + trace_printf_key(&trace_refs, "optimize: %d\n", res);
>> return res;
>> }
>>
>> @@ -430,7 +430,7 @@ struct ref_storage_be refs_be_debug = {
>> .transaction_finish = debug_transaction_finish,
>> .transaction_abort = debug_transaction_abort,
>>
>> - .pack_refs = debug_pack_refs,
>> + .optimize = debug_optimize,
>
> question: Was the debug backend not using either of these callbacks?
> From the commit message, it sounds like all the backends were using the
> optimize callback.
>
Since there are no users of `refs_pack_refs()` which uses the
'.pack_refs' field, there are no users of 'debug_pack_refs()'.
But if tracing is enabled then the debug backend would wrap around the
other backends and any calls to `refs_optimize()` would call
`debug_optimize()`.
>> .rename_ref = debug_rename_ref,
>> .copy_ref = debug_copy_ref,
>>
>> diff --git a/refs/files-backend.c b/refs/files-backend.c
>> index ed8a1729d6..92d90fc508 100644
>> --- a/refs/files-backend.c
>> +++ b/refs/files-backend.c
>> @@ -1444,8 +1444,8 @@ static int should_pack_refs(struct files_ref_store *refs,
>> return 0;
>> }
>>
>> -static int files_pack_refs(struct ref_store *ref_store,
>> - struct pack_refs_opts *opts)
>> +static int files_optimize(struct ref_store *ref_store,
>> + struct pack_refs_opts *opts)
>> {
>> struct files_ref_store *refs =
>> files_downcast(ref_store, REF_STORE_WRITE | REF_STORE_ODB,
>> @@ -1512,15 +1512,6 @@ static int files_pack_refs(struct ref_store *ref_store,
>> return 0;
>> }
>>
>> -static int files_optimize(struct ref_store *ref_store, struct pack_refs_opts *opts)
>> -{
>> - /*
>> - * For the "files" backend, "optimizing" is the same as "packing".
>> - * So, we just call the existing worker function for packing.
>> - */
>> - return files_pack_refs(ref_store, opts);
>> -}
>> -
>> /*
>> * People using contrib's git-new-workdir have .git/logs/refs ->
>> * /some/other/path/.git/logs/refs, and that may live on another device.
>> @@ -3969,7 +3960,6 @@ struct ref_storage_be refs_be_files = {
>> .transaction_finish = files_transaction_finish,
>> .transaction_abort = files_transaction_abort,
>>
>> - .pack_refs = files_pack_refs,
>> .optimize = files_optimize,
>
> Ok, we are removing the "pack_refs" callback and its implementations
> from all the backends in favor of using the just using the more generic
> "optimize" callback. Make sense.
>
> It does look like we still have `refs_pack_refs()` which references the
> "optimize" callback. It looks like there are no users, but should we
> also remove it as part of this patch?
>
> -Justin
It's done in the next commit, let me just squash that in to make it
easier.
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 690 bytes --]
^ permalink raw reply [flat|nested] 14+ messages in thread
* [PATCH 2/4] refs: cleanup code around optimization
2025-10-15 21:25 [PATCH 0/4] refs: cleanup code around optimizations Karthik Nayak
2025-10-15 21:25 ` [PATCH 1/4] refs: move to using the '.optimize' functions Karthik Nayak
@ 2025-10-15 21:25 ` Karthik Nayak
2025-10-15 22:09 ` Justin Tobler
2025-10-15 21:25 ` [PATCH 3/4] refs: rename 'pack_refs_opts' to 'refs_optimize_opts' Karthik Nayak
` (2 subsequent siblings)
4 siblings, 1 reply; 14+ messages in thread
From: Karthik Nayak @ 2025-10-15 21:25 UTC (permalink / raw)
To: git; +Cc: Karthik Nayak, ps, jltobler
The previous commit, moved all backends to only use/support the
'optimize' function within the `ref_store` structure. With this, cleanup
all references to the 'pack_refs' field of the structure and code around
it.
Signed-off-by: Karthik Nayak <karthik.188@gmail.com>
---
refs.c | 6 ------
refs.h | 8 +-------
refs/refs-internal.h | 3 ---
3 files changed, 1 insertion(+), 16 deletions(-)
diff --git a/refs.c b/refs.c
index a41a94ae55..b9a4a60646 100644
--- a/refs.c
+++ b/refs.c
@@ -2313,12 +2313,6 @@ void base_ref_store_init(struct ref_store *refs, struct repository *repo,
refs->gitdir = xstrdup(path);
}
-/* backend functions */
-int refs_pack_refs(struct ref_store *refs, struct pack_refs_opts *opts)
-{
- return refs->be->pack_refs(refs, opts);
-}
-
int refs_optimize(struct ref_store *refs, struct pack_refs_opts *opts)
{
return refs->be->optimize(refs, opts);
diff --git a/refs.h b/refs.h
index 23437d1220..04e917fec0 100644
--- a/refs.h
+++ b/refs.h
@@ -499,7 +499,7 @@ void refs_warn_dangling_symrefs(struct ref_store *refs, FILE *fp,
const struct string_list *refnames);
/*
- * Flags for controlling behaviour of pack_refs()
+ * Flags for controlling behaviour of refs_optimize()
* PACK_REFS_PRUNE: Prune loose refs after packing
* PACK_REFS_AUTO: Pack refs on a best effort basis. The heuristics and end
* result are decided by the ref backend. Backends may ignore
@@ -514,12 +514,6 @@ struct pack_refs_opts {
struct string_list *includes;
};
-/*
- * Write a packed-refs file for the current repository.
- * flags: Combination of the above PACK_REFS_* flags.
- */
-int refs_pack_refs(struct ref_store *refs, struct pack_refs_opts *opts);
-
/*
* Optimize the ref store. The exact behavior is up to the backend.
* For the files backend, this is equivalent to packing refs.
diff --git a/refs/refs-internal.h b/refs/refs-internal.h
index 4671517dad..fc5149df5b 100644
--- a/refs/refs-internal.h
+++ b/refs/refs-internal.h
@@ -422,8 +422,6 @@ typedef int ref_transaction_commit_fn(struct ref_store *refs,
struct ref_transaction *transaction,
struct strbuf *err);
-typedef int pack_refs_fn(struct ref_store *ref_store,
- struct pack_refs_opts *opts);
typedef int optimize_fn(struct ref_store *ref_store,
struct pack_refs_opts *opts);
typedef int rename_ref_fn(struct ref_store *ref_store,
@@ -550,7 +548,6 @@ struct ref_storage_be {
ref_transaction_finish_fn *transaction_finish;
ref_transaction_abort_fn *transaction_abort;
- pack_refs_fn *pack_refs;
optimize_fn *optimize;
rename_ref_fn *rename_ref;
copy_ref_fn *copy_ref;
--
2.51.0
^ permalink raw reply related [flat|nested] 14+ messages in thread* Re: [PATCH 2/4] refs: cleanup code around optimization
2025-10-15 21:25 ` [PATCH 2/4] refs: cleanup code around optimization Karthik Nayak
@ 2025-10-15 22:09 ` Justin Tobler
0 siblings, 0 replies; 14+ messages in thread
From: Justin Tobler @ 2025-10-15 22:09 UTC (permalink / raw)
To: Karthik Nayak; +Cc: git, ps
On 25/10/15 11:25PM, Karthik Nayak wrote:
> The previous commit moved all backends to only use/support the
s/commit,/commit/
> 'optimize' function within the `ref_store` structure. With this, cleanup
> all references to the 'pack_refs' field of the structure and code around
> it.
>
> Signed-off-by: Karthik Nayak <karthik.188@gmail.com>
> ---
> refs.c | 6 ------
> refs.h | 8 +-------
> refs/refs-internal.h | 3 ---
> 3 files changed, 1 insertion(+), 16 deletions(-)
>
> diff --git a/refs.c b/refs.c
> index a41a94ae55..b9a4a60646 100644
> --- a/refs.c
> +++ b/refs.c
> @@ -2313,12 +2313,6 @@ void base_ref_store_init(struct ref_store *refs, struct repository *repo,
> refs->gitdir = xstrdup(path);
> }
>
> -/* backend functions */
> -int refs_pack_refs(struct ref_store *refs, struct pack_refs_opts *opts)
> -{
> - return refs->be->pack_refs(refs, opts);
> -}
Ah ok, so we are removing `refs_pack_refs()` here in this patch. Maybe
we can just squash this change into the previous patch. Probably not a
big deal either way.
The other cleanups in this patch look good.
-Justin
^ permalink raw reply [flat|nested] 14+ messages in thread
* [PATCH 3/4] refs: rename 'pack_refs_opts' to 'refs_optimize_opts'
2025-10-15 21:25 [PATCH 0/4] refs: cleanup code around optimizations Karthik Nayak
2025-10-15 21:25 ` [PATCH 1/4] refs: move to using the '.optimize' functions Karthik Nayak
2025-10-15 21:25 ` [PATCH 2/4] refs: cleanup code around optimization Karthik Nayak
@ 2025-10-15 21:25 ` Karthik Nayak
2025-10-15 22:18 ` Justin Tobler
2025-10-15 21:25 ` [PATCH 4/4] t/pack-refs-tests: move the 'test_done' to callees Karthik Nayak
2025-10-16 10:38 ` [PATCH 0/4] refs: cleanup code around optimizations Patrick Steinhardt
4 siblings, 1 reply; 14+ messages in thread
From: Karthik Nayak @ 2025-10-15 21:25 UTC (permalink / raw)
To: git; +Cc: Karthik Nayak, ps, jltobler
The previous commit removed all references to 'pack_refs()' within
the refs subsystem. Continue this cleanup by also renaming
'pack_refs_opts' to 'refs_optimize_opts' and the respective flags
accordingly. Keeping the naming consistent will make the code easier to
maintain.
Signed-off-by: Karthik Nayak <karthik.188@gmail.com>
---
pack-refs.c | 8 ++++----
refs.c | 2 +-
refs.h | 16 ++++++++--------
refs/debug.c | 2 +-
refs/files-backend.c | 10 +++++-----
refs/packed-backend.c | 2 +-
refs/refs-internal.h | 2 +-
refs/reftable-backend.c | 4 ++--
8 files changed, 23 insertions(+), 23 deletions(-)
diff --git a/pack-refs.c b/pack-refs.c
index 1a5e07d8b8..d0ffed93c1 100644
--- a/pack-refs.c
+++ b/pack-refs.c
@@ -14,10 +14,10 @@ int pack_refs_core(int argc,
{
struct ref_exclusions excludes = REF_EXCLUSIONS_INIT;
struct string_list included_refs = STRING_LIST_INIT_NODUP;
- struct pack_refs_opts pack_refs_opts = {
+ struct refs_optimize_opts pack_refs_opts = {
.exclusions = &excludes,
.includes = &included_refs,
- .flags = PACK_REFS_PRUNE,
+ .flags = REFS_OPTIMIZE_PRUNE,
};
struct string_list option_excluded_refs = STRING_LIST_INIT_NODUP;
struct string_list_item *item;
@@ -26,8 +26,8 @@ int pack_refs_core(int argc,
struct option opts[] = {
OPT_BOOL(0, "all", &pack_all, N_("pack everything")),
- OPT_BIT(0, "prune", &pack_refs_opts.flags, N_("prune loose refs (default)"), PACK_REFS_PRUNE),
- OPT_BIT(0, "auto", &pack_refs_opts.flags, N_("auto-pack refs as needed"), PACK_REFS_AUTO),
+ OPT_BIT(0, "prune", &pack_refs_opts.flags, N_("prune loose refs (default)"), REFS_OPTIMIZE_PRUNE),
+ OPT_BIT(0, "auto", &pack_refs_opts.flags, N_("auto-pack refs as needed"), REFS_OPTIMIZE_AUTO),
OPT_STRING_LIST(0, "include", pack_refs_opts.includes, N_("pattern"),
N_("references to include")),
OPT_STRING_LIST(0, "exclude", &option_excluded_refs, N_("pattern"),
diff --git a/refs.c b/refs.c
index b9a4a60646..0d0831f29b 100644
--- a/refs.c
+++ b/refs.c
@@ -2313,7 +2313,7 @@ void base_ref_store_init(struct ref_store *refs, struct repository *repo,
refs->gitdir = xstrdup(path);
}
-int refs_optimize(struct ref_store *refs, struct pack_refs_opts *opts)
+int refs_optimize(struct ref_store *refs, struct refs_optimize_opts *opts)
{
return refs->be->optimize(refs, opts);
}
diff --git a/refs.h b/refs.h
index 04e917fec0..d2630af97f 100644
--- a/refs.h
+++ b/refs.h
@@ -500,15 +500,15 @@ void refs_warn_dangling_symrefs(struct ref_store *refs, FILE *fp,
/*
* Flags for controlling behaviour of refs_optimize()
- * PACK_REFS_PRUNE: Prune loose refs after packing
- * PACK_REFS_AUTO: Pack refs on a best effort basis. The heuristics and end
- * result are decided by the ref backend. Backends may ignore
- * this flag and fall back to a normal repack.
+ * REFS_OPTIMIZE_PRUNE: Prune loose refs after packing
+ * REFS_OPTIMIZE_AUTO: Pack refs on a best effort basis. The heuristics and end
+ * result are decided by the ref backend. Backends may ignore
+ * this flag and fall back to a normal repack.
*/
-#define PACK_REFS_PRUNE (1 << 0)
-#define PACK_REFS_AUTO (1 << 1)
+#define REFS_OPTIMIZE_PRUNE (1 << 0)
+#define REFS_OPTIMIZE_AUTO (1 << 1)
-struct pack_refs_opts {
+struct refs_optimize_opts {
unsigned int flags;
struct ref_exclusions *exclusions;
struct string_list *includes;
@@ -518,7 +518,7 @@ struct pack_refs_opts {
* Optimize the ref store. The exact behavior is up to the backend.
* For the files backend, this is equivalent to packing refs.
*/
-int refs_optimize(struct ref_store *refs, struct pack_refs_opts *opts);
+int refs_optimize(struct ref_store *refs, struct refs_optimize_opts *opts);
/*
* Setup reflog before using. Fill in err and return -1 on failure.
diff --git a/refs/debug.c b/refs/debug.c
index 40cd1d9c15..2defd2d465 100644
--- a/refs/debug.c
+++ b/refs/debug.c
@@ -116,7 +116,7 @@ static int debug_transaction_abort(struct ref_store *refs,
return res;
}
-static int debug_optimize(struct ref_store *ref_store, struct pack_refs_opts *opts)
+static int debug_optimize(struct ref_store *ref_store, struct refs_optimize_opts *opts)
{
struct debug_ref_store *drefs = (struct debug_ref_store *)ref_store;
int res = drefs->refs->be->optimize(drefs->refs, opts);
diff --git a/refs/files-backend.c b/refs/files-backend.c
index 92d90fc508..2f60395cd2 100644
--- a/refs/files-backend.c
+++ b/refs/files-backend.c
@@ -1355,7 +1355,7 @@ static void prune_refs(struct files_ref_store *refs, struct ref_to_prune **refs_
*/
static int should_pack_ref(struct files_ref_store *refs,
const struct reference *ref,
- struct pack_refs_opts *opts)
+ struct refs_optimize_opts *opts)
{
struct string_list_item *item;
@@ -1383,7 +1383,7 @@ static int should_pack_ref(struct files_ref_store *refs,
}
static int should_pack_refs(struct files_ref_store *refs,
- struct pack_refs_opts *opts)
+ struct refs_optimize_opts *opts)
{
struct ref_iterator *iter;
size_t packed_size;
@@ -1391,7 +1391,7 @@ static int should_pack_refs(struct files_ref_store *refs,
size_t limit;
int ret;
- if (!(opts->flags & PACK_REFS_AUTO))
+ if (!(opts->flags & REFS_OPTIMIZE_AUTO))
return 1;
ret = packed_refs_size(refs->packed_ref_store, &packed_size);
@@ -1445,7 +1445,7 @@ static int should_pack_refs(struct files_ref_store *refs,
}
static int files_optimize(struct ref_store *ref_store,
- struct pack_refs_opts *opts)
+ struct refs_optimize_opts *opts)
{
struct files_ref_store *refs =
files_downcast(ref_store, REF_STORE_WRITE | REF_STORE_ODB,
@@ -1488,7 +1488,7 @@ static int files_optimize(struct ref_store *ref_store,
iter->ref.name, err.buf);
/* Schedule the loose reference for pruning if requested. */
- if ((opts->flags & PACK_REFS_PRUNE)) {
+ if ((opts->flags & REFS_OPTIMIZE_PRUNE)) {
struct ref_to_prune *n;
FLEX_ALLOC_STR(n, name, iter->ref.name);
oidcpy(&n->oid, iter->ref.oid);
diff --git a/refs/packed-backend.c b/refs/packed-backend.c
index 20cf9fab18..0aa0ff6701 100644
--- a/refs/packed-backend.c
+++ b/refs/packed-backend.c
@@ -1774,7 +1774,7 @@ static int packed_transaction_finish(struct ref_store *ref_store,
}
static int packed_optimize(struct ref_store *ref_store UNUSED,
- struct pack_refs_opts *pack_opts UNUSED)
+ struct refs_optimize_opts *pack_opts UNUSED)
{
/*
* Packed refs are already packed. It might be that loose refs
diff --git a/refs/refs-internal.h b/refs/refs-internal.h
index fc5149df5b..dee42f231d 100644
--- a/refs/refs-internal.h
+++ b/refs/refs-internal.h
@@ -423,7 +423,7 @@ typedef int ref_transaction_commit_fn(struct ref_store *refs,
struct strbuf *err);
typedef int optimize_fn(struct ref_store *ref_store,
- struct pack_refs_opts *opts);
+ struct refs_optimize_opts *opts);
typedef int rename_ref_fn(struct ref_store *ref_store,
const char *oldref, const char *newref,
const char *logmsg);
diff --git a/refs/reftable-backend.c b/refs/reftable-backend.c
index 43cc66a48e..c23c45f3bf 100644
--- a/refs/reftable-backend.c
+++ b/refs/reftable-backend.c
@@ -1701,7 +1701,7 @@ static int reftable_be_transaction_finish(struct ref_store *ref_store UNUSED,
}
static int reftable_be_optimize(struct ref_store *ref_store,
- struct pack_refs_opts *opts)
+ struct refs_optimize_opts *opts)
{
struct reftable_ref_store *refs =
reftable_be_downcast(ref_store, REF_STORE_WRITE | REF_STORE_ODB, "optimize_refs");
@@ -1715,7 +1715,7 @@ static int reftable_be_optimize(struct ref_store *ref_store,
if (!stack)
stack = refs->main_backend.stack;
- if (opts->flags & PACK_REFS_AUTO)
+ if (opts->flags & REFS_OPTIMIZE_AUTO)
ret = reftable_stack_auto_compact(stack);
else
ret = reftable_stack_compact_all(stack, NULL);
--
2.51.0
^ permalink raw reply related [flat|nested] 14+ messages in thread* Re: [PATCH 3/4] refs: rename 'pack_refs_opts' to 'refs_optimize_opts'
2025-10-15 21:25 ` [PATCH 3/4] refs: rename 'pack_refs_opts' to 'refs_optimize_opts' Karthik Nayak
@ 2025-10-15 22:18 ` Justin Tobler
2025-10-16 12:15 ` Karthik Nayak
0 siblings, 1 reply; 14+ messages in thread
From: Justin Tobler @ 2025-10-15 22:18 UTC (permalink / raw)
To: Karthik Nayak; +Cc: git, ps
On 25/10/15 11:25PM, Karthik Nayak wrote:
> The previous commit removed all references to 'pack_refs()' within
> the refs subsystem. Continue this cleanup by also renaming
> 'pack_refs_opts' to 'refs_optimize_opts' and the respective flags
> accordingly. Keeping the naming consistent will make the code easier to
> maintain.
>
> Signed-off-by: Karthik Nayak <karthik.188@gmail.com>
> ---
> pack-refs.c | 8 ++++----
> refs.c | 2 +-
> refs.h | 16 ++++++++--------
> refs/debug.c | 2 +-
> refs/files-backend.c | 10 +++++-----
> refs/packed-backend.c | 2 +-
> refs/refs-internal.h | 2 +-
> refs/reftable-backend.c | 4 ++--
> 8 files changed, 23 insertions(+), 23 deletions(-)
>
> diff --git a/pack-refs.c b/pack-refs.c
> index 1a5e07d8b8..d0ffed93c1 100644
> --- a/pack-refs.c
> +++ b/pack-refs.c
> @@ -14,10 +14,10 @@ int pack_refs_core(int argc,
> {
> struct ref_exclusions excludes = REF_EXCLUSIONS_INIT;
> struct string_list included_refs = STRING_LIST_INIT_NODUP;
> - struct pack_refs_opts pack_refs_opts = {
> + struct refs_optimize_opts pack_refs_opts = {
We could rename the variable name here to, but probably not a big deal
either way.
> .exclusions = &excludes,
> .includes = &included_refs,
> - .flags = PACK_REFS_PRUNE,
> + .flags = REFS_OPTIMIZE_PRUNE,
> };
> struct string_list option_excluded_refs = STRING_LIST_INIT_NODUP;
> struct string_list_item *item;
> @@ -26,8 +26,8 @@ int pack_refs_core(int argc,
>
> struct option opts[] = {
> OPT_BOOL(0, "all", &pack_all, N_("pack everything")),
> - OPT_BIT(0, "prune", &pack_refs_opts.flags, N_("prune loose refs (default)"), PACK_REFS_PRUNE),
> - OPT_BIT(0, "auto", &pack_refs_opts.flags, N_("auto-pack refs as needed"), PACK_REFS_AUTO),
> + OPT_BIT(0, "prune", &pack_refs_opts.flags, N_("prune loose refs (default)"), REFS_OPTIMIZE_PRUNE),
> + OPT_BIT(0, "auto", &pack_refs_opts.flags, N_("auto-pack refs as needed"), REFS_OPTIMIZE_AUTO),
> OPT_STRING_LIST(0, "include", pack_refs_opts.includes, N_("pattern"),
> N_("references to include")),
> OPT_STRING_LIST(0, "exclude", &option_excluded_refs, N_("pattern"),
> diff --git a/refs.c b/refs.c
> index b9a4a60646..0d0831f29b 100644
> --- a/refs.c
> +++ b/refs.c
> @@ -2313,7 +2313,7 @@ void base_ref_store_init(struct ref_store *refs, struct repository *repo,
> refs->gitdir = xstrdup(path);
> }
>
> -int refs_optimize(struct ref_store *refs, struct pack_refs_opts *opts)
> +int refs_optimize(struct ref_store *refs, struct refs_optimize_opts *opts)
> {
> return refs->be->optimize(refs, opts);
> }
> diff --git a/refs.h b/refs.h
> index 04e917fec0..d2630af97f 100644
> --- a/refs.h
> +++ b/refs.h
> @@ -500,15 +500,15 @@ void refs_warn_dangling_symrefs(struct ref_store *refs, FILE *fp,
>
> /*
> * Flags for controlling behaviour of refs_optimize()
> - * PACK_REFS_PRUNE: Prune loose refs after packing
> - * PACK_REFS_AUTO: Pack refs on a best effort basis. The heuristics and end
> - * result are decided by the ref backend. Backends may ignore
> - * this flag and fall back to a normal repack.
> + * REFS_OPTIMIZE_PRUNE: Prune loose refs after packing
> + * REFS_OPTIMIZE_AUTO: Pack refs on a best effort basis. The heuristics and end
> + * result are decided by the ref backend. Backends may ignore
> + * this flag and fall back to a normal repack.
> */
> -#define PACK_REFS_PRUNE (1 << 0)
> -#define PACK_REFS_AUTO (1 << 1)
> +#define REFS_OPTIMIZE_PRUNE (1 << 0)
> +#define REFS_OPTIMIZE_AUTO (1 << 1)
>
> -struct pack_refs_opts {
> +struct refs_optimize_opts {
> unsigned int flags;
> struct ref_exclusions *exclusions;
> struct string_list *includes;
> @@ -518,7 +518,7 @@ struct pack_refs_opts {
> * Optimize the ref store. The exact behavior is up to the backend.
> * For the files backend, this is equivalent to packing refs.
> */
> -int refs_optimize(struct ref_store *refs, struct pack_refs_opts *opts);
> +int refs_optimize(struct ref_store *refs, struct refs_optimize_opts *opts);
I noticed when poking around the code that the optimize callback was
still using the `pack_refs_opts`. Nice to see this clean up. :)
> /*
> * Setup reflog before using. Fill in err and return -1 on failure.
[snip]
> diff --git a/refs/packed-backend.c b/refs/packed-backend.c
> index 20cf9fab18..0aa0ff6701 100644
> --- a/refs/packed-backend.c
> +++ b/refs/packed-backend.c
> @@ -1774,7 +1774,7 @@ static int packed_transaction_finish(struct ref_store *ref_store,
> }
>
> static int packed_optimize(struct ref_store *ref_store UNUSED,
> - struct pack_refs_opts *pack_opts UNUSED)
> + struct refs_optimize_opts *pack_opts UNUSED)
Also not a big deal, but we could rename `pack_opts` here to just
`opts`. It's not even used anyways.
All the other trivial renames in this patch look good.
-Justin
^ permalink raw reply [flat|nested] 14+ messages in thread* Re: [PATCH 3/4] refs: rename 'pack_refs_opts' to 'refs_optimize_opts'
2025-10-15 22:18 ` Justin Tobler
@ 2025-10-16 12:15 ` Karthik Nayak
0 siblings, 0 replies; 14+ messages in thread
From: Karthik Nayak @ 2025-10-16 12:15 UTC (permalink / raw)
To: Justin Tobler; +Cc: git, ps
[-- Attachment #1: Type: text/plain, Size: 5194 bytes --]
Justin Tobler <jltobler@gmail.com> writes:
> On 25/10/15 11:25PM, Karthik Nayak wrote:
>> The previous commit removed all references to 'pack_refs()' within
>> the refs subsystem. Continue this cleanup by also renaming
>> 'pack_refs_opts' to 'refs_optimize_opts' and the respective flags
>> accordingly. Keeping the naming consistent will make the code easier to
>> maintain.
>>
>> Signed-off-by: Karthik Nayak <karthik.188@gmail.com>
>> ---
>> pack-refs.c | 8 ++++----
>> refs.c | 2 +-
>> refs.h | 16 ++++++++--------
>> refs/debug.c | 2 +-
>> refs/files-backend.c | 10 +++++-----
>> refs/packed-backend.c | 2 +-
>> refs/refs-internal.h | 2 +-
>> refs/reftable-backend.c | 4 ++--
>> 8 files changed, 23 insertions(+), 23 deletions(-)
>>
>> diff --git a/pack-refs.c b/pack-refs.c
>> index 1a5e07d8b8..d0ffed93c1 100644
>> --- a/pack-refs.c
>> +++ b/pack-refs.c
>> @@ -14,10 +14,10 @@ int pack_refs_core(int argc,
>> {
>> struct ref_exclusions excludes = REF_EXCLUSIONS_INIT;
>> struct string_list included_refs = STRING_LIST_INIT_NODUP;
>> - struct pack_refs_opts pack_refs_opts = {
>> + struct refs_optimize_opts pack_refs_opts = {
>
> We could rename the variable name here to, but probably not a big deal
> either way.
>
Since I'm re-rolling, let me do that :)
>> .exclusions = &excludes,
>> .includes = &included_refs,
>> - .flags = PACK_REFS_PRUNE,
>> + .flags = REFS_OPTIMIZE_PRUNE,
>> };
>> struct string_list option_excluded_refs = STRING_LIST_INIT_NODUP;
>> struct string_list_item *item;
>> @@ -26,8 +26,8 @@ int pack_refs_core(int argc,
>>
>> struct option opts[] = {
>> OPT_BOOL(0, "all", &pack_all, N_("pack everything")),
>> - OPT_BIT(0, "prune", &pack_refs_opts.flags, N_("prune loose refs (default)"), PACK_REFS_PRUNE),
>> - OPT_BIT(0, "auto", &pack_refs_opts.flags, N_("auto-pack refs as needed"), PACK_REFS_AUTO),
>> + OPT_BIT(0, "prune", &pack_refs_opts.flags, N_("prune loose refs (default)"), REFS_OPTIMIZE_PRUNE),
>> + OPT_BIT(0, "auto", &pack_refs_opts.flags, N_("auto-pack refs as needed"), REFS_OPTIMIZE_AUTO),
>> OPT_STRING_LIST(0, "include", pack_refs_opts.includes, N_("pattern"),
>> N_("references to include")),
>> OPT_STRING_LIST(0, "exclude", &option_excluded_refs, N_("pattern"),
>> diff --git a/refs.c b/refs.c
>> index b9a4a60646..0d0831f29b 100644
>> --- a/refs.c
>> +++ b/refs.c
>> @@ -2313,7 +2313,7 @@ void base_ref_store_init(struct ref_store *refs, struct repository *repo,
>> refs->gitdir = xstrdup(path);
>> }
>>
>> -int refs_optimize(struct ref_store *refs, struct pack_refs_opts *opts)
>> +int refs_optimize(struct ref_store *refs, struct refs_optimize_opts *opts)
>> {
>> return refs->be->optimize(refs, opts);
>> }
>> diff --git a/refs.h b/refs.h
>> index 04e917fec0..d2630af97f 100644
>> --- a/refs.h
>> +++ b/refs.h
>> @@ -500,15 +500,15 @@ void refs_warn_dangling_symrefs(struct ref_store *refs, FILE *fp,
>>
>> /*
>> * Flags for controlling behaviour of refs_optimize()
>> - * PACK_REFS_PRUNE: Prune loose refs after packing
>> - * PACK_REFS_AUTO: Pack refs on a best effort basis. The heuristics and end
>> - * result are decided by the ref backend. Backends may ignore
>> - * this flag and fall back to a normal repack.
>> + * REFS_OPTIMIZE_PRUNE: Prune loose refs after packing
>> + * REFS_OPTIMIZE_AUTO: Pack refs on a best effort basis. The heuristics and end
>> + * result are decided by the ref backend. Backends may ignore
>> + * this flag and fall back to a normal repack.
>> */
>> -#define PACK_REFS_PRUNE (1 << 0)
>> -#define PACK_REFS_AUTO (1 << 1)
>> +#define REFS_OPTIMIZE_PRUNE (1 << 0)
>> +#define REFS_OPTIMIZE_AUTO (1 << 1)
>>
>> -struct pack_refs_opts {
>> +struct refs_optimize_opts {
>> unsigned int flags;
>> struct ref_exclusions *exclusions;
>> struct string_list *includes;
>> @@ -518,7 +518,7 @@ struct pack_refs_opts {
>> * Optimize the ref store. The exact behavior is up to the backend.
>> * For the files backend, this is equivalent to packing refs.
>> */
>> -int refs_optimize(struct ref_store *refs, struct pack_refs_opts *opts);
>> +int refs_optimize(struct ref_store *refs, struct refs_optimize_opts *opts);
>
> I noticed when poking around the code that the optimize callback was
> still using the `pack_refs_opts`. Nice to see this clean up. :)
>
>> /*
>> * Setup reflog before using. Fill in err and return -1 on failure.
> [snip]
>> diff --git a/refs/packed-backend.c b/refs/packed-backend.c
>> index 20cf9fab18..0aa0ff6701 100644
>> --- a/refs/packed-backend.c
>> +++ b/refs/packed-backend.c
>> @@ -1774,7 +1774,7 @@ static int packed_transaction_finish(struct ref_store *ref_store,
>> }
>>
>> static int packed_optimize(struct ref_store *ref_store UNUSED,
>> - struct pack_refs_opts *pack_opts UNUSED)
>> + struct refs_optimize_opts *pack_opts UNUSED)
>
> Also not a big deal, but we could rename `pack_opts` here to just
> `opts`. It's not even used anyways.
>
> All the other trivial renames in this patch look good.
>
> -Justin
>
Will do,
Thanks for the review.
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 690 bytes --]
^ permalink raw reply [flat|nested] 14+ messages in thread
* [PATCH 4/4] t/pack-refs-tests: move the 'test_done' to callees
2025-10-15 21:25 [PATCH 0/4] refs: cleanup code around optimizations Karthik Nayak
` (2 preceding siblings ...)
2025-10-15 21:25 ` [PATCH 3/4] refs: rename 'pack_refs_opts' to 'refs_optimize_opts' Karthik Nayak
@ 2025-10-15 21:25 ` Karthik Nayak
2025-10-16 10:38 ` [PATCH 0/4] refs: cleanup code around optimizations Patrick Steinhardt
4 siblings, 0 replies; 14+ messages in thread
From: Karthik Nayak @ 2025-10-15 21:25 UTC (permalink / raw)
To: git; +Cc: Karthik Nayak, ps, jltobler
In ac0bad0af4 (t0601: refactor tests to be shareable, 2025-09-19), we
refactored 't/t0601-reffiles-pack-refs.sh' to move all of the tests to
't/pack-refs-tests.sh', which became a common test suite which was also
used by 't/t1463-refs-optimize.sh'.
This also moved the 'test_done' directive to 't/pack-refs-tests.sh'.
Which inhibits additional tests from being added to either of the tests.
Let's move the directive out to both the tests, so that we can add
additional specific tests to them. Also the test flow logic shouldn't be
part of tests which can be embedded in other test scripts.
Signed-off-by: Karthik Nayak <karthik.188@gmail.com>
---
t/pack-refs-tests.sh | 2 --
t/t0601-reffiles-pack-refs.sh | 2 ++
t/t1463-refs-optimize.sh | 2 ++
3 files changed, 4 insertions(+), 2 deletions(-)
diff --git a/t/pack-refs-tests.sh b/t/pack-refs-tests.sh
index 095823d915..81086c3690 100644
--- a/t/pack-refs-tests.sh
+++ b/t/pack-refs-tests.sh
@@ -459,5 +459,3 @@ test_expect_success 'pack-refs does not store invalid peeled tag value' '
test_grep ! "^\^" .git/packed-refs
)
'
-
-test_done
diff --git a/t/t0601-reffiles-pack-refs.sh b/t/t0601-reffiles-pack-refs.sh
index 12cf5d1dcb..3c706978ef 100755
--- a/t/t0601-reffiles-pack-refs.sh
+++ b/t/t0601-reffiles-pack-refs.sh
@@ -18,3 +18,5 @@ export GIT_TEST_DEFAULT_REF_FORMAT
. ./test-lib.sh
. "$TEST_DIRECTORY"/pack-refs-tests.sh
+
+test_done
diff --git a/t/t1463-refs-optimize.sh b/t/t1463-refs-optimize.sh
index c11c905d79..9afe3c1ed7 100755
--- a/t/t1463-refs-optimize.sh
+++ b/t/t1463-refs-optimize.sh
@@ -15,3 +15,5 @@ export GIT_TEST_DEFAULT_REF_FORMAT
pack_refs='refs optimize'
. "$TEST_DIRECTORY"/pack-refs-tests.sh
+
+test_done
--
2.51.0
^ permalink raw reply related [flat|nested] 14+ messages in thread* Re: [PATCH 0/4] refs: cleanup code around optimizations
2025-10-15 21:25 [PATCH 0/4] refs: cleanup code around optimizations Karthik Nayak
` (3 preceding siblings ...)
2025-10-15 21:25 ` [PATCH 4/4] t/pack-refs-tests: move the 'test_done' to callees Karthik Nayak
@ 2025-10-16 10:38 ` Patrick Steinhardt
4 siblings, 0 replies; 14+ messages in thread
From: Patrick Steinhardt @ 2025-10-16 10:38 UTC (permalink / raw)
To: Karthik Nayak; +Cc: git, jltobler
On Wed, Oct 15, 2025 at 11:25:05PM +0200, Karthik Nayak wrote:
> This is extracted from a recent series I sent [1], which I've since
> dropped to follow up with a different approach. I think these patches
> hold value individually.
>
> They mostly cleanup code around 'git refs optimize' which was added
> recently in db0babf9b2 (Merge branch 'ms/refs-optimize', 2025-10-02).
> The code in the refs subsystem contains both 'pack-refs' and 'optimize'
> functions, which are one and the same.
>
> This series unifies this to only retain the 'optimize' functions and
> naming, since it backend generic.
>
> This is based on top of master 143f58ef75 (Sync with Git 2.51.1,
> 2025-10-15) with 'ps/ref-peeled-tags' merged in.
Thanks, these patches all look good to me, except for the small nits
that Justin has spotted. I guess this can use one more tiny reroll
before it's ready to be merged.
Patrick
^ permalink raw reply [flat|nested] 14+ messages in thread