rcextensions: new builtin rcextensions.

- ability to expose output to users from rcextensions
- new docs
- linking to the code makes the tests always check the integrity of rcextensions
- added new hook variables and described them to end users

docs/integrations/integrations-rcextensions.rst

@@ -0,0 +1,44
+.. _integrations-rcextensions:
+
+
+rcextensions integrations
+=========================
+
+
+Since RhodeCode 4.14 release rcextensions aren't part of rhodecode-tools, and instead
+they are shipped with the new or upgraded installations.
+
+The rcextensions template `rcextensions.tmpl` is created in the `etc/` directory
+of enterprise or community installation. It's always re-created and updated on upgrades.
+
+
+Activating rcextensions
++++++++++++++++++++++++
+
+To activate rcextensions simply copy or rename the created template rcextensions
+into the path where the rhodecode.ini file is located::
+
+    pushd ~/rccontrol/enterprise-1/
+    or
+    pushd ~/rccontrol/community-1/
+
+    mv etc/rcextensions.tmpl rcextensions
+
+
+rcextensions are loaded when |RCE| starts. So a restart is required after activation or
+change of code in rcextensions.
+
+Simply restart only the enterprise/community instance::
+
+    rccontrol restart enterprise-1
+    or
+    rccontrol restart community-1
+
+
+Example usage
++++++++++++++
+
+
+To see examples of usage please check the examples directory under:
+
+https://code.rhodecode.com/rhodecode-enterprise-ce/files/stable/rhodecode/config/rcextensions/examples

rhodecode/config/rcextensions/__init__.py

@@ -0,0 +1,56
+# Copyright (C) 2016-2018 RhodeCode GmbH
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License, version 3
+# (only), as published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This program is dual-licensed. If you wish to learn more about the
+# RhodeCode Enterprise Edition, including its added features, Support services,
+# and proprietary license terms, please see https://rhodecode.com/licenses/
+
+"""
+rcextensions module, please edit `hooks.py` to over write hooks logic
+"""
+
+from .hooks import (
+    _create_repo_hook,
+    _create_repo_group_hook,
+    _pre_create_user_hook,
+    _create_user_hook,
+    _delete_repo_hook,
+    _delete_user_hook,
+    _pre_push_hook,
+    _push_hook,
+    _pre_pull_hook,
+    _pull_hook,
+    _create_pull_request_hook,
+    _review_pull_request_hook,
+    _update_pull_request_hook,
+    _merge_pull_request_hook,
+    _close_pull_request_hook,
+)
+
+# set as module attributes, we use those to call hooks. *do not change this*
+CREATE_REPO_HOOK = _create_repo_hook
+CREATE_REPO_GROUP_HOOK = _create_repo_group_hook
+PRE_CREATE_USER_HOOK = _pre_create_user_hook
+CREATE_USER_HOOK = _create_user_hook
+DELETE_REPO_HOOK = _delete_repo_hook
+DELETE_USER_HOOK = _delete_user_hook
+PRE_PUSH_HOOK = _pre_push_hook
+PUSH_HOOK = _push_hook
+PRE_PULL_HOOK = _pre_pull_hook
+PULL_HOOK = _pull_hook
+CREATE_PULL_REQUEST = _create_pull_request_hook
+REVIEW_PULL_REQUEST = _review_pull_request_hook
+UPDATE_PULL_REQUEST = _update_pull_request_hook
+MERGE_PULL_REQUEST = _merge_pull_request_hook
+CLOSE_PULL_REQUEST = _close_pull_request_hook

rhodecode/config/rcextensions/examples/http_call_on_push.py

@@ -0,0 +1,36
+# Example to trigger a HTTP call via an HTTP helper via post_push hook
+
+
+@has_kwargs({
+    'server_url': 'url of instance that triggered this hook',
+    'config': 'path to .ini config used',
+    'scm': 'type of version control "git", "hg", "svn"',
+    'username': 'username of actor who triggered this event',
+    'ip': 'ip address of actor who triggered this hook',
+    'action': '',
+    'repository': 'repository name',
+    'repo_store_path': 'full path to where repositories are stored',
+    'commit_ids': '',
+    'hook_type': '',
+    'user_agent': '',
+})
+def _push_hook(*args, **kwargs):
+    """
+    POST PUSH HOOK, this function will be executed after each push it's
+    executed after the build-in hook that RhodeCode uses for logging pushes
+    """
+
+    from .helpers import http_call, extra_fields
+    # returns list of dicts with key-val fetched from extra fields
+    repo_extra_fields = extra_fields.run(**kwargs)
+
+    if repo_extra_fields.get('endpoint_url'):
+        endpoint = repo_extra_fields['endpoint_url']
+        if endpoint:
+            data = {
+                'some_key': 'val'
+            }
+            response = http_call.run(url=endpoint, json_data=data)
+            return HookResponse(0, 'Called endpoint {}, with response {}'.format(endpoint, response))
+
+    return HookResponse(0, '')

rhodecode/config/rcextensions/examples/trigger_ci_call.py

@@ -0,0 +1,36
+# Example to trigger a CI call via an HTTP helper via post_push hook
+
+
+@has_kwargs({
+    'server_url': 'url of instance that triggered this hook',
+    'config': 'path to .ini config used',
+    'scm': 'type of version control "git", "hg", "svn"',
+    'username': 'username of actor who triggered this event',
+    'ip': 'ip address of actor who triggered this hook',
+    'action': '',
+    'repository': 'repository name',
+    'repo_store_path': 'full path to where repositories are stored',
+    'commit_ids': '',
+    'hook_type': '',
+    'user_agent': '',
+})
+def _push_hook(*args, **kwargs):
+    """
+    POST PUSH HOOK, this function will be executed after each push it's
+    executed after the build-in hook that RhodeCode uses for logging pushes
+    """
+
+    from .helpers import http_call, extra_fields
+    # returns list of dicts with key-val fetched from extra fields
+    repo_extra_fields = extra_fields.run(**kwargs)
+
+    if repo_extra_fields.get('endpoint_url'):
+        endpoint = repo_extra_fields['endpoint_url']
+        if endpoint:
+            data = {
+                'some_key': 'val'
+            }
+            response = http_call.run(url=endpoint, json_data=data)
+            return HookResponse(0, 'Called endpoint {}, with response {}'.format(endpoint, response))
+
+    return HookResponse(0, '')

rhodecode/config/rcextensions/helpers/__init__.py

@@ -0,0 +1,17
+# Copyright (C) 2016-2018 RhodeCode GmbH
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License, version 3
+# (only), as published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This program is dual-licensed. If you wish to learn more about the
+# RhodeCode Enterprise Edition, including its added features, Support services,
+# and proprietary license terms, please see https://rhodecode.com/licenses/

rhodecode/config/rcextensions/helpers/extra_fields.py

@@ -0,0 +1,40
+# -*- coding: utf-8 -*-
+# Copyright (C) 2016-2018 RhodeCode GmbH
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License, version 3
+# (only), as published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This program is dual-licensed. If you wish to learn more about the
+# RhodeCode Enterprise Edition, including its added features, Support services,
+# and proprietary license terms, please see https://rhodecode.com/licenses/
+
+"""
+us in hooks::
+
+    from .helpers import extra_fields
+    # returns list of dicts with key-val fetched from extra fields
+    repo_extra_fields = extra_fields.run(**kwargs)
+
+"""
+
+
+def run(*args, **kwargs):
+    from rhodecode.model.db import Repository
+    # use temp name then the main one propagated
+    repo_name = kwargs.pop('REPOSITORY', None) or kwargs['repository']
+    repo = Repository.get_by_repo_name(repo_name)
+
+    fields = {}
+    for field in repo.extra_fields:
+        fields[field.field_key] = field.get_dict()
+
+    return fields

rhodecode/config/rcextensions/helpers/extract_post_commits.py

@@ -0,0 +1,61
+# -*- coding: utf-8 -*-
+# Copyright (C) 2016-2018 RhodeCode GmbH
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License, version 3
+# (only), as published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This program is dual-licensed. If you wish to learn more about the
+# RhodeCode Enterprise Edition, including its added features, Support services,
+# and proprietary license terms, please see https://rhodecode.com/licenses/
+
+"""
+Extract and serialize commits taken from a list of commit_ids. This should
+be used in post_push hook
+
+us in hooks::
+
+    from .helpers import extract_post_commits
+    # returns list of dicts with key-val fetched from extra fields
+    commit_list = extract_post_commits.run(**kwargs)
+"""
+import traceback
+
+
+def run(*args, **kwargs):
+    from rhodecode.lib.utils2 import extract_mentioned_users
+    from rhodecode.model.db import Repository
+
+    commit_ids = kwargs.get('commit_ids')
+    if not commit_ids:
+        return 0
+
+    # use temp name then the main one propagated
+    repo_name = kwargs.pop('REPOSITORY', None) or kwargs['repository']
+
+    repo = Repository.get_by_repo_name(repo_name)
+    commits = []
+
+    vcs_repo = repo.scm_instance(cache=False)
+    try:
+        for commit_id in commit_ids:
+            cs = vcs_repo.get_changeset(commit_id)
+            cs_data = cs.__json__()
+            cs_data['mentions'] = extract_mentioned_users(cs_data['message'])
+            # optionally add more logic to parse the commits, like reading extra
+            # fields of repository to read managers of reviewers ?
+            commits.append(cs_data)
+    except Exception:
+        print(traceback.format_exc())
+        # we don't send any commits when crash happens, only full list matters
+        # we short circuit then.
+        return []
+    return commits

rhodecode/config/rcextensions/helpers/extract_pre_commits.py

@@ -0,0 +1,63
+# -*- coding: utf-8 -*-
+# Copyright (C) 2016-2018 RhodeCode GmbH
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License, version 3
+# (only), as published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This program is dual-licensed. If you wish to learn more about the
+# RhodeCode Enterprise Edition, including its added features, Support services,
+# and proprietary license terms, please see https://rhodecode.com/licenses/
+
+"""
+us in hooks::
+
+    from .helpers import extract_pre_commits
+    # returns list of dicts with key-val fetched from extra fields
+    commit_list = extract_pre_commits.run(**kwargs)
+
+"""
+import re
+import collections
+
+
+def get_hg_commits(repo, refs):
+    commits = []
+    return commits
+
+
+def get_git_commits(repo, refs):
+    commits = []
+    return commits
+
+
+def run(*args, **kwargs):
+    from rhodecode.model.db import Repository
+
+    vcs_type = kwargs['scm']
+    # use temp name then the main one propagated
+    repo_name = kwargs.pop('REPOSITORY', None) or kwargs['repository']
+
+    repo = Repository.get_by_repo_name(repo_name)
+    vcs_repo = repo.scm_instance(cache=False)
+
+    commits = []
+
+    for rev_data in kwargs['commit_ids']:
+        new_environ = dict((k, v) for k, v in rev_data['hg_env'])
+
+    if vcs_type == 'git':
+        commits = get_git_commits(vcs_repo, kwargs['commit_ids'])
+
+    if vcs_type == 'hg':
+        commits = get_hg_commits(vcs_repo, kwargs['commit_ids'])
+
+    return commits

rhodecode/config/rcextensions/helpers/http_call.py

@@ -0,0 +1,36
+# -*- coding: utf-8 -*-
+# Copyright (C) 2016-2018 RhodeCode GmbH
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License, version 3
+# (only), as published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This program is dual-licensed. If you wish to learn more about the
+# RhodeCode Enterprise Edition, including its added features, Support services,
+# and proprietary license terms, please see https://rhodecode.com/licenses/
+
+"""
+us in hooks::
+
+    from .helpers import http_call
+    # returns response after making a POST call
+    response = http_call.run(url=url, json_data=data)
+
+"""
+
+from rhodecode.integrations.types.base import requests_retry_call
+
+
+def run(url, json_data, method='post'):
+    requests_session = requests_retry_call()
+    requests_session.verify = True  # Verify SSL
+    resp = requests_session.post(url, json=json_data, timeout=60)
+    return resp.raise_for_status()  # raise exception on a failed request

rhodecode/config/rcextensions/hooks.py

@@ -0,0 +1,431
+# Copyright (C) 2016-2018 RhodeCode GmbH
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License, version 3
+# (only), as published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This program is dual-licensed. If you wish to learn more about the
+# RhodeCode Enterprise Edition, including its added features, Support services,
+# and proprietary license terms, please see https://rhodecode.com/licenses/
+
+from .utils import DotDict, HookResponse, has_kwargs
+
+
+# Config shortcut to keep, all configuration in one place
+# Example:  api_key = CONFIG.my_config.api_key
+CONFIG = DotDict(
+    my_config=DotDict(
+        api_key='<secret>',
+    ),
+
+)
+
+
+@has_kwargs({
+    'repo_name': '',
+    'repo_type': '',
+    'description': '',
+    'private': '',
+    'created_on': '',
+    'enable_downloads': '',
+    'repo_id': '',
+    'user_id': '',
+    'enable_statistics': '',
+    'clone_uri': '',
+    'fork_id': '',
+    'group_id': '',
+    'created_by': ''
+})
+def _create_repo_hook(*args, **kwargs):
+    """
+    POST CREATE REPOSITORY HOOK. This function will be executed after
+    each repository is created. kwargs available:
+
+    """
+    return HookResponse(0, '')
+
+
+@has_kwargs({
+    'group_name': '', 
+    'group_parent_id': '', 
+    'group_description': '',
+    'group_id': '', 
+    'user_id': '', 
+    'created_by': '', 
+    'created_on': '', 
+    'enable_locking': ''
+})
+def _create_repo_group_hook(*args, **kwargs):
+    """
+    POST CREATE REPOSITORY GROUP HOOK, this function will be
+    executed after each repository group is created. kwargs available:
+    """
+    return HookResponse(0, '')
+
+
+@has_kwargs({
+    'username': '', 
+    'password': '', 
+    'email': '', 
+    'firstname': '',
+    'lastname': '', 
+    'active': '', 
+    'admin': '', 
+    'created_by': '',
+})
+def _pre_create_user_hook(*args, **kwargs):
+    """
+    PRE CREATE USER HOOK, this function will be executed before each
+    user is created, it returns a tuple of bool, reason.
+    If bool is False the user creation will be stopped and reason
+    will be displayed to the user.
+
+    Return HookResponse(1, reason) to block user creation
+
+    """
+
+    reason = 'allowed'
+    return HookResponse(0, reason)
+
+
+@has_kwargs({
+    'username': '',
+    'full_name_or_username': '',
+    'full_contact': '',
+    'user_id': '',
+    'name': '',
+    'firstname': '',
+    'short_contact': '',
+    'admin': '',
+    'lastname': '',
+    'ip_addresses': '',
+    'extern_type': '',
+    'extern_name': '',
+    'email': '',
+    'api_key': '',
+    'api_keys': '',
+    'last_login': '',
+    'full_name': '',
+    'active': '',
+    'password': '',
+    'emails': '',
+    'inherit_default_permissions': '',
+    'created_by': '',
+    'created_on': '',
+})
+def _create_user_hook(*args, **kwargs):
+    """
+    POST CREATE USER HOOK, this function will be executed after each user is created
+    """
+    return HookResponse(0, '')
+
+
+@has_kwargs({
+    'repo_name': '',
+    'repo_type': '',
+    'description': '',
+    'private': '',
+    'created_on': '',
+    'enable_downloads': '',
+    'repo_id': '',
+    'user_id': '',
+    'enable_statistics': '',
+    'clone_uri': '',
+    'fork_id': '',
+    'group_id': '',
+    'deleted_by': '',
+    'deleted_on': '',
+})
+def _delete_repo_hook(*args, **kwargs):
+    """
+    POST DELETE REPOSITORY HOOK, this function will be executed after
+    each repository deletion
+    """
+    return HookResponse(0, '')
+
+
+@has_kwargs({
+    'username': '',
+    'full_name_or_username': '',
+    'full_contact': '',
+    'user_id': '',
+    'name': '',
+    'short_contact': '',
+    'admin': '',
+    'firstname': '',
+    'lastname': '',
+    'ip_addresses': '',
+    'email': '',
+    'api_key': '',
+    'last_login': '',
+    'full_name': '',
+    'active': '',
+    'password': '',
+    'emails': '',
+    'inherit_default_permissions': '',
+    'deleted_by': '',
+ })
+def _delete_user_hook(*args, **kwargs):
+    """
+    POST DELETE USER HOOK, this function will be executed after each
+    user is deleted kwargs available:
+    """
+    return HookResponse(0, '')
+
+
+# =============================================================================
+# PUSH/PULL RELATED HOOKS
+# =============================================================================
+@has_kwargs({
+    'server_url': 'url of instance that triggered this hook',
+    'config': 'path to .ini config used',
+    'scm': 'type of version control "git", "hg", "svn"',
+    'username': 'username of actor who triggered this event',
+    'ip': 'ip address of actor who triggered this hook',
+    'action': '',
+    'repository': 'repository name',
+    'repo_store_path': 'full path to where repositories are stored',
+    'commit_ids': 'pre transaction metadata for commit ids',
+    'hook_type': '',
+    'user_agent': 'Client user agent, e.g git or mercurial CLI version',
+})
+def _pre_push_hook(*args, **kwargs):
+    """
+    Post push hook
+    To stop version control from storing the transaction and send a message to user
+    use non-zero HookResponse with a message, e.g return HookResponse(1, 'Not allowed')
+
+    This message will be shown back to client during PUSH operation
+
+    Commit ids might look like that::
+
+    [{u'hg_env|git_env': ...,
+      u'multiple_heads': [],
+      u'name': u'default',
+      u'new_rev': u'd0befe0692e722e01d5677f27a104631cf798b69',
+      u'old_rev': u'd0befe0692e722e01d5677f27a104631cf798b69',
+      u'ref': u'',
+      u'total_commits': 2,
+      u'type': u'branch'}]
+    """
+    return HookResponse(0, '')
+
+
+@has_kwargs({
+    'server_url': 'url of instance that triggered this hook',
+    'config': 'path to .ini config used',
+    'scm': 'type of version control "git", "hg", "svn"',
+    'username': 'username of actor who triggered this event',
+    'ip': 'ip address of actor who triggered this hook',
+    'action': '',
+    'repository': 'repository name',
+    'repo_store_path': 'full path to where repositories are stored',
+    'commit_ids': 'list of pushed commit_ids (sha1)',
+    'hook_type': '',
+    'user_agent': 'Client user agent, e.g git or mercurial CLI version',
+})
+def _push_hook(*args, **kwargs):
+    """
+    POST PUSH HOOK, this function will be executed after each push it's
+    executed after the build-in hook that RhodeCode uses for logging pushes
+    """
+    return HookResponse(0, '')
+
+
+@has_kwargs({
+    'server_url': 'url of instance that triggered this hook',
+    'repo_store_path': 'full path to where repositories are stored',
+    'config': 'path to .ini config used',
+    'scm': 'type of version control "git", "hg", "svn"',
+    'username': 'username of actor who triggered this event',
+    'ip': 'ip address of actor who triggered this hook',
+    'action': '',
+    'repository': 'repository name',
+    'hook_type': '',
+    'user_agent': 'Client user agent, e.g git or mercurial CLI version',
+})
+def _pre_pull_hook(*args, **kwargs):
+    """
+    Post pull hook
+    """
+    return HookResponse(0, '')
+
+
+@has_kwargs({
+    'server_url': 'url of instance that triggered this hook',
+    'repo_store_path': 'full path to where repositories are stored',
+    'config': 'path to .ini config used',
+    'scm': 'type of version control "git", "hg", "svn"',
+    'username': 'username of actor who triggered this event',
+    'ip': 'ip address of actor who triggered this hook',
+    'action': '',
+    'repository': 'repository name',
+    'hook_type': '',
+    'user_agent': 'Client user agent, e.g git or mercurial CLI version',
+})
+def _pull_hook(*args, **kwargs):
+    """
+    This hook will be executed after each code pull.
+    """
+    return HookResponse(0, '')
+
+
+# =============================================================================
+#  PULL REQUEST RELATED HOOKS
+# =============================================================================
+@has_kwargs({
+    'server_url': 'url of instance that triggered this hook',
+    'config': 'path to .ini config used',
+    'scm': 'type of version control "git", "hg", "svn"',
+    'username': 'username of actor who triggered this event',
+    'ip': 'ip address of actor who triggered this hook',
+    'action': '',
+    'repository': 'repository name',
+    'pull_request_id': '',
+    'url': '',
+    'title': '',
+    'description': '',
+    'status': '',
+    'created_on': '',
+    'updated_on': '',
+    'commit_ids': '',
+    'review_status': '',
+    'mergeable': '',
+    'source': '',
+    'target': '',
+    'author': '',
+    'reviewers': '',
+})
+def _create_pull_request_hook(*args, **kwargs):
+    """
+    This hook will be executed after creation of a pull request.
+    """
+    return HookResponse(0, '')
+
+
+@has_kwargs({
+    'server_url': 'url of instance that triggered this hook',
+    'config': 'path to .ini config used',
+    'scm': 'type of version control "git", "hg", "svn"',
+    'username': 'username of actor who triggered this event',
+    'ip': 'ip address of actor who triggered this hook',
+    'action': '',
+    'repository': 'repository name',
+    'pull_request_id': '',
+    'url': '',
+    'title': '',
+    'description': '',
+    'status': '',
+    'created_on': '',
+    'updated_on': '',
+    'commit_ids': '',
+    'review_status': '',
+    'mergeable': '',
+    'source': '',
+    'target': '',
+    'author': '',
+    'reviewers': '',
+})
+def _review_pull_request_hook(*args, **kwargs):
+    """
+    This hook will be executed after review action was made on a pull request.
+    """
+    return HookResponse(0, '')
+
+
+@has_kwargs({
+    'server_url': 'url of instance that triggered this hook',
+    'config': 'path to .ini config used',
+    'scm': 'type of version control "git", "hg", "svn"',
+    'username': 'username of actor who triggered this event',
+    'ip': 'ip address of actor who triggered this hook',
+    'action': '',
+    'repository': 'repository name',
+    'pull_request_id': '',
+    'url': '',
+    'title': '',
+    'description': '',
+    'status': '',
+    'created_on': '',
+    'updated_on': '',
+    'commit_ids': '',
+    'review_status': '',
+    'mergeable': '',
+    'source': '',
+    'target': '',
+    'author': '',
+    'reviewers': '',
+})
+def _update_pull_request_hook(*args, **kwargs):
+    """
+    This hook will be executed after pull requests has been updated with new commits.
+    """
+    return HookResponse(0, '')
+