{"id":23790,"library":"gitchangelog","title":"gitchangelog","description":"gitchangelog generates a changelog from git log messages. It uses a configurable template system to produce release notes. Latest version: 3.0.4. Release cadence: irregular.","status":"active","version":"3.0.4","language":"python","source_language":"en","source_url":"http://github.com/vaab/gitchangelog","tags":["git","changelog","release-notes"],"install":[{"cmd":"pip install gitchangelog","lang":"bash","label":"Install with pip"}],"dependencies":[],"imports":[{"note":"gitchangelog is a script; importing the module directly calls main. Correct import is for programmatic use.","wrong":"import gitchangelog","symbol":"main","correct":"from gitchangelog import main"}],"quickstart":{"code":"# Generate changelog from git log\nfrom gitchangelog import main\nimport sys\nsys.argv = ['gitchangelog']\nmain()","lang":"python","description":"Generates a changelog by reading git log and outputting to stdout. Works only in a git repository."},"warnings":[{"fix":"Update .gitchangelog.rc to use Mako syntax. See migration guide at https://github.com/vaab/gitchangelog#migration-from-v2-to-v3","message":"gitchangelog 3.x changed the template engine to use Mako instead of custom templates. Existing .gitchangelog.rc templates may break.","severity":"breaking","affected_versions":"3.x"},{"fix":"Create a .gitchangelog.rc file or use -c to specify a config file.","message":"gitchangelog requires a .gitchangelog.rc file in the project root. Without it, it uses a default template that may not produce expected output.","severity":"gotcha","affected_versions":"all"},{"fix":"Use Python 3.6 or later.","message":"Python 2 support was dropped in version 3.0.0.","severity":"deprecated","affected_versions":">=3.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'gitchangelog --stdout' or 'gitchangelog CHANGELOG.rst'","cause":"gitchangelog expects at least one argument (the output file or '--stdout').","error":"gitchangelog: error: the following arguments are required: output"},{"fix":"Install via pip: 'pip install gitchangelog'","cause":"gitchangelog is not installed or not in the Python path.","error":"ImportError: No module named gitchangelog"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}