Submodulizer

Convert messy repos with copied-in files from other repos into a submodulized repo.

Usage

1. Clone the messy repo, separate from any other instances.
2. Create a plugin manifest file.
3. Run submodulize.sh <PATH>
4. Do all your work on the submodulized branch or a descendent of it

If there are changes to the submodules and you want to update the superproject

1. Run unsubmodulize.sh <PATH>
2. Push the unsubmodulized branch upstream

If there are changes to the superproject and you want to update the submodulized repo

1. Fetch the master branch or whatever branch submodulize branched from
2. Run submodulize.sh <PATH>

Plugin Manifest Files

Plain text at the Moodle root in the file plugin-submodules.manifest. One plugin per line.

relative_path|clone_url|branch [| sparse_paths [| in_repo_tree_path]]

Example (one repo per path): mod/hvp|https://github.com/h5p/moodle-mod_hvp.git|main

Example (monorepo — same URL on two lines, each with sparse paths):

local/kaltura_assign|https://github.com/kaltura/moodle_plugin.git|main|mod/kalvidassign
filter/kaltura|https://github.com/kaltura/moodle_plugin.git|main|filter/kaltura