Gource is a great tool to visualize the history of individual repositories. This tool will help you to visualize an entire organization's activities through multiple repositories combined into a single history. You can configure which repositories should be included, which users should be included, and which users (such as bots) should be excluded in a configuration file. This utility will create a combined history of the given repositories and users; then this combined history can be used with Gource to generate an animation of the team's combined history.
brew install gource ffmpeg
composer require ktamas77/team-gource
You need to rename the given tg.conf.example
file into tg.conf
, then edit the file.
teams:
- name: main team # verbose name of the team
collection: frontend-repos # id of the collection of the repos to scan
members: # list of the members who are part of your team - only these users will be part of the animation
- name: Tamas # name of the user as it will be see in the rendered animation
aliases: [ktamas77, Tamas Kalman, ktamas77@gmail.com] # aliases of the user (it will be combined into one)
- name: John # another user
aliases: [john123, John Doe, john@mail.com] # user aliases
excluded: [automated-script, garbage-collector] # excluded these users; put here the bots, if you have any
- name: team2 # example of another team (you can define as many teams as needed)
collection: backend-repos
members:
- name: Smith
aliases: [smith123, Smith, smith@mail.com]
collections: # collection of repositories; each connection can be added to a team above
- name: frontend-repos # id of the collection, this is what we assign for the teams above
organization: betacorp # name of the organization in github where the repos are belong to
repos: # list of the repositories
- name: frontend-website # repository name
- name: logger # repository name
- name: monitoring # repository name
- name: backend-repos # another collection of repos
organization: unicorp # another organization
repos: # list of repositories
- name: logservice # repository name
- name: userservice # repository name
- name: microservice # repository name
After you finished editing the configuration file, simple run php tg.php
.
Then run Gource with the generated file.
- Optimized / Streamlined Plug-in style data processing
- Integrated Data Visualization Configuration + Gource Render