DEV Community

Cover image for How to Add Estimated Review Time and Context Labels to Pull Requests
LinearB for LinearB

Posted on • Originally published at

How to Add Estimated Review Time and Context Labels to Pull Requests

The pull request (PR) review process, if not set up well in your team, can create a lot of bottlenecks in getting your code merged into the main branch and into production. By adding more context and information automatically to your PRs, you save yourself and your team work.

Take the scenario of fixing a typo in documentation. If there’s a backlog of PRs that need attention, such a PR may take two days — or longer — just to be approved. This is where continuous merge (CM) with gitStream comes in.

gitStream is a tool that allows you to add context and automation to your PRs, classifying PRs based on their complexity.

This ensures that a review won't stay in the queue for long as it can be quickly assigned to the right person, immediately approved or have the appropriate action identified easily.

This hands-on article demonstrates how to add gitStream CM to your repository.

In this article, you’ll learn:

  1. How to Configure your Repository
  2. How to Create Pull Requests (PRs)
  3. How to Add the CM Feature to Your PRs

Quick gitStream Setup Guide

If you’re keen to get all the benefits of gitStream and continuous merge right away, all you need to do is follow these simple steps. If you want to understand how gitStream works, how you can customize it and more options, it will follow right after.

  1. Choose Install for free on gitStream's GitHub marketplace page
  2. Add 2 files to your repo:
a) .cm/
b) .github/workflows/gitstream.yml
Enter fullscreen mode Exit fullscreen mode
  1. Open a pull request
  2. Set gitStream as a required check

A Comprehensive Guide to gitStream & Continuous Merge

Filter functions and context variables are used to effect automated actions, such as adding labels (add-label@v1), assigning reviewers (add-reviewers@v1), and approving requests (approve@v1), among others.

Everything is included in a .cm configuration file named

All instructions to gitStream CM are detailed in the docs found at gitStream also uses GitHub Actions to do its work, so you’ll need to add the gitstream.yml file to your GitHub Actions directory at .github/workflows/.

The main components to fulfill gitStream’s CM are:

  • The configuration files: and gitstream.yml.
  • The filter functions: Code that tries to check and/or select certain data types from the input for checks during a PR creation.
  • The context variables: The inputs fed to the filter functions.
  • The automation actions.

Note: Some steps use Python only for demonstration purposes. It’s not required knowledge.


To follow this tutorial, ensure you have the following:

  • Hands-on knowledge of Git and GitHub workings. You must know activities such as creating a repository, PRs, commits, and pushes.
  • A GitHub account.
  • Git installed in your working environment.

You can find and review the final project code here.

Step 1 - Set Up gitStream on Your Repo

Create an empty repo and give it a name, then install gitStream to it from the marketplace.

After installation, you can either: 1) Clone the repository to your environment; or 2) Create a folder and point it to the repository. This tutorial uses the second option.

Create a folder called gitStreamDemo. In this folder, create two directories, .github/workflows and .cm, using the commands in a terminal window below:

mkdir -p .github/workflows

mkdir .cm
Enter fullscreen mode Exit fullscreen mode

In the .github/workflows folder, create a file called gitstream.yml and add the following YAML script:

name: gitStream workflow automation





      description: The Client payload

      required: true


      description: the repository name include the owner in `owner/repo_name` format

      required: true


      description: the head sha

      required: true


      description: the base ref 

      required: true


      description: the installation id

      required: false


      description: the resolver url to pass results to

      required: true


      description: Optional resolver token for resolver service

      required: false

      default: ''



    timeout-minutes: 5

    # uncomment this condition, if you dont want any automation on dependabot PRs

    # if: != 'dependabot[bot]'

    runs-on: ubuntu-latest

    name: gitStream workflow automation


      - name: Evaluate Rules

        uses: linear-b/gitstream-github-action@v1

        id: rules-engine


          full_repository: ${{ github.event.inputs.full_repository }}

          head_ref: ${{ github.event.inputs.head_ref }}

          base_ref: ${{ github.event.inputs.base_ref }}

          client_payload: ${{ github.event.inputs.client_payload }}

          installation_id: ${{ github.event.inputs.installation_id }}

          resolver_url: ${{ github.event.inputs.resolver_url }}

          resolver_token: ${{ github.event.inputs.resolver_token }}
Enter fullscreen mode Exit fullscreen mode

Next, create a file called in the .cm folder and add the following code:


  version: 1.0




      - true


      - action : add-label@v1


       label: "{{ calc.etr }} min review"

       color: {{ '00ff00' if (calc.etr >= 20) else ('7B3F00' if (calc.etr >= 5) else '0044ff') }}



      - {{ is.doc_formatting or is.doc_update }}


      - action: add-label@v1


       label: 'documentation changes: PR approved'

       color: {{'71797e'}}

      - action: approve@v1



      - {{ is.domain_change }}


      - action: add-reviewers@v1


       reviewers: [<listofreviewers>]

      - action: add-label@v1


       label: 'domain reviewer assigned'

       color: {{'71797e'}}



      - true


      - action: add-comment@v1


       comment: "Hello there. Thank you for creating a pull request with us. A reviewer will soon get in touch."


  etr: {{ branch | estimatedReviewTime }}


  domain_change: {{ files | match(regex=r/domain\//) | some }}

  doc_formatting: {{ source.diff.files | isFormattingChange }}

  doc_update: {{ files | allDocs }}
Enter fullscreen mode Exit fullscreen mode

In the file, you’ll see the following four automation actions:

  • show_estimated_time_to_review: This automation calculates the estimated time a review to a PR may take.
  • safe_changes: This shows if changes to non-critical components done in a PR are safe, such as document changes. The PR is automatically approved.
  • domain_review: This automation runs to show if a change was made to the domain layer.
  • set_default_comment: This is fired every time a PR is opened and raises an acknowledgment comment to the user that a PR has been created.

At the end of the document, there’s a section containing filter functions for the automation actions. The actions are run after certain conditions specified in the filter functions or keys are met.

Step 2 - Calculating the Time to Review

In the first automation, check the value of the etr variable and decide which label to assign to the PR. For more information on how ETR is calculated, check out this blog.

Create a file called in the root of your folder. Then, create three folders using the command below:

mkdir views domain data
Enter fullscreen mode Exit fullscreen mode

Add the following to the file:

def show_message(name1, name2):

  print(f'Hello, {name}. Welcome to the gitStream world')

if __name__ == '__main__':

Enter fullscreen mode Exit fullscreen mode

Copy the file as is and paste it to the other three folders. Rename them to match the folders’ names ( for the domain folder.

For the dummy documentation file, create a file in the root of your folder and add the following markdown script.

# gitStreamDemo
Enter fullscreen mode Exit fullscreen mode

A demo showing how to set up gitStream on your first repo

Now, run these commands to initialize the repository, stage the files for committing, and make a commit, in that order:

git init

git add .

git commit -am “initialization”
Enter fullscreen mode Exit fullscreen mode

Next, point the folder to your repository using the command below:

git remote add origin<your-username>/<your-repo-name>
Enter fullscreen mode Exit fullscreen mode

Finally, push it:

git push -u origin main
Enter fullscreen mode Exit fullscreen mode

Step 3 - Creating the Repository

As you may have noticed, there’s a sample bug in the code. In any programming language, you must call the function using its exact name. But in this case, print_hi was called instead of show_message. As a team member or an open-source contributor, you can fix this by opening a PR.

First, create a branch called fix-function-call and checkout into the branch using the commands below:

git branch fix-function-call

git checkout fix-function-call
Enter fullscreen mode Exit fullscreen mode

Next, replace the name print_hi with show_message in all the .py files, then commit and push the changes.

git commit -am “changed function name”

git push --set-upstream origin fix-function-call
Enter fullscreen mode Exit fullscreen mode

Now, open your repository in GitHub. You’ll see the following card:

Compare and pull request button

Click on Compare & pull request. On the next page, click the Create pull request button.

Once the gitStream automation has finished running, you’ll see the domain reviewer assigned tag. Additionally, a comment has been created.

Domain reviewer assigned tag

Add this Dijkstra’s Shortest Path Algorithm script just below the show_message function in each of the .py files again. These scripts calculate the shortest path for a node in a graph.

Commit the changes and then push the code.

git commit -am “updates”

git push
Enter fullscreen mode Exit fullscreen mode

PR Approved

Creating a Safe Change

For the final automation, you’ll add text to the file created earlier. Create a new branch and checkout to it. You do so because you’ll need a new PR to demonstrate this automation.

git checkout main

git branch update_docs

git checkout update_docs
Enter fullscreen mode Exit fullscreen mode

Then, add this sentence to the file:

Continuous Merging is very beneficial to the Open-Source Community.
Enter fullscreen mode Exit fullscreen mode

Commit and push.

git commit -am “updated the docs”

git push --set-upstream origin update_docs
Enter fullscreen mode Exit fullscreen mode

When the checks are done, you’ll see a different label with the PR already approved.

PR Approved

Help Developers Make the Most of Their Time...

Reviewing and merging PRs are crucial in contributing to software development and enhancing team productivity. However, being unable to classify PRs by complexity can lead to long wait times or much back-and-forth in the review process.

CM remedies this issue by classifying PRs based on the complexity, automating some actions including tagging the appropriate reviewers, assigning them PRs, and approving PRs among others to reduce the backlog.

Check out gitStream to add CM to your existing repos.

Learn more about gitStream today!

Top comments (0)