Fossil Activity Graph

This is an attempt to recreate an activity graph across fossil repositories just like you see on Github.

So, for example, using this project, it is possible to create something like this -

Download the zip archive

Download the zip archive from here. Unzip the file and follow the instructions below.

Run via Docker

The entire project has been created as a docker container to remove the pain of installing all dependencies. These are ruby, node, and most of all puppeteer to create the images of the activity graph.

In docker-compose.yml, there are a couple of volume mounts that are critical -

1. The repositories volume mount. Here the source is the absolute path of the directory where all the fossil repositories reside. The target is the directory inside the container where the program expects to find the repositories.

2. The 'output' volume mount. The source can be any absolute path in the system. The target again is the path inside the container where the program outputs the image.

Repository List

The list of fossil repositories to parsed are to be listen in reposlist.txt. This file has to have each repository in its own line. Each repository file name is to be prefixed with the target repository path in point 1 above. A dummy list of fossil files are listed.

Environment file

The environment file .env.rb has three variables of which one is optional -

1. ENV['USERNAME'] - This should be the fossil user for which all the repositories will be searched for their commits.

2. ENV['IMAGE_PATH'] - This is the path where the image will be generated inside the container. The path is prefixed with the target output directory path as in point 2 above.

3. ENV['HTML_PATH'] - This is optional. If an HTML page of the activity graph is also required, then this can be given. The target output directory path in point 2 above applies here as well.

Running the Program

First, pull the image and build it by using docker compose build

After all the configurations are set above, run - docker compose up

This will create an image as given in the ENV['IMAGE_PATH'] above.