#!/usr/bin/env python3 # # An easy Trello integration for Zulip. import argparse import sys try: import requests except ImportError: print("Error: Please install the python requests library before running this script:") print("http://docs.python-requests.org/en/master/user/install/") sys.exit(1) def get_model_id(options): """get_model_id Get Model Id from Trello API :options: argparse.Namespace arguments :returns: str id_model Trello board idModel """ trello_api_url = "https://api.trello.com/1/board/{}".format(options.trello_board_id) params = { "key": options.trello_api_key, "token": options.trello_token, } trello_response = requests.get(trello_api_url, params=params) if trello_response.status_code != 200: print("Error: Can't get the idModel. Please check the configuration") sys.exit(1) board_info_json = trello_response.json() return board_info_json["id"] def get_webhook_id(options, id_model): """get_webhook_id Get webhook id from Trello API :options: argparse.Namespace arguments :id_model: str Trello board idModel :returns: str id_webhook Trello webhook id """ trello_api_url = "https://api.trello.com/1/webhooks/" data = { "key": options.trello_api_key, "token": options.trello_token, "description": "Webhook for Zulip integration (From Trello {} to Zulip)".format( options.trello_board_name, ), "callbackURL": options.zulip_webhook_url, "idModel": id_model, } trello_response = requests.post(trello_api_url, data=data) if trello_response.status_code != 200: print("Error: Can't create the Webhook:", trello_response.text) sys.exit(1) webhook_info_json = trello_response.json() return webhook_info_json["id"] def create_webhook(options): """create_webhook Create Trello webhook :options: argparse.Namespace arguments """ # first, we need to get the idModel print("Getting Trello idModel for the {} board...".format(options.trello_board_name)) id_model = get_model_id(options) if id_model: print("Success! The idModel is", id_model) id_webhook = get_webhook_id(options, id_model) if id_webhook: print("Success! The webhook ID is", id_webhook) print( "Success! The webhook for the {} Trello board was successfully created.".format( options.trello_board_name ) ) def main(): description = """ zulip_trello.py is a handy little script that allows Zulip users to quickly set up a Trello webhook. Note: The Trello webhook instructions available on your Zulip server may be outdated. Please make sure you follow the updated instructions at . """ parser = argparse.ArgumentParser(description=description) parser.add_argument("--trello-board-name", required=True, help="The Trello board name.") parser.add_argument( "--trello-board-id", required=True, help=("The Trello board short ID. Can usually be found " "in the URL of the Trello board."), ) parser.add_argument( "--trello-api-key", required=True, help=( "Visit https://trello.com/1/appkey/generate to generate " "an APPLICATION_KEY (need to be logged into Trello)." ), ) parser.add_argument( "--trello-token", required=True, help=( "Visit https://trello.com/1/appkey/generate and under " "`Developer API Keys`, click on `Token` and generate " "a Trello access token." ), ) parser.add_argument( "--zulip-webhook-url", required=True, help="The webhook URL that Trello will query." ) options = parser.parse_args() create_webhook(options) if __name__ == "__main__": main()