GitHubReleaser

Simple way to automatically create GitHub releases with changelog and attachments out of issues & milestones.

Functions

Creates a release with the version of a DLL or EXE file, e.g. 1.2.3.4. The last version part is the build number.

GitHubReleaser searches for a milestone without the build number e.g. 1.2.3. All issues in the milestone would be printed in the release changelog. You can also define which label should be in or filter some single issues out.

You can also attach files to the release e.g. ZIP-File with your binaries.
If the release is a pre-release, all closed issues of the milestone are collected since last release (date). If the release is NOT a pre-release, all issues of the milestone are collected (summary).

You can also update a release (changelog & attachments).

Usage

Get a API-Token for your GitHub-User here. We need the scope repo.

Execute GitHubRelease via command line arguments:

GitHubReleaser.exe /github-repo:"MyUsername/MyRepo" /github-token:"5578d3a8e0ed1c524e3c8c832e1533d79b16ad3c" /file-for-version:"C:\test\MyDllOrExe.dll" /pre-release:"false" /issue-labels:"bug;Bug" "feature;Feature" /issue-filter-label:"not-in-changelog" /release-attachments:"C:\test\MyDllOrExe1.zip" "C:\test\MyDllOrExe2.zip" /create-changelog-file:"false"

Or open config file with GitHubRelease:

GitHubReleaser.exe "C:\test\MySettings.json"

Combining config file with commandline arguments is not supported yet.

Parameter

| Name | Example | Required | | --------------------------- | ----------------------------------------------------- | -------- | | github-repo | MyUsername/MyRepo | ✅ | | github-token | 5578d3a8e0ed1c524e3c8c832e1533d79b16ad3c | ✅ | | file-for-version | "C:\test\MyDllOrExe.dll" | ✅ | | pre-release | false | | | issue-labels | "bug;Bug" "feature;Feature" | | | issue-filter-label | not-in-changelog | | | release-attachments | "C:\test\MyDllOrExe1.zip" "C:\test\MyDllOrExe2.zip" | | | update-only | false | | | create-changelog-file | false | | | draft | false | | | delete-files-after-upload | false | |

Config file example

{
  "IsChangelogFileCreationEnabled": false,
  "IsUpdateOnly": true,
  "ReleaseAttachments": [ "C:\\test\\MyDllOrExe1.zip", "C:\\test\\MyDllOrExe2.zip" ],
  "IssueFilterLabel": "not-in-changelog",
  "IssueLabels": {
    "bug": "Bug", 
    "feature": "Feature"
  },
  "IsPreRelease": false,
  "IsDraft": false,
  "DeleteFilesAfterUpload": false,
  "FileForVersion": "C:\\test\\MyDllOrExe.dll",
  "GitHubToken": "_5578d3a8e0ed1c524e3c8c832e1533d79b16ad3c_",
  "GitHubRepo": "MyUsername/MyRepo"
}

Build

For debugging you can add a Secrets.cs to the folder Model:

For testing we use Smart Command Line Arguments Visual Studio extension.
With a test milestone and some test issues you can simple run throw the steps:

Contributing

Feel free to make a pull-request 🦄 Or simple make an issue for a bug report or feature request 💖

Thanks to Daniel Papp for being a first class contributer.