/Stash-Reviewers-Chrome-Extension

This chrome extension allow to define groups of reviewers in Atlassian Stash to bulk add them when creating or updating pull request.

Primary LanguageJavaScriptMIT LicenseMIT

Bitbucket Server Reviewers Groups - Extension

extension art

⚠️ if you have stash server (previous version of bitbucket) please switch to 'stash-server-version' branch

This chrome/firefox extension allow to define groups of reviewers in Atlassian Bitbucket Server (previously stash) to bulk add them when creating or updating pull request.

Features

  • Add button in pull request creation page to add group of reviewers
  • Add comments notification icon in header toolbar
    • Comments are from unreviewed pull requests (PR you see in your inbox)
    • A row always represent the first comment of a hierarchy
    • Sub-comments/tasks are represented by the icon on the right of the row
    • Each time there is a new comment/task the line of the first message of the hierarchy is highlighted and the red badge of the notification icon is increased (on each page load. there is no ajax poll request)
    • Badge disappear after you click on the icon to open the panel and close it
    • Highlight disappear when you visit the related PR page
    • Highlight state is save on the localStorage
    • Note: there is 2 kind of highlight: strong blue is when you see it for the first time (open panel for the first time), light blue is when activity was already there when you opened panel previously.
  • Add filter to the PR list
    • filter by: Author, Reviewers, Participants (people who participate to the PR even if they are not reviewers), Approvers (PR approved by specific reviewers), Direction, Branch
    • Note: each filter is a AND per PR and not a OR.
    • It mean that you can add only one Author or you will get no result (since there is only one author by PR).
    • And ALL reviewers/participants/approvers must exist in the PR or it won't be display
  • Add highlighted header to outdated file in pull request details page instead of the small sticker on the right to improve readability
  • Add clickable branch text (origin and target) in the pull request details page to go to the corresponding repository easily
  • Add a sticker on the right of the 'branch overview' page of a repository to list all pull requests comming from this branch (OPEN/MERGED/DECLINED)
    • Note: sticker are clickable to go directly to the corresponding pull request
  • Add a link to start a jenkin build in one click on the pull request details page
    • Note: you can add your hipchat username into the config panel of the extension to receive build notification
  • Add template button to PR editor
  • Check for new version
  • Settings
    • user can choose features to enable/disable inside extension option
    • user can choose to receive desktop notification only for comments on his PR, mention or answer.
    • user can map a repository name to a specific name to match his remote name in git

Installation

Chrome

you can find this extension on chrome webstore here: https://chrome.google.com/webstore/detail/bitbucket-server-extensio/hlagecmhpppmpfdifmigdglnhcpnohib

OR from the code source of this repository:

  • clone this repository
  • Go to chrome settings->extensions (extension manager)
  • Check the "Developer Mode" checkbox
  • Click on "Load unpacked extension" button.
  • From there choose the extension/chrome/src folder of this repository.

Firefox (webextensions)

you can find this module on mozilla addons website here: https://addons.mozilla.org/en-US/firefox/addon/bitbucket-server-extension/

OR from this repository:

  • download last .xpi (according to version number) from extension/firefox/dist/
  • go to extensions panel and click on the tools icon on the right next to the search field and select : Install add-on from file.
  • then browse extension/firefox/dist and select the xpi file.

Note: if ff version is greater than 41 you will have to change xpinstall.signatures.required value to false in about:config page.

Configuration

Enable/Disable features

just go to options panel and enable or disable features you want.

Configure reviewers groups

A "Stash" icon will appear on the top right corner of chrome window. Click on it. It will ask you to add a json to describe which group you want to create with which reviewers.

GitHub Logo

Json format is as follow :

{ "groups": [ { 
    "groupName":"first group name", 
    "reviewers": ["first reviewer name or email"] 
  },
  { 
    "groupName":"second group name", 
    "reviewers": ["first reviewer name or email", "second reviewer name or email"] 
  } ] }

After that when you will go to pull request creation page or update page a dropdown will appear after reviewers list with a list of groups you defined.

GitHub Logo

Note: the extension will make a bitbucket server api request to find reviewers. It will simply send the string you added in the reviewers array as search term. Normally if you add email or username as recommanded API should return only one user. You can also enter a name but in this case if the API return more than one user, only the first one will be added.