planetarium/Submodule Updater
Keep up to date with your submodules
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stalelast commit Feb 21, 2024
- License
- GPL 3.0
Pinned Snippet
uses: planetarium/submodule-updater@cd21428bdc3fc77ac6d8e15cc6cf5c948da0ae73 # no releases — HEAD as of 2026-07-11tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| token | an access token to be used to fork, clone, push, and open PRs | yes | — |
| source-repository | the dependent repository to be referred as submodules by other repositories (e.g., org/repo-name) | yes | ${{ github.repository }} |
| ref | submodule heads in the dependent repositories will become to refer to to this (e.g., refs/tags/1.2.3, refs/heads/master) | yes | ${{ github.ref }} |
| committer | name and email address to be signed with on the commit (e.g., Your Name <email@example.com>) | yes | — |
| targets | space-separated list of the dependent repositories with their branch names that need to update their submodules referring the source repository (e.g., org/repo-name:branch org/foo:main org/bar:master) | yes | — |
| pr-title | the title template for pull requests to be opened. it can consist of several variables like {submodule_repository.name}. see also docs for details | yes | Update {submodule_repository.name} to {submodule_ref_name} |
| pr-description | the description template for pull requests to be opened. it can consist of several variables like {submodule_repository.name}. see also docs for details | yes | *This pull request was automatically generated by Submodule Updater.* It updates the submodule referring to [*{submodule_repository.name}*]({submodule_repository.html_url}) to {submodule_ref_type} *{submodule_ref_name}* ({submodule_repository.full_name}@{submodule_commit.sha}). |
| dry-run | don't run the actual process. internally used for testing the action in itself | — | false |
Outputs
no outputs