Skip to main content

Flask application for listening to Bitbucket webhooks

Project description

FLAFL

Flask Application For Listening...

Code style: black

Listens for events triggered by Webhooks in an Atlassian Bitbucket server and responds.

It assumes the main purpose is to trigger test plans in an associated Bamboo instance, but can be persuaded to take other actions.


Requirements

  • User must have a netrc file containing valid login details for the Bamboo hostname used

Installation

git clone .../flafl.git
cd flafl
python3 -m venv /path/to/virtual/environment
source /path/to/virtual/environment/bin/activate
pip3 install -r requirements.txt

Local configuration

Export the following variables with the correct information:

export NETRC_FILE="/path/to/netrc/file"
export BAMB_HOSTNAME="bamboo.yourorg.com"
export BITB_HOSTNAME="bitbucket.yourorg.com"

To run the tests (see below), these environment variables must be defined, but do not need to have the correct values.

export BITB_PROJECT="test"
export BITB_REPO="test"

Tests

To check set-up, run:

python3 -m pytest

or to get test-coverage information run:

coverage run -m pytest

which allows a test-coverage report to be produced:

coverage report

or as a web page:

coverage html
xdg-open htmlcov/index.html

Usage

The main application runs as a background service.

In the flafl directory run:

./flafld <command>

to control the service. Specifically:

  • flafld start or flafld run start the service in the background, recording the process ID to ${TMP:-/tmp}/.flafl.pid
  • flafld stop stops the process (and its children)
  • flafld restart stops the running service and starts it again

On starting the service, the port number of the Flask application is printed. Make a note of this for use in setting webhooks up in Bitbucket.

Bitbucket configuration

In a browser, go to the webhook set-up page of your repository in your Bitbucket server:

https://<bitbucket.yourorg.com>/plugins/servlet/webhooks/projects/<project>/repos/<repo>

Create webhook by clicking "Create webhook", giving it a name (e.g. "flafl"), and specifying the URL of your running FLAFL application, e.g.:

https://<flafl-app-host.yourorg.com>:8080/flafl/api/v1.0/events

No "Secret" is required. Click "Test connection", and you should get a return code of "200", and in "View details", the body of the response from the applications should be:

{
  "debug_info": {
    "payloadReceived": {
      "test": true
    }
  }, 
  "message": "Successful connection."
}

Now select which events should send webhooks to the app. Under the "Repository" column, the following webhooks, if selected, will trigger a respose:

  • Push

and under the "Pull request" column, the following:

  • Opened
  • Modified
  • Merged
  • Declined
  • Deleted
  • Comment added

Others will be quietly ignored. FLAFL can easily be extended to add responses to other tiggers of interest.

Click "Save".

To test the Bitbucket configuration, create a new pull request (the target branch must be within the repository that has the webhooks; the source branch can be outside, e.g. in a fork).

In the directory containing the FLAFL application code, a log file should have been created with some diagnostic output, e.g.:

2019-12-17 17:18:54.360661
Success payload:
{
    "message": "Created PR with ID 321 from project/repo/feature-branch to project/repo/develop. Sent API call to Bamboo and got return code 204",
    "status": "success"
}

Also, the application should have automatically added a comment to the PR asking the PR author to add a Jira ticket ID to the PR title. This is an example of the kind of checks the application can perform.

Adding a comment to the PR, and deleting or declining the PR, should also add similar diagnostic output to the flafl.log file.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flafl-0.0.4.tar.gz (10.3 kB view details)

Uploaded Source

Built Distribution

flafl-0.0.4-py3-none-any.whl (14.2 kB view details)

Uploaded Python 3

File details

Details for the file flafl-0.0.4.tar.gz.

File metadata

  • Download URL: flafl-0.0.4.tar.gz
  • Upload date:
  • Size: 10.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for flafl-0.0.4.tar.gz
Algorithm Hash digest
SHA256 88812c53bcc555cb9193ec41c6e425dfc70ecd8eb21cac0828346be4bb9d1043
MD5 d142486f1d824a4f57da535e906aea74
BLAKE2b-256 606eaa4d780484054c60832543f409743b8f6f960a43655c22a96c45012c786a

See more details on using hashes here.

File details

Details for the file flafl-0.0.4-py3-none-any.whl.

File metadata

  • Download URL: flafl-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 14.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for flafl-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 2e2b834c45f1af4d51392ed6d31bc280126790995fa54a895c24b402882b254b
MD5 818055a5ab33bc0370283b383e7b5972
BLAKE2b-256 36b11bdd4e33b60a3898539d07f96e3c4065281cf57a080d9d9c49820c812f08

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page