Git Submodules and Their Applications in Sharing Shared Resources

Git Submodules and Their Applications in Sharing Shared Resources

Daily short news for you
  • These past few days, I've been redesigning the interface for the note-taking app OpenNotas. It's quite strange to think about why I chose DaisyUI back then 😩

    » Read more
  • Previously, there was a mention of openai/codex - a type of agent that runs conveniently in the Terminal from OpenAI, especially since it is open source and they have now added support for other providers instead of just using the chatgpt model as before.

    Recently, Anthropic also introduced Claude Code which is quite similar to Codex, except it is not open source and you are required to use their API. Since I don't have money to experiment, I've only heard that people in the programming community praise it a lot, and it might even be better than Cursor. On the flip side, there's the risk of burning a hole in your wallet at any moment 😨

    » Read more
  • For a long time, I have been thinking about how to increase brand presence, as well as users for the blog. After much contemplation, it seems the only way is to share on social media or hope they seek it out, until...

    Wearing this shirt means no more worries about traffic jams, the more crowded it gets, the more fun it is because hundreds of eyes are watching 🤓

    (It really works, you know 🤭)

    » Read more

Issue

Integrated or created package managers used in programming languages are an effective way for us to reuse shared code. For example, in JavaScript/Node.js, there is npm with millions of packages shared by many programmers worldwide. Whenever we need something, what we usually do first is to look for a package that meets our needs to reduce software development time.

Sharing packages that anyone can search for and use may not always be suitable in some cases. For example, we create utility functions only for use in our company's internal projects or for personal use without sharing with anyone else. Although many package managers provide features to "publish" packages for internal use, there are still certain limitations such as costs and deployment time...

In git, there is a feature called submodule that can help us solve cases where we need to share folders or files with each other in repositories, so we don't have to spend a lot of effort to share utility code between projects. The details of how to do this are explained in the article below.

What Is Git Submodule?

Git Submodule is a powerful feature in Git that allows you to add and manage other repositories within your repository. It provides a way to easily integrate and track external source code dependencies.

Basically, a submodule is a Git repository embedded in another Git repository. It acts as a pointer to a specific commit in an external repository. By using submodules, you can add and use external source code libraries, frameworks, or any other projects as part of your project.

The simplest way to understand how submodules work is to share common code in different projects. For example, you create a repository that contains only files with utility functions (utils), and then you want to use them in another project. You can simply create a directory linked to the utility repository.

git submodules work

Utilizing submodules provides us with many conveniences in collaboration and code reuse because submodules are also Git repositories, so they can be further developed with features, bug fixes, maintenance, etc., like regular projects. When you want to receive changes, you only need to pull the submodule to get the latest code. You can even participate in developing submodules directly within the project linked to them by accessing the submodule directory and committing as usual.

Applications in Sharing Shared Resources

Suppose we are in project directory A and want to add submodule B with URL: https://github.com/2coffee/awesomelibrary.

Add a submodule using the add command:

$ git submodule add https://github.com/2coffee/awesomelibrary

Check what the command just did:

$ git status

On branch main

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)

 new file:   .gitmodules
 new file:   awesomelibrary

Git reports that 2 new files have been added, which contain references to the linked submodule.

Try opening the .gitmodules file, and you will see the content looks like this:

[submodule "awesomelibrary"]
 path = awesomelibrary
 url = https://github.com/2coffee/awesomelibrary

Now you can check the awesomelibrary directory and use the code in it as if it belongs to the project.

Conclusion

In addition to copying or packaging code for use in another internal project, we also have another way to use Git submodules. It's simply linking another Git project to a directory in the current project, so we can easily receive the latest changes from it without having to go through many steps.

References:

Premium
Hello

5 profound lessons

Every product comes with stories. The success of others is an inspiration for many to follow. 5 lessons learned have changed me forever. How about you? Click now!

Every product comes with stories. The success of others is an inspiration for many to follow. 5 lessons learned have changed me forever. How about you? Click now!

View all

Subscribe to receive new article notifications

or
* The summary newsletter is sent every 1-2 weeks, cancel anytime.

Comments (2)

Leave a comment...
Avatar
Trịnh Cường2 years ago

quá muộn rồi bạn ạ, giờ làm cái mới thì dùng, chứ giờ src phình to quá ko refactor lại đc nữa

Reply
Avatar
Xuân Hoài Tống2 years ago

Vậy thì phải để dành cho dự án sau rồi ạ

Avatar
Trịnh Cường2 years ago

hay đấy bạn ơi, giờ mình mới biết. trước giờ toàn npm publish để làm src dùng chung

Reply
Avatar
Xuân Hoài Tống2 years ago

Giờ thì bạn có thể sử dụng git submodules để làm điều đó rồi :D