mx-dev-vscode-ext

A VSCode extension that taps into the GitLab API to help devs know which MRs they're assigned to review across all GitLab services. Organized into a neat list in the VSCode sidebar

The Goal

To drive the development progress. Merge requests are often forgotten or just take forever to get reviewed. This tool is meant to help visibility among developers so people can see when MRs are ready for review and get them reviewed as quickly as possible.

How it works

Using the gitlab API and some logic this tool will search for MRs you need to review that are ready for review. If an item appears in the list it must pass these requirements.

1. Not in draft/wip mode
2. Requires at least 1 approval
3. Merge status is ready_to_merge
4. All Pipelines have passed.

List Sections

• MRs Requesting Your Review - MRs where you're assigned as a reviewer
• Your Group MRs - MRs on projects/repos which are shared_project in a Group of which you are a member
• Followed Users - MRs ready for review from Users you are following in GitLab.
• Starred Repos - MRs ready for review from repositories you have starred in GitLab.
• My Inactive MRs - Your MRs that haven't had any activity in over 2 weeks.

Best Practices

To get the most out of this your organization needs to start following some guidlines

1. All repos should require at least 1 approval to be merged.
2. If an MR is not ready for review, mark it as draft.
3. Groups should be used like code owners for repos. Group members are the reviewers and the shared_projects in a group are the repos which the members will see merge requests for.
4. If you want someone specific to review your MR you should assign them as a reviewer.
5. To get all MRs from a specific GitLab user, follow them in GitLab.
6. To get all MRs from a specific GitLab repository, star the repo in GitLab.

Additional Tools

• commands to load k8s terminals in either SAND or QA

Setup

1. Install the extension
2. Open Settings (cmd+,) search mx-dev
3. Create GitLab Personal Access token with read_api permissions and remove the expiration date https://gitlab.mx.com/-/profile/personal_access_tokens
4. Add your personal access token in the settings
5. Update other settings as necessary
6. Reload Window (cmd+shft+p) then type "reload window"

Changelog

1.1.4 - 03-18-2024

Added

• Focus Mode in the settings, enabled by default. Turn off to see all MRs for follwed repos and users regardless of merge/pipeline status.

1.1.2 - 08-18-2023

Added

• Commands to load into k8s shells when the current repo uses k8s

1.1.1 - 10-14-2022

Fixed

• Fixed potential bug when repo's may not have test pipelines

1.1.0 - 10-14-2022

Fixed

• Filtering out MRs which have a failed pipeline

1.0.0 - 10-12-2022

Added

• Added a notification badge which shows the number of MRs requesting your review in the sidebar Icon (This requires a minimum vscode version 1.71)
• Added a setting include-followed-users-in-badge-count which will add the number of MRs waiting for review from your followed users to the notification badge

Changed

• Refactored the way the lists are updated. Refreshes should be faster and more reliable.