Skip to content

fix(forge): init a git repo at root during init unless explicitely stated #9695

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: master
Choose a base branch
from

Conversation

0xvv
Copy link
Contributor

@0xvv 0xvv commented Jan 16, 2025

Motivation

Fixes: #3962

Solution

Force initialization of a git repo at the root of the foundry folder unless there already is one or the flag --use-parent-git is present and there is indeed a parent git repo.

The --use-parent-git flag replicates the current behavior in case some people prefer it.

Tested the reproductions steps of the issue after to be sure.
The fix in forge init leads to the expected behavior for forge install

@0xvv 0xvv force-pushed the fix-git-submodules branch 2 times, most recently from 4f7dba2 to 739b81a Compare January 17, 2025 00:17
@0xvv 0xvv force-pushed the fix-git-submodules branch from 739b81a to 19cd229 Compare January 17, 2025 00:32
@0xvv 0xvv marked this pull request as ready for review January 17, 2025 00:34
@grandizzy
Copy link
Collaborator

I am not sure I like the way git submodules is desired to be used in #3962 (could become beefy and hard to maintain) but rather have different projects / deps with their own foundry.toml file and submodules. @zerosnacks @yash-atreya wdyt?

@grandizzy grandizzy added T-bug Type: bug C-forge Command: forge labels Jan 23, 2025
@zerosnacks
Copy link
Member

I'm supportive of this change, I too would expect that when I run forge install in a subdirectory it should create a .gitmodules there rather than at the top level.

Only suggestion I would have is changing the flag name to --in-root to as parent does not apply when you have second level nesting of directories

cc @yash-atreya do you see any issues on how this may interfere with your recent PRs?

@jenpaff jenpaff added this to the v1.1.0 milestone Mar 25, 2025
@jenpaff jenpaff moved this to Ready For Review in Foundry Mar 25, 2025
Comment on lines +540 to +550
// submodules are registered at root
let gitmodules = root.join(".gitmodules");
let gitmodules = fs::read_to_string(gitmodules).unwrap();
assert!(gitmodules.contains(
"
path = foundry-folder/lib/forge-std
url = https://github.com/foundry-rs/forge-std
"
));
});

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@0xvv

I'm not sure how this fixes #3962 since the top-level .gitmodules file is still being modified even though you've created a subfolder in which the project resides, i.e., the foundry folder.

The core issue here concerns how git submodules work and how .gitmodules must always be at the git root. Not sure if this is feasible since it would break git submodule command that keeps the .gitmodules file updated and always assumes it's at the root-level.

See: https://git-scm.com/docs/gitsubmodules and https://git-scm.com/docs/gitmodules.

Maybe I'm missing something.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@0xvv did you get the chance to take a look at this? ^^

Copy link
Contributor Author

@0xvv 0xvv Apr 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@yash-atreya I think I don't understand your point.
I changed the default behavior to not modify the parent .gitmodules, which is the behavior in other comparable tools and fixes #3962. The .gitmodules thus resides at the root of the newly created forge repo with the new dependencies as expected even if already contained in a git repository. The newly created forge repo can then become a module of the parent git repo.

And I added the option to use an existing parent repo and .gitmodules if we are already in a git repository. Again the modules are declared at the root of the repository that contains the forge, it's just n levels above the forge folder. This is the existing behavior which I think we should move away from as a more modular approach seems better suited to me here but I left it as an option for flexibility and legacy behavior support.

I don't think this would prevent anything regarding submodules management because either way you would be at the root of the git repository.

Let me know if I'm missing anything

@jenpaff jenpaff assigned 0xvv and unassigned yash-atreya Apr 9, 2025
@jenpaff
Copy link
Collaborator

jenpaff commented Apr 9, 2025

@0xvv bump on the previous comment, please flag if you're stuck or need any support from us.

@jenpaff jenpaff modified the milestones: v1.1.0, v1.2.0 Apr 15, 2025
@jenpaff jenpaff modified the milestones: v1.2.0, v1.3.0 May 5, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
C-forge Command: forge T-bug Type: bug
Projects
Status: Ready For Review
Development

Successfully merging this pull request may close these issues.

forge install modifies top-level .gitmodules in existing project repo instead of where foundry.toml lives
5 participants