Skip to main content

Grab recent issue/PR activity from a GitHub repository and render it as markdown.

Project description


Generate simple markdown changelogs for GitHub repositories written in Python.

This package does two things:

  1. Given a GitHub org, repository, an initial git reference or date, use the GitHub GraphQL API to return a DataFrame of all issue and PR activity for this time period.
  2. A CLI to render this activity as markdown, suitable for generating changelogs or community updates.

Note: This is a really young tool so it might change a bit over time.


The easiest way to install this package is to do so directly from GitHub with pip:

pip install git+


The easiest way to use github-activity to generate activity markdown is to use the command-line interface. It takes the following form:

github-activity <org>/<repo> --since <date or ref> --until <date or ref>

See the github-activity documentation for more information.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

github_activity-0.1.0.tar.gz (11.7 kB view hashes)

Uploaded Source

Built Distribution

github_activity-0.1.0-py3-none-any.whl (13.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page