Skip to content

Support remote git repository as template source #1401

Open
#1404
Open
Support remote git repository as template source#1401
#1404
Labels
featureA new feature or a feature requesthelp-wantedExtra attention is required

Description

@bilelomrani1
bilelomrani1
opened on Dec 30, 2025

Feature Request

Description

Allow template_dir to reference a remote git repository instead of only local filesystem paths.

Use cases

  • Share changelog templates across multiple projects without copy-paste
  • Enable an ecosystem of reusable changelog template repositories
  • Simplify CI workflows by removing manual template download steps

Possible implementation

Support a git URL syntax:

[tool.semantic_release.changelog]
template_dir = "git+https://github.com/user/[email protected]#templates"

Or explicit configuration:

[tool.semantic_release.changelog.template_source]
repo = "https://github.com/user/changelog-templates.git"
ref = "v1.0.0"  # tag, branch, or commit
path = "templates"  # subdirectory within repo

Using fsspec with its git backend would abstract the storage layer, and support private repositories.

Alternative solutions

  • Download templates in CI before running semantic-release: Works but adds boilerplate to every project's workflow
  • Git submodules: Adds unnecessary complexity for simple template sharing

Activity

  1. bilelomrani1
    added
    featureA new feature or a feature request
    triagewaiting for initial maintainer review
    on Dec 30, 2025
  2. codejedi365
    added
    help-wantedExtra attention is required
    and removed
    triagewaiting for initial maintainer review
    on Dec 30, 2025
  3. bilelomrani1
    closed this as completedin bilelomrani1/python-semantic-release#2on Jan 2, 2026
  4. codejedi365
    reopened this on Jan 2, 2026

  5. bilelomrani1 commented on Jan 2, 2026

    @bilelomrani1
    bilelomrani1
    on Jan 2, 2026
    Author

    Sorry, did not mean to close this, I'm merging multiple branches in my fork for some tests combining multiple features, and this accidentally closed this corresponding issues.

  6. codejedi365 commented on Jan 2, 2026

    @codejedi365
    codejedi365
    on Jan 2, 2026
    Contributor

    I know, GitHub should not of allowed a closure of an issue on the main repo when merged to master of a fork. Will be reporting that bug to GitHub

  7. afuetterer commented on May 19, 2026

    @afuetterer
    afuetterer
    on May 19, 2026
    Contributor

    I would like to see this feature added. Having to copy custom templates to each project feels wrong. This would be a very welcome way to avoid copying.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    featureA new feature or a feature requesthelp-wantedExtra attention is required

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions