Package: github-changelog-md
Markdown Changelog GeneratorGenerate a Markdown changelog from a Github repository.This project will generate a Markdown-formatted changelog from a Github
repository. It will detect all GitHub releases and generate a changelog based on
themergedPull Requests for each release along with a section forunreleasedPRs (those since the last release) at the top. It will also
include a list of all Issues closed for each release.The PRs and issues are grouped by type (bug, enhancement, etc.) and sorted by
latest to oldest in this release.For an example of the output, see theCHANGELOGfor this project.Full documentation is available at:https://changelog.seapagan.netInstall Locally for a projectInstall GloballySetup a GitHub PATPAT PermissionsCreate a config fileAdd the config file to your .gitignoreDevelopment setupLicenseCreditsIt is possible to install this package both locally within your projects and
globally so it can be used in every project. You also need to generate a GitHub
Personal Access Token (PAT) to use this tool or use an existing one. This should
be stored in a config file.github-changelog-md.tomlin the directory you run
the tool from.Install Locally for a projectChange to your project directory and install the package using your preferred
package manager or plainpip.I'd recommend usingPoetryfor managing your
project dependencies if you don't already have a preference:$poetryaddgithub-changelog-md--groupdevor$pipinstallgithub-changelog-mdInstall GloballyYou could also install the package globally if you want to use it in every
project. See theDocumentationfor more information.Setup a GitHub PATSince this tool uses the GitHub API, you will need to create aPersonal Access
Token(PAT) to use this tool without being
rate limited. You can create a PAT with thereposcope to access private
repositories, or just leave all the scopes unchecked to only access public
repositories. Generate a 'classic' token unless you need more fine-grained
control over the permissions.Choose a descriptive name for your token, such asgithub-changelog-md, an
expiry time (or choose to not have it expire at all) and copy the token to your
clipboard.PAT PermissionsAt this time the tool does not require any special permissions, but in the
future we plan to offer the ability to create an actual release from the command
line. To do this, the PAT will need either thepublic_reposcope (you only
plan to use this on public repositories) or thereposcope (you also plan to
use this on private repositories).Create a config fileThis tool will look for a config file.changelog-generator.tomlin the
location it is run from. The config file is a simpleTOMLfile with the following format:[changelog_generator]schema_version=1github_pat="your_github_pat"The easiest way to create this is run the app, you will be prompted for the
PAT and the config file will be created for you in the current folder then the
app will continue.$github-changelog-mdThis is only the barestminimumusable configuration! There are many more
options
available, see theConfigurationsection in the documentation for a full list of the many available options.Add the config file to your .gitignoreMake sure you add the config file to your.gitignorefile so you don't
accidentally commit your PAT to your repository. If this does happen, GitHub
will automatically revoke the PAT and you will need to create a new one anyway,
but there is a small chance someone could use it to access your repositories.Development setupInstall the dependencies using Poetry:$poetryinstallThen, activate the virtual environment:$poetryshellIf you don't want to use Poetry, you can create a virtual environment yourself
then install the dependencies using pip:$pipinstall-rrequirements-dev.txtNote however that Poetry will be installed anyway as a dependency of the
project, so you may as well take the time to learn and use it! :grin:See theContributingsection in
the documentation for more information on how to contribute to this project.LicenseThis project is released under the terms of theMIT license.CreditsThis generator puts a small unobtrusive comment at the bottom of the changelog
to indicate that it was generated by this tool. This is to acknowledge the work
of the contributors and to help spread the word about this project. Please leave
this comment in place for others :pray:.If you use this tool and like it, please consider giving it a :star: on Github,
which helps others find it. Thanks!If you find this tool is useful, please considersponsoringthe developer . All sponsors
will be listed on the documentation and README. All contributions are greatly
appreciated and will be directly used to support and improve the project.The original Python boilerplate for this package was created using myPymakertool.