threads / discuss / 36152

Proposal: Write git subtree info to .git/config

Subject: Proposal: Write git subtree info to .git/config

## tl;dr

4 messages between Mar 13, 2014 and Mar 14, 2014.

replies: 3people: 2as markdown or json

John Butterfield· Mar 13, 2014, 23:18 UTC · lore
Has there been any talk about adding a stub for git subtrees in .git/config?
The primary benefits would be:
1. Determine what sub directories of the project were at one time
pulled from another repo (where from and which commit id), without
having to attempt to infer this by scanning the log.
2. Simplify command syntax by providing a predictable default (ie.
last pulled from, last pushed to), and not requiring the repo argument
optional.
3. Improvement for default commit id to start split operations over
using --rejoin which creates blank log entries just so the log scan
can find it (afaict). It's a default either way, so it can still
always be explicitly specified.

If this information were available in the config, I think additional features could be added as well:

- The command 'git subtree pull' for instance could be made to pull
*all* subtrees, similar to the way 'git submodule update' works.
- An option -i (interactive), or -p (prompt), etc. could be added that
confirms the defaults read from the config before actually executing
the command with implicit arguments, and the ability to modify the
arguments before the command actually executes.
- If the current working directory from which the command is run
happens to be a subtree specified in the config, the --prefix could
even be implied.

None of these ideas would break the way the command currently works since it can still always take explicit arguments. There's a comment in the documentation about the command that says:

> Unlike submodules, subtrees do not need any special constructions (like .gitmodule files or gitlinks) be present in your repository

It would still be true that subtrees do not *need* any special config settings, but that doesn't mean they are bad, and by having them the command could be improved and made easier to use.

I'm happy to contribute the changes myself if this proposal is acceptable.
Junio C Hamano· Mar 13, 2014, 23:36 UTC · re: John Butterfield · lore

Re: Proposal: Write git subtree info to .git/config

John Butterfield <johnb003@gmail.com> writes:
> Has there been any talk about adding a stub for git subtrees in .git/config?
I do not think so, and that is probably for a good reason.

A subtree biding can change over time, but .git/config is about recording information that do not change depending on what tree you are looking at, so there is an impedance mismatch---storing that information in .git/config is probably a wrong way to go about it.

It might help to keep track of "In this tree, the tip of that other history is bound as a subtree at this path", which means that information more naturally belongs to each tree, I would think.

John Butterfield· Mar 14, 2014, 00:43 UTC · re: Junio C Hamano · lore

Re: Proposal: Write git subtree info to .git/config

> A subtree biding can change over time, but .git/config is about

recording information that do not change depending on what tree you are looking at, so there is an impedance mismatch---storing that information in .git/config is probably a wrong way to go about it.

I see. How about a .gitsubtrees config file in the root of a project?
> It might help to keep track of "In this tree, the tip of that other

history is bound as a subtree at this path", which means that information more naturally belongs to each tree, I would think.

Anything in the subdirectory must be part of the contents of the subtree repo. It should not know how it is linked to it's parent project; parents should know how their children are fetched. Therefore it cannot live in the subtree.

Subtrees could be nested. So, should the config be in the root of the parent subtree? This makes sense to me.

Example:
/
  A/
  B/    # a subtree of (blah)
    X/
    Y/  # a subtree of (yada-yada)
    Z/

So, lets say B has many updates remotely, including pushing and pulling changes to Y.

When pulling the changes from B, it would be convenient for it to come with the meta data, (subtree repo and commit info) for Y.

So how does that sound; Could we store subtree repo and commit id references per folder in a .gitsubtrees file in the root of every project?

(Project B is technically it's own project so it would pull it's own .gitsubtrees in /B/.gitsubtrees)

`John
On Thu, Mar 13, 2014 at 4:36 PM, Junio C Hamano <gitster@pobox.com> wrote:
Show 14 quoted lines
> John Butterfield <johnb003@gmail.com> writes:
>
>> Has there been any talk about adding a stub for git subtrees in .git/config?
>
> I do not think so, and that is probably for a good reason.
>
> A subtree biding can change over time, but .git/config is about
> recording information that do not change depending on what tree you
> are looking at, so there is an impedance mismatch---storing that
> information in .git/config is probably a wrong way to go about it.
>
> It might help to keep track of "In this tree, the tip of that other
> history is bound as a subtree at this path", which means that
> information more naturally belongs to each tree, I would think.
John Butterfield· Mar 14, 2014, 00:46 UTC · re: John Butterfield · lore

Re: Proposal: Write git subtree info to .git/config

by "per folder" I meant, "for each subtree"
On Thu, Mar 13, 2014 at 5:43 PM, John Butterfield <johnb003@gmail.com> wrote:
Show 58 quoted lines
>> A subtree biding can change over time, but .git/config is about
> recording information that do not change depending on what tree you
> are looking at, so there is an impedance mismatch---storing that
> information in .git/config is probably a wrong way to go about it.
>
> I see. How about a .gitsubtrees config file in the root of a project?
>
>> It might help to keep track of "In this tree, the tip of that other
> history is bound as a subtree at this path", which means that
> information more naturally belongs to each tree, I would think.
>
> Anything in the subdirectory must be part of the contents of the
> subtree repo. It should not know how it is linked to it's parent
> project; parents should know how their children are fetched. Therefore
> it cannot live in the subtree.
>
> Subtrees could be nested. So, should the config be in the root of the
> parent subtree? This makes sense to me.
>
> Example:
>
> /
>   A/
>   B/    # a subtree of (blah)
>     X/
>     Y/  # a subtree of (yada-yada)
>     Z/
>
> So, lets say B has many updates remotely, including pushing and
> pulling changes to Y.
>
> When pulling the changes from B, it would be convenient for it to come
> with the meta data, (subtree repo and commit info) for Y.
>
> So how does that sound; Could we store subtree repo and commit id
> references per folder in a .gitsubtrees file in the root of every
> project?
>
> (Project B is technically it's own project so it would pull it's own
> .gitsubtrees in /B/.gitsubtrees)
>
> `John
>
> On Thu, Mar 13, 2014 at 4:36 PM, Junio C Hamano <gitster@pobox.com> wrote:
>> John Butterfield <johnb003@gmail.com> writes:
>>
>>> Has there been any talk about adding a stub for git subtrees in .git/config?
>>
>> I do not think so, and that is probably for a good reason.
>>
>> A subtree biding can change over time, but .git/config is about
>> recording information that do not change depending on what tree you
>> are looking at, so there is an impedance mismatch---storing that
>> information in .git/config is probably a wrong way to go about it.
>>
>> It might help to keep track of "In this tree, the tip of that other
>> history is bound as a subtree at this path", which means that
>> information more naturally belongs to each tree, I would think.

← back to recent threads