Add BitBucket pull request parser and add documentation

README.md

@@ -15,6 +15,7 @@ deployments are successful. All in one overview. This is all done via **webhooks
 - [GitHub](https://cimonitor.readthedocs.io/en/latest/webhook/github/)
 - [GitLab](https://cimonitor.readthedocs.io/en/latest/webhook/gitlab/)
 - [Read the Docs](https://cimonitor.readthedocs.io/en/latest/webhook/readthedocs/)
+- [BitBucket](https://cimonitor.readthedocs.io/en/latest/webhook/bitbucket/)
 
 ## Example
 

backend/parser/bitbucket/index.ts

@@ -9,6 +9,7 @@ import {
 import Status from 'types/status';
 
 import BitBucketBuildParser from './build';
+import BitBucketPullRequestParser from './pull-request';
 import BitBucketPushParser from './push';
 
 class BitBucketParser {
@@ -60,12 +61,7 @@ class BitBucketParser {
 
 		const id = this.getInternalId(pr.repository, pr.pullrequest.source.branch.name);
 
-		// TODO: parse the PR
-		console.log('[parser/bitbucket] TODO.');
-		id;
-		return null;
-
-		// return BitBucketPullRequestParser.parse(id, build);
+		return BitBucketPullRequestParser.parse(id, pr);
 	}
 }
 

backend/parser/bitbucket/pull-request.ts

@@ -0,0 +1,36 @@
+import StatusManager from 'backend/status/manager';
+import { BitBucketPullRequestWebhook } from 'types/bitbucket';
+import Status from 'types/status';
+
+class BitBucketPullRequestParser {
+	parse(id: string, pr: BitBucketPullRequestWebhook): Status {
+		let status = StatusManager.getStatus(id);
+
+		if (!status) {
+			status = {
+				id,
+				project: `${pr.repository.workspace.name} / ${pr.repository.name}`,
+				state: 'info',
+				source: 'bitbucket',
+				time: new Date().toUTCString(),
+				processes: [],
+			};
+		}
+
+		const commitUser = pr.actor;
+		return {
+			...status,
+			branch: pr.pullrequest.source.branch.name,
+			username: commitUser.display_name,
+			userUrl: commitUser.links.html.href,
+			userImage: commitUser.links.avatar.href,
+			mergeTitle: pr.pullrequest.title,
+			mergeUrl: pr.pullrequest.links.html.href,
+			projectImage: pr.repository.links.avatar.href,
+			sourceUrl: pr.repository.links.html.href,
+			time: new Date().toUTCString(),
+		};
+	}
+}
+
+export default new BitBucketPullRequestParser();

docs/webhook/bitbucket.md

@@ -0,0 +1,15 @@
+# BitBucket
+
+![BitBucket status example](../images/status/bitbucket.png)
+
+## Adding webhook
+
+In your BitBucket project settings, open the webhooks page, and add a webhook:
+
+- _WebHook URL_: `cimonitor.example.com/webhook/bitbucket` (replace your domain name)
+- _Content type_: `application/json`
+- _Secret:_ insert the same password you've defined to access your settings
+- _What event?_ Select all the events to unluck the most potential. Supported are merge request, pushes and builds.
+- Make sure the webhook is active
+
+Add your webhook! All new builds should become visible on your CIMonitor.

mkdocs.yml

@@ -20,6 +20,7 @@ nav:
     - GitHub: webhook/github.md
     - GitLab: webhook/gitlab.md
     - Read the docs: webhook/readthedocs.md
+    - BitBucket: webhook/bitbucket.md
   - Modules: modules.md
   - Module:
     - GPIO: module/gpio.md